Company and action scope
A permitted screen does not grant every API action.
- Named company and resource scope
- Separate read, configure, book, board and cancel rights
- Current permission checks
Bus Inventory API
Connect your product to company-scoped bus routes, departures, real seats, fares, holds, tickets and boarding. Use the same reservation record as the operator counter.
For: Bus operators, booking products, travel-platform teams and approved integration partners.
Shared context · Clear responsibility · Review where it matters
How it works
Agree the inventory authority, commercial workflow and support responsibility before connecting a new selling channel.
Name the operator, company, routes, allowed actions, credentials and support responsibility.
Read the dated trip, schedule, physical seat map and its current version.
Submit the actual seat identities and passenger context with the original request reference and expiry.
Confirm the original accepted hold. If the reply is uncertain, read its result before creating any new action.
Look up the booking, use the confirmed passenger list and record per-seat boarding through permitted operations.
Review eligible seats, retain the cancellation reference and follow the configured financial refund state separately.
Product scope
Company-scoped bus route and dated-departure reads and configuration.
Versioned physical seat maps and frozen per-seat booking fares.
Temporary selected-seat holds and booking confirmation.
Original command, hold and booking recovery.
Confirmed passenger manifests and per-seat boarding.
Eligible partial cancellation and explicit refund-review state.
Fleet records and reviewed, seat-compatible departure assignment.
Actor-linked command receipts and reference-only dispatch history.
Operating areas
A permitted screen does not grant every API action.
Use the departure's actual reviewed layout.
Preserve a recoverable original when transport fails.
Keep the reservation and money states distinct.
Implementation paths
Embed approved operator inventory with a named support and fulfilment responsibility.
Agree mapping and which system owns each route, trip, fare, seat and booking before switching a defined scope.
Connect approved channels per implementation. Partner access and financial arrangements remain part of the agreed integration.
Connect the right people, records and systems around your workflow, with clear ownership and the controls your team needs.
A search result is not a reservation. Confirmation depends on the original accepted hold and current reservation state.
Use credentials and actions issued for the agreed operator scope, never another operator's identity or an upstream provider secret.
Booking, cancellation and financial changes remain policy-controlled and auditable. An assistant must not invent trip, seat or refund facts.
Connected products
Questions
Read and configure approved routes, departures and seat maps; create temporary holds; confirm bookings; find original tickets; and use scoped boarding and cancellation operations. Access is limited to the agreed company, inventory and actions.
Yes. A departure has reviewed physical seats and a seat-map version. A booking records the selected seats and fare snapshot. The current reservation model allocates seats for the whole route; stop-to-stop seat sharing needs a separately agreed operating model.
No. Search is time-sensitive and does not reserve a seat. Create a hold against the current departure and seat-map version, then confirm that original hold before it expires.
Retain the original command and hold references. Read their current result before retrying. A fresh identifier can represent another sale, so it must not replace an uncertain original action.
No. Inventory cancellation and financial refund are separate states. Read the actual financial result from the configured payment and accounting workflow before reporting a completed refund.
No. Each external channel requires its own approved access, inventory mapping, commercial arrangement and support responsibility. API access is not an unrestricted feed of other operators' inventory.
See it working for your business