✈️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:

ParametersDescriptionType

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

Usage

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"

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.

Field NameDescription

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.

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