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

# Cancel and change

> Refund quotes, cancellations and date changes on the same ticket.

## Cancel

`POST /bookings/{ref}/cancel`

**1. Get a refund quote**

Send `{}`. Nothing is cancelled.

```json theme={"system"}
{ "quote": { "refund": 4200, "nonRefundable": 2212, "currency": "INR", "refundUnknown": false } }
```

**2. Cancel**

Send `{ "confirm": true }`. Skye cancels with the airline and refunds the traveller to the original payment method.

```json theme={"system"}
{ "status": "refunded", "refund": 4200, "refunded": true }
```

Only confirmed bookings can be cancelled. Cancelling twice is safe: the second call returns `alreadyDone: true`.

## Change dates

`POST /bookings/{ref}/change` changes dates on the same ticket, in three steps chosen by the body.

**1. Find options**

`{ "departDate": "2026-12-26", "returnDate": "2027-01-02" }` returns up to 5 options, each with its fare difference.
Nothing is committed.

```json theme={"system"}
{ "changeable": true, "offers": [{ "offerId": "...", "charge": 1150, "currency": "INR", "slices": [...] }] }
```

**2. Price one**

`{ "offerId": "..." }` returns `orderChangeId`, plus a Razorpay order when there is a difference to pay.

```json theme={"system"}
{ "orderChangeId": "...", "charge": 1150, "currency": "INR", "razorpay": { "orderId": "order_...", "amount": 115000, "keyId": "rzp_live_..." } }
```

**3. Apply it**

`{ "orderChangeId": "...", "razorpay": { "orderId", "paymentId", "signature" } }` applies the change. Leave out
`razorpay` when the change is free.

```json theme={"system"}
{ "status": "changed", "bookingId": "...", "pnr": "XYZ789", "departDate": "2026-12-26", "charge": 1150, "currency": "INR" }
```

> [!NOTE]
>
> You pay only the airline's difference, with no Skye fee. A booking can be changed once.


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