skyscanner.flight.search
View connectorSearch and refine guest flights across one-way, return, and multi-city trips
POST /v1/operations/skyscanner.flight.searchRestricted access · live-read. Examples are illustrative and do not execute requests.
This example uses observed place IDs for London Heathrow (95565050) and Amsterdam Schiphol (95565044). For another route, call skyscanner.place.predict and use its returned place IDs.
Inputs
| Parameter | Example type | Example value |
|---|---|---|
| trip_type | string | "one_way" |
| legs | array | [{"origin_place_ref":"95565050","destination_place_ref":"95565044","departure_date":"2026-11-03"}] |
| travellers | object | {"adults":1} |
| cabin_class | string | "economy" |
| currency | string | "USD" |
| sort | string | "best" |
Example input
{
"trip_type": "one_way",
"legs": [
{
"origin_place_ref": "95565050",
"destination_place_ref": "95565044",
"departure_date": "2026-11-03"
}
],
"travellers": {
"adults": 1
},
"cabin_class": "economy",
"currency": "USD",
"sort": "best"
}Input schema
{
"$defs": {
"airline_refs": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array",
"uniqueItems": true
},
"layover_place_refs": {
"items": {
"pattern": "^[0-9]+$",
"type": "string"
},
"type": "array",
"uniqueItems": true
},
"leg": {
"additionalProperties": false,
"properties": {
"departure_date": {
"format": "date",
"type": "string"
},
"destination_place_ref": {
"minLength": 1,
"type": "string"
},
"origin_place_ref": {
"minLength": 1,
"type": "string"
}
},
"required": [
"origin_place_ref",
"destination_place_ref",
"departure_date"
],
"type": "object"
},
"time_window": {
"additionalProperties": false,
"properties": {
"from": {
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"type": "string"
},
"to": {
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
}
},
"$id": "https://priv-platform.local/connectors/skyscanner/flight-search.input.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"allOf": [
{
"if": {
"properties": {
"trip_type": {
"const": "one_way"
}
}
},
"then": {
"properties": {
"legs": {
"maxItems": 1
}
}
}
},
{
"if": {
"properties": {
"trip_type": {
"const": "return"
}
}
},
"then": {
"properties": {
"legs": {
"maxItems": 2,
"minItems": 2
}
}
}
},
{
"if": {
"properties": {
"trip_type": {
"const": "multi_city"
}
}
},
"then": {
"properties": {
"legs": {
"minItems": 2
}
}
}
}
],
"properties": {
"cabin_class": {
"enum": [
"economy",
"premium_economy",
"business",
"first"
]
},
"currency": {
"description": "Preferred price currency; defaults to GBP.",
"enum": [
"GBP",
"EUR",
"USD"
]
},
"direct_only": {
"type": "boolean"
},
"filters": {
"additionalProperties": false,
"properties": {
"allowed_airline_refs": {
"$ref": "#/$defs/airline_refs"
},
"allowed_layover_place_refs": {
"$ref": "#/$defs/layover_place_refs"
},
"disallowed_airline_refs": {
"$ref": "#/$defs/airline_refs"
},
"disallowed_layover_place_refs": {
"$ref": "#/$defs/layover_place_refs"
},
"max_layover_minutes": {
"minimum": 0,
"type": "integer"
},
"max_leg_duration_minutes": {
"minimum": 0,
"type": "integer"
},
"max_stops_per_leg": {
"minimum": 0,
"type": "integer"
},
"min_layover_minutes": {
"minimum": 0,
"type": "integer"
},
"minimum_cabin_bags": {
"minimum": 0,
"type": "integer"
},
"minimum_checked_bags": {
"minimum": 0,
"type": "integer"
},
"time_windows": {
"items": {
"additionalProperties": false,
"anyOf": [
{
"required": [
"departure_local"
]
},
{
"required": [
"arrival_local"
]
}
],
"properties": {
"arrival_local": {
"$ref": "#/$defs/time_window"
},
"departure_local": {
"$ref": "#/$defs/time_window"
},
"leg_index": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"leg_index"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"legs": {
"items": {
"$ref": "#/$defs/leg"
},
"minItems": 1,
"type": "array"
},
"sort": {
"enum": [
"best",
"cheapest",
"fastest",
"direct"
]
},
"travellers": {
"additionalProperties": false,
"properties": {
"adults": {
"maximum": 8,
"minimum": 1,
"type": "integer"
},
"child_ages": {
"items": {
"maximum": 17,
"minimum": 0,
"type": "integer"
},
"maxItems": 8,
"type": "array"
}
},
"required": [
"adults"
],
"type": "object"
},
"trip_type": {
"enum": [
"one_way",
"return",
"multi_city"
]
}
},
"required": [
"trip_type",
"legs",
"travellers",
"cabin_class"
],
"title": "Skyscanner guest flight search input",
"type": "object"
}