> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flyskye.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> One error shape, and what to do about each code.

Every error has the same shape. `field` appears when a specific input is at fault.

```json theme={"system"}
{ "error": { "code": "invalid_request", "message": "departDate cannot be in the past", "field": "departDate" } }
```

Branch on `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. |

> [!TIP]
>
> Retry `502` and `503` errors with backoff. Never retry a `4xx` unchanged.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.