Availability
What the order engine API provides today, and what it does not. Integration designs should rely only on capabilities marked available.
Available in production code and documented on this site. Partial available with the limits stated. Not available not provided by the API today.
Platform
| Capability | Status | Notes |
|---|---|---|
| Tenant token authentication, tenant isolation | Available | Authentication |
| Read-only role | Available | supply_readonly |
Per-resource scopes (for example orders:write) | Not available | Two roles only: read-write and read-only. |
| OAuth 2.0 client-credentials token endpoint | Not available | Tokens are issued to the integration at onboarding. |
| Agency-scoped tokens on trips and orders | Not available | Refused with 403 scope_forbidden; the agency is recorded on each record instead. The quote store accepts agency-scoped tokens. |
| Idempotency keys on every write | Available | Idempotency keys |
| Optimistic concurrency | Available | If-Match on purchase order writes; expectedVersion on configuration, groups, agreements and lines. Concurrency |
| One error envelope with request ids | Available | On the order orchestration, order operations, group, group sales and quote store surfaces. Repricing errors carry code, with the message in error, and no requestId. Errors |
| URI versioning and contract snapshot | Available | Versioning |
Deprecation and Sunset headers, public changelog | Not available | |
| OpenAPI document | Available | OpenAPI 3.0, generated from the contract snapshot. |
| One pagination style on every list | Partial | Four bounded patterns; the trip list returns the newest 200 at most. Pagination |
| One field casing | Partial | Quote store and repricing use snake_case; the other surfaces camelCase. |
| Published rate limits | Not available | No per-client quota is enforced today. Rate limits |
Events
| Capability | Status | Notes |
|---|---|---|
| Transactional outbox, polled by sequence | Available | Events overview |
| Inbound status events with deduplication, mapping and replay | Available | |
| Missing-feedback alerts and integration monitoring | Available | Monitoring views when enabled for the tenant. |
| Webhooks (push, signed, per event type, retries, dead-letter) | Not available | Webhooks |
| Cursor on the integration log | Partial | GET /order-orchestration/events is newest-first with a limit; the monitoring message list has a cursor. Use the outbox for change feeds. |
Resources
| Capability | Status | Notes |
|---|---|---|
| Quotes: price, save, retrieve across channels, revalidate, accept | Available | Quotes and quotations |
| Server-side frozen conditions, verified on conversion | Available | Verification is switched on per tenant (verify_frozen_conditions). |
| Quotations: create, alternatives, resume by creator, convert, report | Available | |
| Automatic quotation expiry | Not available | The expired status is reserved; quotes in the quote store expire by validUntil. |
| Trips with one anchor and many purchase orders | Available | Trips |
| Purchase orders from any channel and moment; ownership routing | Available | Purchase orders |
| Order changes from repricing proposals | Available | |
| Passenger manifest on the trip | Not available | Passengers are referenced on order lines. |
| Remove passengers, cancel a cabin, cancel an order, with fees and refunds | Available | Changes and refunds |
| Name change or passenger substitution on an individual trip | Not available | Available between trips of a group agreement. |
| Payments and refunds with line allocation | Available | Payments and allocation |
| Passenger-level balances and payment splits | Available | Derived from line allocation. |
| Allocating a payment directly to a passenger | Not available | Use the purchase order anchor or manual legs on the passenger's lines. |
| Groups with inherited constraints | Available | Groups, agreements and block requests |
| Group agreements: approval, contracting, berth holds, releases, receipts, settlement, ledger, as-of reads | Available | |
| Block requests with pricing, four-eyes decision and acceptance | Available | Cabin counts per category, with optional cabin numbers. |
| Travel parties and party quotes | Available | |
| Channels | Partial | Registered in the orchestration configuration; no channel resource with its own credentials. Channels |
| Orchestration configuration: versioned, validated, audited, rollback | Available | Orchestration configuration |
| Disruption and mass change: plan, commit token, retry, rollback, guest choice, work items | Available | Mass change and operations |
| Service recovery with eligibility and approval | Available | Service recovery |
| Care read models | Available | Care views |