---
title: "Search flights on SkyScanner"
method: POST
path: "/skyscanner/search-flights"
tags: ["SkyScanner"]
---

# Search flights on SkyScanner

`POST /skyscanner/search-flights`

## Request

- Base URL: `https://api.exfunc.dev`
- URL: `https://api.exfunc.dev/skyscanner/search-flights`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/carvedai/apis/exfunc-apis/docs/skyscanner/search-flights/post.ts> (a function with typed inputs; its response is checked against the schema)

Search flights on SkyScanner for given origin, destination, departure date and return date

## Request body

- object
  - `origin` string, required: The origin location of the itinerary
  - `destination` string, required: The destination location of the itinerary
  - `flight_type` 'one-way' | 'roundtrip', required: The type of the flight
  - `depart_date` string, required: The departure date of the itinerary. The format has to be YYYY-MM-DD
  - `return_date` string: The return date of the itinerary. The format has to be YYYY-MM-DD. If the flight type is roundtrip, this field is required.
  - `stops` string[]: The list of filter values for number of stops
  - `num_adults` number: The number of adults for the itinerary
  - `num_children` number: The number of children for the itinerary
  - `num_infants` number: The number of infants for the itinerary
  - `cabin_class` 'economy' | 'premium_economy' | 'business' | 'first': The cabin class filter
  - `include_origin_nearby_airports` boolean: Boolean to indicate whether to include nearby origin airports in the results or not
  - `include_destination_nearby_airports` boolean: Boolean to indicate whether to include nearby destination airports in the results or not

## Response `200`

SearchFlights API successful response

- object
  - `itineraries` SkyScannerItinerary[]
    - `price` string: The price for the itinerary
    - `legs` SkyScannerLeg[]
      - `origin` SkyScannerAirport: The airport information
        - `name` string: The name of the airport
        - `display_code` string: The airport code
      - `destination` SkyScannerAirport: The airport information
        - `name` string: The name of the airport
        - `display_code` string: The airport code
      - `duration_in_minutes` number: Duration of the leg in minutes
      - `stop_count` number: The number of stops for the leg
      - `departure_time` string: The departure time of the leg
      - `arrival_time` string: The arrival time of the leg
      - `time_delta_in_days` number: The time delta in days between the departure and the arrival
      - `carriers` object: The carrier information
        - `marketing` string[]: The list of marketing carriers (airlines)
        - `operating` string[]: The list of operating carriers (airlines)
      - `segments` SkyScannerSegment[]: The list of segments for the leg
        - `origin` SkyScannerAirport: The airport information
          - `name` string: The name of the airport
          - `display_code` string: The airport code
        - `destination` SkyScannerAirport: The airport information
          - `name` string: The name of the airport
          - `display_code` string: The airport code
        - `departure_time` string: The departure time of the segment
        - `arrival_time` string: The arrival time of the segment
        - `duration_in_minutes` number: Duration of the segment in minutes
        - `flight_number` string: Flight number for the segment
        - `marketing_carrier` SkyScannerCarrier: The carrier details
          - `id` string: The ID of the carrier. This is usually an airline code.
          - `name` string: The name of the carrier
        - `operating_carrier` SkyScannerCarrier: The carrier details
          - `id` string: The ID of the carrier. This is usually an airline code.
          - `name` string: The name of the carrier

## Other responses

- `400`: User error response
- `500`: Server error response

## Changes

- **2024-11-16** `0fcb280287c5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/carvedai/apis/exfunc-apis/changes/skyscanner/search-flights/post.md)

---

[API](https://skmtc.dev/carvedai/apis/exfunc-apis.md) - [All operations](https://skmtc.dev/carvedai/apis/exfunc-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/carvedai/apis/exfunc-apis/revisions/22587fdf9a5e?raw)