✈️Round Trip API
In this API you will get prices from multiple airlines and vendors for a oneway route. You can pass any airport IATA code, future date, currency, and pax.
API endpoint for this API is: https://api.flightapi.io/roundtrip
Each request to this API will cost 2 credits.
Guide
Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.
You can generate an API key from your Dashboard at any time.
Here is the list of default parameters you have to use with this API:
API Schema
You can follow this API schema to pass parameters.
https://api.flightapi.io/roundtrip/<api-key>/<departure_airport_code>/<arrival_airport_code>/<departure_date>/<arrival_date>/<number_of_adults>/<number_of_childrens>/<number_of_infants>/<cabin_class>/<currency>
API Example
You have to send a GET request to https://api.flightapi.io/roundtrip
along with all the parameters.
Take a look at how you might call this API using various different coding languages.
curl "https://api.flightapi.io/roundtrip/5f8b1ec2a9d372151b4109f4dfd8/HAN/SGN/2024-04-10/2024-04-12/1/0/1/Economy/USD"
// require the Unirest or any other module to make an HTTP GET request
const unirest = require('unirest')
unirest.get('https://api.flightapi.io/roundtrip/5f8b1ec2a9d372151b4109f4dfd8/HAN/SGN/2024-04-10/2024-04-12/1/0/1/Economy/USD')
.then(response => {
console.log(response.body);
})
.catch(error => {
console.log(error);
});
# Set your API key before making the request
import requests
resp = requests.get('https://api.flightapi.io/roundtrip/5f8b1ec2a9d372151b4109f4dfd8/HAN/SGN/2024-04-10/2024-04-12/1/0/1/Economy/USD')
print (resp.json())
Response
The sample response of the API will look somewhat like this.
// Sample Response
"itineraries": [
{
"id": "16216-2404021419--32385-1-12387-2404030005|12387-2404091500--32385-1-16216-2404091945",
"leg_ids": [
"16216-2404021419--32385-1-12387-2404030005",
"12387-2404091500--32385-1-16216-2404091945"
],
"pricing_options": [
{
"id": "LGJ4vcG7cf33",
"agent_ids": [
"dela"
],
"price": {
"amount": 1390.4,
"update_status": "current",
"last_updated": "2024-01-09T09:40:39",
"quote_age": 5
},
"unpriced_type": "",
"items": [
{
"agent_id": "dela",
"url": "/transport_deeplink/4.0/US/en-GB/USD/dela/2/16216.12387.2024-04-02,12387.16216.2024-04-09/air/airli/flights?itinerary=flight|-32385|437|16216|2024-04-02T14:19|9596|2024-04-02T21:48|269|KAUOA0MQ|K|ECONOMY;flight|-32385|2178|9596|2024-04-02T22:25|12387|2024-04-03T00:05|100|KAUOA0MQ|K|ECONOMY,flight|-32385|784|12387|2024-04-09T15:00|9596|2024-04-09T16:38|98|LAUOA0ML|L|ECONOMY;flight|-32385|471|9596|2024-04-09T17:20|16216|2024-04-09T19:45|325|LAUOA0ML|L|ECONOMY&carriers=-32385&operators=-32385;-32385,-32385;-32385&passengers=2&channel=website&cabin_class=economy&fps_session_id=a727e06a-6c38-4bcf-8a23-b5bcba1666ac&ticket_price=1390.40&is_npt=false&is_multipart=false&client_id=skyscanner_website&request_id=c087ce1e-3920-4547-8524-1628381be925&q_ids=H4sIAAAAAAAA_-NS4GJJSc1JFGLmuFEnxczxOEGhYeraDWwaDV2XNrAZMSkwAQAVZuTLIgAAAA|4231563191487365489|2&q_sources=JACQUARD&commercial_filters=false&q_datetime_utc=2024-01-09T09:40:39&pqid=false",
"segment_ids": [
"16216-9596-2404021419-2404022148--32385",
"9596-12387-2404022225-2404030005--32385",
"12387-9596-2404091500-2404091638--32385",
"9596-16216-2404091720-2404091945--32385"
],
"price": {
"amount": 1390.4,
"update_status": "current",
"last_updated": "2024-01-09T09:40:39",
"quote_age": 5
},
"booking_proposition": "PBOOK",
"transfer_protection": "",
"max_redirect_age": 10,
"fares": [
{
"segment_id": "16216-9596-2404021419-2404022148--32385",
"fare_basis_code": "KAUOA0MQ",
"booking_code": "K",
"fare_family": "ECONOMY"
},
{
"segment_id": "9596-12387-2404022225-2404030005--32385",
"fare_basis_code": "KAUOA0MQ",
"booking_code": "K",
"fare_family": "ECONOMY"
},
{
"segment_id": "12387-9596-2404091500-2404091638--32385",
"fare_basis_code": "LAUOA0ML",
"booking_code": "L",
"fare_family": "ECONOMY"
},
{
"segment_id": "9596-16216-2404091720-2404091945--32385",
"fare_basis_code": "LAUOA0ML",
"booking_code": "L",
"fare_family": "ECONOMY"
}
],
"opaque_id": "40861565",
"booking_metadata": {
"metadata_set": "",
"signature": ""
},
"ticket_attributes": [],
"flight_attributes": []
}
],
"transfer_type": "MANAGED",
"score": 4.02762,
"pricing_option_fare": {
"attribute_labels": [],
"leg_details": {},
"brand_names": []
}
}
],
"score": 4.02159,
"cheapest_price": {
"amount": 1390.4,
"update_status": "current",
"last_updated": "2024-01-09T09:40:39",
"quote_age": 5
},
"pricing_options_count": 1
},
{
"id": "16216-2404021419--32385-1-12387-2404030005|12387-2404090955--32385-1-16216-2404091721",
"leg_ids": [
"16216-2404021419--32385-1-12387-2404030005",
"12387-2404090955--32385-1-16216-2404091721"
],
"pricing_options": [
{
"id": "ASK54wWqMUef",
"agent_ids": [
"dela"
],
"price": {
"amount": 1250.4,
"update_status": "current",
"last_updated": "2024-01-09T09:40:39",
"quote_age": 5
},
"unpriced_type": "",
"items": [
{
"agent_id": "dela",
"url": "/transport_deeplink/4.0/US/en-GB/USD/dela/2/16216.12387.2024-04-02,12387.16216.2024-04-09/air/airli/flights?itinerary=flight|-32385|437|16216|2024-04-02T14:19|9596|2024-04-02T21:48|269|KAUOA0MQ|K|ECONOMY;flight|-32385|2178|9596|2024-04-02T22:25|12387|2024-04-03T00:05|100|KAUOA0MQ|K|ECONOMY,flight|-32385|2332|12387|2024-04-09T09:55|9596|2024-04-09T11:40|105|UAVNA0ME|U|ECONOMY;flight|-32385|662|9596|2024-04-09T14:55|16216|2024-04-09T17:21|326|UAVNA0ME|U|ECONOMY&carriers=-32385&operators=-32385;-32385,-32385;-32385&passengers=2&channel=website&cabin_class=economy&fps_session_id=a727e06a-6c38-4bcf-8a23-b5bcba1666ac&ticket_price=1250.40&is_npt=false&is_multipart=false&client_id=skyscanner_website&request_id=c087ce1e-3920-4547-8524-1628381be925&q_ids=H4sIAAAAAAAA_-NS4GJJSc1JFGLmuFEnxczxOEGhYeraDWwaDV2XNrAZMSkwAQAVZuTLIgAAAA|-4101514496198410679|2&q_sources=JACQUARD&commercial_filters=false&q_datetime_utc=2024-01-09T09:40:39&pqid=false",
"segment_ids": [
"16216-9596-2404021419-2404022148--32385",
"9596-12387-2404022225-2404030005--32385",
"12387-9596-2404090955-2404091140--32385",
"9596-16216-2404091455-2404091721--32385"
],
"price": {
"amount": 1250.4,
"update_status": "current",
"last_updated": "2024-01-09T09:40:39",
"quote_age": 5
},
"booking_proposition": "PBOOK",
"transfer_protection": "",
"max_redirect_age": 10,
"fares": [
{
"segment_id": "16216-9596-2404021419-2404022148--32385",
"fare_basis_code": "KAUOA0MQ",
"booking_code": "K",
"fare_family": "ECONOMY"
},
{
"segment_id": "9596-12387-2404022225-2404030005--32385",
"fare_basis_code": "KAUOA0MQ",
"booking_code": "K",
"fare_family": "ECONOMY"
},
{
"segment_id": "12387-9596-2404090955-2404091140--32385",
"fare_basis_code": "UAVNA0ME",
"booking_code": "U",
"fare_family": "ECONOMY"
},
{
"segment_id": "9596-16216-2404091455-2404091721--32385",
"fare_basis_code": "UAVNA0ME",
"booking_code": "U",
"fare_family": "ECONOMY"
}
],
"opaque_id": "1678779893",
"booking_metadata": {
"metadata_set": "",
"signature": ""
},
"ticket_attributes": [],
"flight_attributes": []
}
],
"transfer_type": "MANAGED",
"score": 3.77988,
"pricing_option_fare": {
"attribute_labels": [],
"leg_details": {},
"brand_names": []
}
}
],
"score": 3.77421,
"cheapest_price": {
"amount": 1250.4,
"update_status": "current",
"last_updated": "2024-01-09T09:40:39",
"quote_age": 5
},
"pricing_options_count": 1
},
{
"id": "16216-2404021240--32573-1-12387-2404031618|12387-2404091412--32573-1-16216-2404091942",
"leg_ids": [
"16216-2404021240--32573-1-12387-2404031618",
"12387-2404091412--32573-1-16216-2404091942"
],
"pricing_options": [
{
"id": "7hH3LRleVI0e",
"agent_ids": [
"aaus"
],
"price": {
"amount": 1307.4,
"update_status": "current",
"last_updated": "2024-01-09T09:40:39",
"quote_age": 5
},
"unpriced_type": "",
"items": [
{
"agent_id": "aaus",
"url": "/transport_deeplink/4.0/US/en-GB/USD/aaus/2/16216.12387.2024-04-02,12387.16216.2024-04-09/air/airli/flights?itinerary=flight|-32573|304|16216|2024-04-02T12:40|10968|2024-04-02T18:09|209|GVAKZNBX|B|BASIC+ECONOMY;flight|-32573|1863|10968|2024-04-03T12:29|12387|2024-04-03T16:18|169|QVAHZNBX|B|BASIC+ECONOMY,flight|-32573|5543|12387|2024-04-09T14:12|10602|2024-04-09T15:44|92|LVAZZNBZ|B|BASIC+ECONOMY;flight|-32573|2184|10602|2024-04-09T16:58|16216|2024-04-09T19:42|344|LVAZZNBZ|B|BASIC+ECONOMY&carriers=-32573&operators=-32573;-32573,-30992;-32573&passengers=2&channel=website&cabin_class=economy&fps_session_id=a727e06a-6c38-4bcf-8a23-b5bcba1666ac&ticket_price=1307.40&is_npt=false&is_multipart=false&client_id=skyscanner_website&request_id=c087ce1e-3920-4547-8524-1628381be925&q_ids=H4sIAAAAAAAA_-NS4GJJTCwtFmLmuFEnxczxOEGhYeraDWwaDV2XNrAZMSkwAQAeMkDFIgAAAA|-7557581151614243129|2&q_sources=JACQUARD&commercial_filters=false&q_datetime_utc=2024-01-09T09:40:39&pqid=false",
"segment_ids": [
"16216-10968-2404021240-2404021809--32573",
"10968-12387-2404031229-2404031618--32573",
"12387-10602-2404091412-2404091544--32573",
"10602-16216-2404091658-2404091942--32573"
],
"price": {
"amount": 1307.4,
"update_status": "current",
"last_updated": "2024-01-09T09:40:39",
"quote_age": 5
},
"booking_proposition": "PBOOK",
"transfer_protection": "",
"max_redirect_age": 10,
"fares": [
{
"segment_id": "16216-10968-2404021240-2404021809--32573",
"fare_basis_code": "GVAKZNBX",
"booking_code": "B",
"fare_family": "BASIC ECONOMY"
},
{
"segment_id": "10968-12387-2404031229-2404031618--32573",
"fare_basis_code": "QVAHZNBX",
"booking_code": "B",
"fare_family": "BASIC ECONOMY"
},
{
"segment_id": "12387-10602-2404091412-2404091544--32573",
"fare_basis_code": "LVAZZNBZ",
"booking_code": "B",
"fare_family": "BASIC ECONOMY"
},
{
"segment_id": "10602-16216-2404091658-2404091942--32573",
"fare_basis_code": "LVAZZNBZ",
"booking_code": "B",
"fare_family": "BASIC ECONOMY"
}
],
"opaque_id": "-1013399851",
"booking_metadata": {
"metadata_set": "",
"signature": ""
},
"ticket_attributes": [],
"flight_attributes": []
}
],
"transfer_type": "MANAGED",
"score": 1.87645,
"pricing_option_fare": {
"attribute_labels": [],
"leg_details": {},
"brand_names": []
}
}
],
"score": 1.87364,
"cheapest_price": {
"amount": 1307.4,
"update_status": "current",
"last_updated": "2024-01-09T09:40:39",
"quote_age": 5
},
"pricing_options_count": 1
},
{
"id": "16216-2404021226--32385-1-12387-2404022253|12387-2404090955--32385-1-16216-2404091721",
"leg_ids": [
"16216-2404021226--32385-1-12387-2404022253",
"12387-2404090955--32385-1-16216-2404091721"
],
"pricing_options": [
{
"id": "157vMhkQJ8Vt",
"agent_ids": [
"dela"
],
"price": {
"amount": 1370.4,
"update_status": "current",
"last_updated": "2024-01-09T09:40:39",
"quote_age": 5
},
"unpriced_type": "",
"items": [
{
"agent_id": "dela",
"url": "/transport_deeplink/4.0/US/en-GB/USD/dela/2/16216.12387.2024-04-02,12387.16216.2024-04-09/air/airli/flights?itinerary=flight|-32385|361|16216|2024-04-02T12:26|11152|2024-04-02T20:00|274|QAUOA0MQ|Q|ECONOMY;flight|-32385|2288|11152|2024-04-02T21:20|12387|2024-04-02T22:53|93|QAUOA0MQ|Q|ECONOMY,flight|-32385|2332|12387|2024-04-09T09:55|9596|2024-04-09T11:40|105|UAVNA0ME|U|ECONOMY;flight|-32385|662|9596|2024-04-09T14:55|16216|2024-04-09T17:21|326|UAVNA0ME|U|ECONOMY&carriers=-32385&operators=-32385;-32385,-32385;-32385&passengers=2&channel=website&cabin_class=economy&fps_session_id=a727e06a-6c38-4bcf-8a23-b5bcba1666ac&ticket_price=1370.40&is_npt=false&is_multipart=false&client_id=skyscanner_website&request_id=c087ce1e-3920-4547-8524-1628381be925&q_ids=H4sIAAAAAAAA_-NS4GJJSc1JFGLmuFEnxczxOEGhYeraDWwaDV2XNrAZMSkwAQAVZuTLIgAAAA|6389860417948404334|2&q_sources=JACQUARD&commercial_filters=false&q_datetime_utc=2024-01-09T09:40:39&pqid=false",
"segment_ids": [
"16216-11152-2404021226-2404022000--32385",
"11152-12387-2404022120-2404022253--32385",
"12387-9596-2404090955-2404091140--32385",
"9596-16216-2404091455-2404091721--32385"
],
"price": {
"amount": 1370.4,
"update_status": "current",
"last_updated": "2024-01-09T09:40:39",
"quote_age": 5
},
"booking_proposition": "PBOOK",
"transfer_protection": "",
"max_redirect_age": 10,
"fares": [
{
"segment_id": "16216-11152-2404021226-2404022000--32385",
"fare_basis_code": "QAUOA0MQ",
"booking_code": "Q",
"fare_family": "ECONOMY"
},
{
"segment_id": "11152-12387-2404022120-2404022253--32385",
"fare_basis_code": "QAUOA0MQ",
"booking_code": "Q",
"fare_family": "ECONOMY"
},
{
"segment_id": "12387-9596-2404090955-2404091140--32385",
"fare_basis_code": "UAVNA0ME",
"booking_code": "U",
"fare_family": "ECONOMY"
},
{
"segment_id": "9596-16216-2404091455-2404091721--32385",
"fare_basis_code": "UAVNA0ME",
"booking_code": "U",
"fare_family": "ECONOMY"
}
],
"opaque_id": "-1667017661",
"booking_metadata": {
"metadata_set": "",
"signature": ""
},
"ticket_attributes": [],
"flight_attributes": []
}
],
"transfer_type": "MANAGED",
"score": 3.3171,
"pricing_option_fare": {
"attribute_labels": [],
"leg_details": {},
"brand_names": []
}
}
],
"score": 3.31214,
"cheapest_price": {
"amount": 1370.4,
"update_status": "current",
"last_updated": "2024-01-09T09:40:39",
"quote_age": 5
},
"pricing_options_count": 1
},
],
"legs": [
{
"id": "16216-2404021419--32385-1-12387-2404030005",
"origin_place_id": 16216,
"destination_place_id": 12387,
"departure": "2024-04-02T14:19:00",
"arrival": "2024-04-03T00:05:00",
"segment_ids": [
"16216-9596-2404021419-2404022148--32385",
"9596-12387-2404022225-2404030005--32385"
],
"duration": 406,
"stop_count": 1,
"marketing_carrier_ids": [
-32385
],
"operating_carrier_ids": [
-32385
],
"stop_ids": [
[
9596
]
]
},
{
"id": "12387-2404091500--32385-1-16216-2404091945",
"origin_place_id": 12387,
"destination_place_id": 16216,
"departure": "2024-04-09T15:00:00",
"arrival": "2024-04-09T19:45:00",
"segment_ids": [
"12387-9596-2404091500-2404091638--32385",
"9596-16216-2404091720-2404091945--32385"
],
"duration": 465,
"stop_count": 1,
"marketing_carrier_ids": [
-32385
],
"operating_carrier_ids": [
-32385
],
"stop_ids": [
[
9596
]
]
}
],
"segments": [
{
"id": "16216-9596-2404021419-2404022148--32385",
"origin_place_id": 16216,
"destination_place_id": 9596,
"arrival": "2024-04-02T21:48:00",
"departure": "2024-04-02T14:19:00",
"duration": 269,
"marketing_flight_number": "437",
"marketing_carrier_id": -32385,
"operating_carrier_id": -32385,
"mode": "flight"
},
{
"id": "9596-12387-2404022225-2404030005--32385",
"origin_place_id": 9596,
"destination_place_id": 12387,
"arrival": "2024-04-03T00:05:00",
"departure": "2024-04-02T22:25:00",
"duration": 100,
"marketing_flight_number": "2178",
"marketing_carrier_id": -32385,
"operating_carrier_id": -32385,
"mode": "flight"
}
]
It is just a sample API response. Some objects will have more attributes. New arrays will also be there.
Understanding the Response
In the JSON response, you may observe that many objects include references (IDs or codes) to objects from other lists. This pattern is employed in our API to prevent redundant data and reduce the overall size by allowing multiple objects to reference the same data.
Sometimes you might have to make more than one API call to get complete data. Since we compare a lot of airlines and vendors sometimes it becomes impossible to pull this much amount of data at once
Last updated