Flight search
import requests
url = "https://api.parallel.ai/v1/flights/search"
payload = {
"origins": ["<string>"],
"destinations": ["<string>"],
"departure_date": "2023-12-25"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
origins: ['<string>'],
destinations: ['<string>'],
departure_date: '2023-12-25'
})
};
fetch('https://api.parallel.ai/v1/flights/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request POST \
--url https://api.parallel.ai/v1/flights/search \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"origins": [
"<string>"
],
"destinations": [
"<string>"
],
"departure_date": "2023-12-25"
}
'{
"search_id": "<string>",
"session_id": "<string>",
"results": [
{
"url": "<string>",
"outbound": {
"departure_airport": "<string>",
"departure_time": "<string>",
"arrival_airport": "<string>",
"arrival_time": "<string>",
"stops": 123,
"segments": [
{
"airline": "<string>",
"flight_number": "<string>",
"departure_airport": "<string>",
"departure_time": "<string>",
"arrival_airport": "<string>",
"arrival_time": "<string>",
"duration_minutes": 123,
"aircraft": "<string>",
"cabin": "<string>",
"legroom": "<string>",
"overnight": false
}
],
"duration_minutes": 123,
"layovers": [
{
"airport": "<string>",
"duration_minutes": 123,
"overnight": false
}
]
},
"price": 123,
"inbound": {
"departure_airport": "<string>",
"departure_time": "<string>",
"arrival_airport": "<string>",
"arrival_time": "<string>",
"stops": 123,
"segments": [
{
"airline": "<string>",
"flight_number": "<string>",
"departure_airport": "<string>",
"departure_time": "<string>",
"arrival_airport": "<string>",
"arrival_time": "<string>",
"duration_minutes": 123,
"aircraft": "<string>",
"cabin": "<string>",
"legroom": "<string>",
"overnight": false
}
],
"duration_minutes": 123,
"layovers": [
{
"airport": "<string>",
"duration_minutes": 123,
"overnight": false
}
]
}
}
],
"warnings": [
{
"type": "spec_validation_warning",
"message": "<string>",
"detail": {}
}
],
"usage": [
{
"name": "sku_search",
"count": 1
}
]
}{
"type": "error",
"error": {
"ref_id": "search_fcb2b4f3c75e418687bccaa1a8381331",
"message": "Flight search is not supported for this organization."
}
}{
"type": "error",
"error": {
"ref_id": "search_fcb2b4f3c75e418687bccaa1a8381331",
"message": "Request validation error"
}
}Search
Flight search
Searches flights and links each itinerary to where it can be booked.
POST
/
v1
/
flights
/
search
Flight search
import requests
url = "https://api.parallel.ai/v1/flights/search"
payload = {
"origins": ["<string>"],
"destinations": ["<string>"],
"departure_date": "2023-12-25"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
origins: ['<string>'],
destinations: ['<string>'],
departure_date: '2023-12-25'
})
};
fetch('https://api.parallel.ai/v1/flights/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request POST \
--url https://api.parallel.ai/v1/flights/search \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"origins": [
"<string>"
],
"destinations": [
"<string>"
],
"departure_date": "2023-12-25"
}
'{
"search_id": "<string>",
"session_id": "<string>",
"results": [
{
"url": "<string>",
"outbound": {
"departure_airport": "<string>",
"departure_time": "<string>",
"arrival_airport": "<string>",
"arrival_time": "<string>",
"stops": 123,
"segments": [
{
"airline": "<string>",
"flight_number": "<string>",
"departure_airport": "<string>",
"departure_time": "<string>",
"arrival_airport": "<string>",
"arrival_time": "<string>",
"duration_minutes": 123,
"aircraft": "<string>",
"cabin": "<string>",
"legroom": "<string>",
"overnight": false
}
],
"duration_minutes": 123,
"layovers": [
{
"airport": "<string>",
"duration_minutes": 123,
"overnight": false
}
]
},
"price": 123,
"inbound": {
"departure_airport": "<string>",
"departure_time": "<string>",
"arrival_airport": "<string>",
"arrival_time": "<string>",
"stops": 123,
"segments": [
{
"airline": "<string>",
"flight_number": "<string>",
"departure_airport": "<string>",
"departure_time": "<string>",
"arrival_airport": "<string>",
"arrival_time": "<string>",
"duration_minutes": 123,
"aircraft": "<string>",
"cabin": "<string>",
"legroom": "<string>",
"overnight": false
}
],
"duration_minutes": 123,
"layovers": [
{
"airport": "<string>",
"duration_minutes": 123,
"overnight": false
}
]
}
}
],
"warnings": [
{
"type": "spec_validation_warning",
"message": "<string>",
"detail": {}
}
],
"usage": [
{
"name": "sku_search",
"count": 1
}
]
}{
"type": "error",
"error": {
"ref_id": "search_fcb2b4f3c75e418687bccaa1a8381331",
"message": "Flight search is not supported for this organization."
}
}{
"type": "error",
"error": {
"ref_id": "search_fcb2b4f3c75e418687bccaa1a8381331",
"message": "Request validation error"
}
}Body
application/json
Flight search request: a one-way or round-trip itinerary search.
best (default) balances price, duration and stops. For a round trip it also picks the return on the outbound's airline: price the cheapest, duration the shortest, the others the fewest stops within 10% of the cheapest. For the cheapest trip on any airlines, as separate tickets, search each direction one way.
Available options:
best, price, duration, departure_time, arrival_time Response
Successful Response
Flight search response.