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

# Search flights on SkyScanner

`POST /skyscanner/search-flights`

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

---

[API](https://skmtc.net/carvedai/apis/exfunc-apis.md) · [All operations](https://skmtc.net/carvedai/apis/exfunc-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carvedai/exfunc-apis/revisions/22587fdf9a5e/schema)