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

# Skyscanner Flights

> Compare flight prices across airlines using IATA codes and dates. Powered by Skyscanner.

`$2.3 / 1k flights`

Compare flight prices across airlines using IATA codes and dates. Powered by Skyscanner.

## Endpoint

`POST /api/v1/agents/skyscanner/flights/run`

## Parameters

<ParamField body="origin" type="string" required>
  **Text** · Origin airport IATA code (LAX, JFK, LHR, BOM, etc.)
</ParamField>

<ParamField body="destination" type="string" required>
  **Text** · Destination airport IATA code.
</ParamField>

<ParamField body="departDate" type="date" required>
  **Date picker** · Departure date (YYYY-MM-DD).
</ParamField>

<ParamField body="returnDate" type="date">
  **Date picker** · Optional return date for round-trip. Leave blank for one-way.
</ParamField>

<ParamField body="adults" type="integer" default={1}>
  **Number** · Number of adult passengers.
</ParamField>

<ParamField body="cabinClass" type="string" default="ECONOMY">
  **Dropdown** · Cabin class.

  **Options:** `ECONOMY`, `PREMIUM_ECONOMY`, `BUSINESS`, `FIRST`

  *Legend: `ECONOMY` = Economy, `PREMIUM_ECONOMY` = Premium Economy, `BUSINESS` = Business, `FIRST` = First*
</ParamField>

<ParamField body="currency" type="string" default="USD">
  **Dropdown** · Currency code for prices.

  <Accordion title="Show all 15 options">
    `USD`, `EUR`, `GBP`, `INR`, `JPY`, `CAD`, `AUD`, `MXN`, `SGD`, `AED`, `CHF`, `CNY`, `BRL`, `KRW`, `ZAR`

    *Legend: `USD` = USD — US Dollar, `EUR` = EUR — Euro, `GBP` = GBP — British Pound, `INR` = INR — Indian Rupee, `JPY` = JPY — Japanese Yen, `CAD` = CAD — Canadian Dollar, `AUD` = AUD — Australian Dollar, `MXN` = MXN — Mexican Peso, `SGD` = SGD — Singapore Dollar, `AED` = AED — UAE Dirham, `CHF` = CHF — Swiss Franc, `CNY` = CNY — Chinese Yuan, `BRL` = BRL — Brazilian Real, `KRW` = KRW — South Korean Won, `ZAR` = ZAR — South African Rand*

    [View all 15 as a structured list →](/agents/skyscanner/flights/values#currency)
  </Accordion>
</ParamField>

<ParamField body="maxFlights" type="integer" default={20}>
  **Number** · Maximum flight options to return. Use 0 for all.
</ParamField>

## Response columns

| Field                | Display name        | Type     |
| -------------------- | ------------------- | -------- |
| `airline`            | Airline             | text     |
| `flightCode`         | Flight Code         | text     |
| `from`               | From                | text     |
| `fromCity`           | From City           | text     |
| `to`                 | To                  | text     |
| `toCity`             | To City             | text     |
| `departure`          | Departure           | date     |
| `arrival`            | Arrival             | date     |
| `duration`           | Duration            | text     |
| `stops`              | Stops               | number   |
| `bestPrice`          | Best Price          | currency |
| `currency`           | Currency            | text     |
| `cabin`              | Cabin               | text     |
| `bookLink`           | Book Link           | url      |
| `operatedBy`         | Operated By         | text     |
| `airlineCode`        | Airline Code        | text     |
| `durationMin`        | Duration (min)      | number   |
| `fromAirportName`    | From Airport Name   | text     |
| `fromCountry`        | From Country        | text     |
| `toAirportName`      | To Airport Name     | text     |
| `toCountry`          | To Country          | text     |
| `handBags`           | Hand Bags           | number   |
| `checkedBags`        | Checked Bags        | number   |
| `personalItem`       | Personal Item       | number   |
| `isBest`             | Is Best             | boolean  |
| `isFastest`          | Is Fastest          | boolean  |
| `isCheapest`         | Is Cheapest         | boolean  |
| `selfTransfer`       | Self Transfer       | boolean  |
| `hiddenCity`         | Hidden City         | boolean  |
| `virtualInterlining` | Virtual Interlining | boolean  |
| `departDate`         | Depart Date         | date     |
| `returnDate`         | Return Date         | date     |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/skyscanner/flights/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "origin": "DEL",
      "destination": "BOM",
      "departDate": "2026-05-08",
      "cabinClass": "ECONOMY",
      "currency": "USD",
      "maxFlights": 20
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/skyscanner/flights/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "origin": "DEL",
      "destination": "BOM",
      "departDate": "2026-05-08",
      "cabinClass": "ECONOMY",
      "currency": "USD",
      "maxFlights": 20
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "airline": "Spicejet",
      "flightCode": null,
      "from": "DEL",
      "fromCity": "New Delhi",
      "to": "BOM",
      "toCity": "Mumbai",
      "departure": "2026-05-24T16:30:00",
      "arrival": "2026-05-24T18:40:00",
      "duration": "2h 10m",
      "stops": 0,
      "bestPrice": 63,
      "currency": "USD",
      "cabin": [
        "ECONOMY"
      ],
      "bookLink": "https://search.aviasales.com/DEL0524BOM1?marker=719034",
      "operatedBy": null,
      "airlineCode": null,
      "durationMin": 130,
      "fromAirportName": "Indira Gandhi International",
      "fromCountry": "India",
      "toAirportName": "Chhatrapati Shivaji International",
      "toCountry": "India",
      "handBags": 1,
      "checkedBags": 1,
      "personalItem": 0,
      "isBest": false,
      "isFastest": false,
      "isCheapest": false,
      "selfTransfer": false,
      "hiddenCity": false,
      "virtualInterlining": false,
      "departDate": "2026-05-24",
      "returnDate": null
    }
  ]
}
```