Environments
All paths in this documentation are relative to the base URL of your Journeys environment:
BASE="https://<journeys host>/api/journeys/v1"
TOKEN="<tenant token for that environment>"
The examples use these two variables. Your base URLs and tokens are issued during onboarding, one pair per environment (for example an evaluation or test environment and production). Each environment has its own tokens and its own data; a token is refused by any other environment.
Kaptio Journeys runs in the European Union (Google Cloud, europe-west1). A tenant can also serve the API on its own booking domain (for example book.example.com), same-origin with its hosted booking pages, under the same /api/journeys/v1 path.
Enabling surfaces for a tenant
Each surface is switched on per tenant in its configuration:
| Surface | Tenant configuration key | Answer when not enabled |
|---|---|---|
| Order orchestration | order_orchestration | 404 not_enabled |
| Order operations | oms_ops | 404 oms_ops_not_enabled |
| Group agreements and travel parties | group_bookings (with oms_ops) | 404 group_bookings_not_enabled |
| Group sales | group_sales | 404 group_sales_not_enabled |
| Quote store | quote_store | 404 quote_store_not_enabled |
| Repricing | repricing | 404 repricing_not_enabled |
Request limits
| Limit | Value |
|---|---|
| Request body | 5 MB of JSON |
| Content type | application/json for request and response bodies |
| Time zone | All timestamps are ISO 8601 with an offset; the service writes UTC (Z). |
For call rates, see Rate limits.