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.
GET
https://api.flightapi.io/roundtrip 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:
| Parameter | Description | Type |
|---|---|---|
api_key required | This is your personal API key. You can find this on your Dashboard. | String |
departure_airport_code required | This is the IATA code of departure airport. | String |
arrival_airport_code required | This is the IATA code of arrival airport. | String |
departure_date required | Date of departure Format - YYYY-MM-DD | String |
arrival_date required | Date of Arrival Format - YYYY-MM-DD | String |
number_of_adults required | This is the number of adults. | String |
number_of_childrens required | This is the number of childrens. | String |
number_of_infants required | This is the number of infants. | String |
cabin_class required | This is the class of the seat in the plane. Possible Values- "Economy", "Business", "First" or "Premium_Economy" | String |
currency required | You can use any currency code like USD, INR, EUR, etc | String |
region required | Check local prices of any country by passing the ISO code of that country. | String |
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"
}
]
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.
Response Fields
| Field Name | Description |
|---|---|
itineraries | A return trip will consist of 2 legs, while a one-way trip will consist of 1 leg. An itinerary will contain a deepLink field which takes the traveler to the booking page. |
legs | Provides information about the flight leg from the destination to the origin. A leg comprises a single segment for a direct flight and may consist of multiple segments if there are several stopovers. |
segments | Displays information about individual stops within a leg. For instance, if a leg includes one-stop, the segment will provide details about the stopover, including its duration and location. |
places | Reveals specific stops within a leg. For instance, in the case of a leg with a single stop, the segment will present information about the stopover, including its duration and location. |
carriers | Like places, the carriers section contains details about the airlines mentioned in the itineraries. |
agents | Just like places, the agents section comprises details about the Online Travel Agencies (OTAs) mentioned in the itineraries. |
