Account
Account API overview
Agency balances, financial ledger, and cross-product booking history.
Read-only endpoints for querying account state: balances, financial transaction history, and booking summaries.
Permission: Read (all endpoints in this section)
These endpoints expose account-level data for reconciliation, dashboards, and integration monitoring.
They are not the booking operations API. For full traveler details, fare rules, and booking
actions, use the product-specific endpoints (e.g. /api/v1/flights/get_booking).
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/v1/balances | Current balance for each currency the agency holds |
GET | /api/v1/balances/{balance_id}/history | Full financial ledger for a specific currency |
GET | /api/v1/history | Booking summaries across all products |
GET | /api/v1/bookings/{id} | Single booking detail by public reference |
Sandbox behaviour
In sandbox:
GET /api/v1/balancesreturns an emptydataarrayGET /api/v1/balances/{id}/historyreturns an emptydataarrayGET /api/v1/historyreturns sandbox bookings onlyGET /api/v1/bookings/{id}returns sandbox bookings only
Sandbox bookings do not affect the live ledger.
Error responses
| HTTP | detail.error | Cause |
|---|---|---|
400 | invalid_date | from or to is not a valid ISO-8601 value |
400 | invalid_product | product is not one of the allowed values |
401 | — | Missing or invalid API key |
403 | — | Key lacks permission |
404 | booking_not_found | No booking matches in this environment |
500 | — | Internal server error |