Developers

Errors

What is it

The error catalogue is the contract for failure: every error returns a stable machine-readable code, a human explanation and a request id. Codes never change meaning.

Errors

Authentication and permission failures use standard 401 and 403 responses, and rate limiting returns 429. The codes below are business errors.

Code	HTTP	Description
VALIDATION_FAILED	422	The request is malformed: a missing field, an unknown value or a bad combination of parameters.
QUOTE_INVALID	422	The quote token is malformed, was issued for different parameters or cannot be redeemed.
QUOTE_EXPIRED	422	The quote's validity window has passed. Request a fresh quote and book again.
SESSION_SOLD_OUT	422	Capacity for the selected session ran out between quote and booking.
INSUFFICIENT_BALANCE	422	Your wallet cannot cover the booking. Top up and retry the same request.
IDEMPOTENCY_CONFLICT	409	The same Idempotency-Key was reused with a different request body.
RESOURCE_NOT_FOUND	404	The referenced resource does not exist or is not visible to your agency.

Error envelope

{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Wallet cannot cover this booking.",
    "details": null,
    "request_id": "req_01JG80…",
    "documentation_url": "https://api.traveldistro.com/docs"
  }
}

Related pages

Ready to integrate?

Tell us about your volume and verticals. We will get you sandbox keys.

Contact us