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

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