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

# Book with Skye checkout

> The simplest path: Skye hosts the page that collects travellers and payment.

You never handle passports or cards: the traveller enters them on Skye checkout, pays, and gets the e-ticket by email.

**1. Open a session**

Send the `offerId` the user picked from [search](https://docs.flyskye.ai/search.md).

```bash theme={"system"}
curl -X POST https://api.flyskye.ai/v1/bookings/session \
  -H "Authorization: Bearer sat_your_access_token" \
  -H "Content-Type: application/json" \
  -d '{"offerId":"off_...","prefill":{"contactEmail":"asha@example.com"}}'
```

**2. Show the price**

`quote.displayAmount` in `quote.displayCurrency` is exactly what the traveller pays. Show it before you hand off.

**3. Hand off**

Open `checkoutUrl` in a browser or an in app web view. The traveller pays by UPI, card or netbanking.

**4. Follow the result**

Listen for the [`booking.ticketed` webhook](https://docs.flyskye.ai/webhooks), or poll [the session status](https://docs.flyskye.ai/booking-status.md).

## Request

**offerId** `string` *required*

The `offerId` from `/search`.

**currency** `string` (default: INR)

Currency to charge in.

**prefill** `object`

`contactEmail` and `contactName` to prefill on the page.

**successUrl** `string`

Where to send the user after booking.

> [!WARNING]
>
> Never send passport numbers in `prefill`. Travellers enter documents on Skye checkout.

## Response

```json theme={"system"}
{
  "sessionId": "5b0c...",
  "checkoutUrl": "https://www.flyskye.ai/checkout/5b0c...?t=skt_...",
  "clientToken": "skt_...",
  "expiresAt": "2026-11-19T17:30:00.000Z",
  "quote": {
    "displayAmount": 6412,
    "displayCurrency": "INR",
    "route": "BLR-DEL",
    "departDate": "2026-12-24",
    "returnDate": null,
    "passengerCount": 1,
    "passengerTypes": { "adults": 1, "children": 0, "infants": 0 },
    "expiresAt": "..."
  }
}
```

> [!NOTE]
>
> A session lasts 30 minutes. If it expires, search again and open a new one.


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