TouricalDevelopers
Endpoints

Endpoint reference

Every resource in the Tourical v1 API, with each HTTP method documented individually.

Every endpoint lives under https://app.tourical.com/api/v1/. Each request needs a Bearer token (see Authentication).

Conventions

  • Money is integer cents. totalRetailCents: 245000 is €2,450.00 when currency: "EUR".
  • Currency is ISO 4217 three-letter code, uppercase.
  • Dates are ISO 8601 UTC strings, always.
  • IDs are opaque strings — never assume their format.
  • Field names use camelCase.

Pagination

List endpoints return a cursor envelope:

{
  "data": [ /* objects */ ],
  "meta": { "cursor": "<next cursor>" | null, "hasMore": true | false }
}

Pass ?cursor=<value> to page forward. ?limit=<n> caps at 100, default 50. There is no offset/skip — cursors avoid the "moved row" problem.

Try any endpoint

Every method on every resource has an embedded explorer. Paste a token once — held in this tab's sessionStorage by default — and send real calls against the live API. See API Explorer for the standalone view and the storage trade-off.

Resources

ResourceMethods
Token introspectionGET
TripsGET POST PATCH
BookingsGET POST (501)
ClientsGET POST
PaymentsGET
LibrariesGET × 4 catalogs
WebhooksGET POST DELETE — subscriptions, key rotation, deliveries, redelivery, test

On this page