> ## 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.

# Booking status

> Follow a session's payment and ticketing, and look up a booking.

## Session status

`GET /bookings/session/{id}/payment` is the one call to poll, if you don't use [webhooks](https://docs.flyskye.ai/webhooks.md).

```json theme={"system"}
{ "state": "paid", "booking": { "state": "ticketed", "bookingId": "...", "pnr": "ABC123" } }
```

| Field | Values |
| - | - |
| `state` | `pending`, `paid`, `failed` or `expired` |
| `booking.state` | `none`, `ticketing`, `ticketed` or `failed` |

> [!TIP]
>
> Poll every few seconds while `booking.state` is `ticketing`. Stop at `ticketed` or `failed`.

`GET /bookings/session/{id}` returns the session itself: its `quote`, its `status`, and a `missing` list of anything still
needed before payment.

## Look up a booking

`GET /bookings/{ref}`

`ref` is the Skye booking id or the PNR.

```json theme={"system"}
{
  "bookingId": "...",
  "status": "confirmed",
  "pnr": "ABC123",
  "route": { "origin": "BLR", "destination": "DEL", "departDate": "2026-12-24", "returnDate": null },
  "total": { "amount": 6412, "currency": "INR" },
  "refund": null
}
```

After a cancellation, `refund` is `{ state, amount, currency }`, where `state` is `refunded`, `pending`, `failed`,
`noncash`, `cancelled` or `unknown`.


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