field appears when a specific input is at fault.
{ "error": { "code": "invalid_request", "message": "departDate cannot be in the past", "field": "departDate" } }
code, not on message: messages are for people and may change.
Auth and requests
| Code | Status | What to do |
|---|---|---|
unauthorized | 401 | Missing, invalid or expired API key or access token. Get a new token from /token. |
forbidden | 403 | Your key lacks the scope (search or book), or the session belongs to another partner. |
invalid_json | 400 | The body is not valid JSON. |
invalid_request | 400 | A field failed validation. error.field names it when known. |
not_found | 404 | No such session or booking for your account. |
Sessions and travellers
| Code | Status | What to do |
|---|---|---|
session_expired | 410 | Sessions last 30 minutes. Search again and open a new one. |
session_failed | 502 | The offer could not be priced, usually because it expired. Search again. |
details_required | 409 | Send traveller details before payment or confirm. |
details_incomplete | 409 | Something the fare needs is still missing; the message lists it. |
traveller_count | 400 | Send exactly one traveller per seat (adults, children and infants). |
passport_required | 409 | International trips need passportNumber, passportExpiry and passportCountry for every traveller. |
passport_expired | 409 | A passport expires on or before the travel date. |
account_exists | 409 | The contact email already has its own Skye account. Use another email. |
Payment and booking
| Code | Status | What to do |
|---|---|---|
not_payable | 409 | The session is not awaiting payment (already paid, failed or expired). |
already_booked | 409 | This session has already been booked. |
upi_currency_unsupported | 409 | UPI QR and UPI intent are INR only. Use the order flow for other currencies. |
upi_not_enabled | 501 | Live UPI intent is not enabled yet. Use the order, QR or link flow. |
search_failed | 502 | Flight search is temporarily unavailable. Retry. |
booking_failed | 4xx or 5xx | Ticketing failed after payment. If money was taken it is refunded automatically. |
Cancel and change
| Code | Status | What to do |
|---|---|---|
not_cancellable | 409 | Only confirmed bookings can be cancelled. |
cancel_rejected | 409 | The airline rejected the cancellation. |
not_changeable | 409 | This fare or booking can’t be changed online. |
change_expired | 409 | The change quote is stale. Price it again. |
Retry
502 and 503 errors with backoff. Never retry a 4xx unchanged.