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

# Search flights

> One way, round trip and multi city, with live fares.

> [card] [POST /search](https://docs.flyskye.ai/api-reference/flights/search-flights.md)
>
> Try it in the API playground.

Scope `search`. Send origin, destination and date for one way, add `returnDate` for a round trip, or send `legs` for multi
city.

> [tab] One way
>
> ```json theme={"system"}
> { "origin": "BLR", "destination": "DEL", "departDate": "2026-12-24", "adults": 1 }
> ```

> [tab] Round trip
>
> ```json theme={"system"}
> { "origin": "BLR", "destination": "DEL", "departDate": "2026-12-24", "returnDate": "2026-12-31", "adults": 2 }
> ```

> [tab] Multi city
>
> ```json theme={"system"}
> {
>   "legs": [
>     { "origin": "DEL", "destination": "BKK", "departDate": "2027-01-10" },
>     { "origin": "BKK", "destination": "HKT", "departDate": "2027-01-14" },
>     { "origin": "HKT", "destination": "DEL", "departDate": "2027-01-20" }
>   ],
>   "adults": 2,
>   "children": 1,
>   "childAges": [7]
> }
> ```

## Request

**origin** `string`

3 letter IATA airport code, for example `BLR`. Not needed with `legs`.

**destination** `string`

3 letter IATA code, different from `origin`.

**departDate** `string`

`YYYY-MM-DD`, today or later.

**returnDate** `string`

`YYYY-MM-DD` after `departDate`. Makes it a round trip.

**legs** `object[]`

2 to 8 legs of `{ origin, destination, departDate }`, in date order. Overrides the fields above.

**adults** `integer` (default: 1)

1 to 9.

**children** `integer` (default: 0)

0 to 8.

**childAges** `integer[]`

Optional age of each child, 0 to 17.

**infants** `integer` (default: 0)

Lap infants, 0 to 8, never more than adults.

**cabinClass** `string` (default: economy)

`economy`, `premium_economy`, `business` or `first`.

**fareType** `string` (default: regular)

`regular`, `student` or `senior`. Student and senior citizen fares are cheaper on many airlines; the traveller may
be asked for ID at the airport.

**maxConnections** `integer` (default: 1)

`0` for nonstop only, up to `2`.

**limit** `integer` (default: 20)

1 to 50 offers, cheapest first.

**mock** `boolean` (default: false)

Return dummy offers on any key. See [Test mode](https://docs.flyskye.ai/test-mode.md).

## Response

**offers** `object[]`

Offers, cheapest first.

**offer**

**offerId** `string`

Pass this to `POST /bookings/session`.

**price** `object`

`{ amount, currency }`. The airline fare including taxes.

**outbound** `object`

Airline, `airlineCode`, `airlineLogo`, `departTime`, `arriveTime`, `duration`, `stops` and `layovers`.

**return** `object | null`

Same shape as `outbound`. Set on round trips.

**legs** `object[] | null`

Every leg, on multi city trips.

**refundable** `boolean | null`

Whether the fare is refundable.

**changeable** `boolean | null`

Whether the fare allows date changes, when known.

**fareBrand** `string | null`

The airline's fare name, for example `Saver`.

**baggage** `object | null`

The allowance per traveller as the airline states it: `{ checkIn, cabin }`, for example `"15 Kg"` and `"7 Kg"`.
`null` when the airline doesn't say.

**expiresAt** `string`

Search again after this time.

**count** `integer`

Number of offers returned.

**query** `object`

The search as Skye understood it, including `tripType`.

**mode** `string`

`live` or `test`.

**mock** `boolean`

`true` when the offers are dummy data.

```json Example response theme={"system"}
{
  "mode": "live",
  "mock": false,
  "query": { "origin": "BLR", "destination": "DEL", "departDate": "2026-12-24", "returnDate": null,
             "legs": null, "tripType": "one_way", "adults": 1, "children": 0, "infants": 0, "cabinClass": "economy", "fareType": "regular" },
  "count": 1,
  "offers": [
    {
      "offerId": "off_...",
      "price": { "amount": "6412", "currency": "INR" },
      "outbound": {
        "airline": "IndiGo", "airlineCode": "6E", "airlineLogo": "<logo url>",
        "departTime": "2026-12-24T22:25", "arriveTime": "2026-12-25T01:20",
        "duration": "2h 55m", "stops": 0, "layovers": []
      },
      "return": null,
      "legs": null,
      "refundable": true,
      "changeable": null,
      "fareBrand": "Saver",
      "baggage": { "checkIn": "15 Kg", "cabin": "7 Kg" },
      "expiresAt": "2026-11-19T17:10:00.000Z"
    }
  ]
}
```

## Good to know

* Times are local to each airport.
* An offer is advisory until booking: it is priced again live when you open a session. Search again once `expiresAt` has
  passed.
* Reuse results while they are fresh instead of searching again for each view. See [rate limits](https://docs.flyskye.ai/pricing.md#rate-limits).


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