Flight Offers Search - API 对接文档

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params text/plain

Example

Example:{ "currencyCode": "USD", "originDestinations": [ { "id": "1", "originLocationCode": "BOS", "destinationLocationCode": "MAD", "departureDateTimeRange": { "date": "{{departureDate}}", "time": "10:00:00" } }, { "id": "2", "originLocationCode": "MAD", "destinationLocationCode": "BOS", "departureDateTimeRange": { "date": "{{returnDate}}", "time": "17:00:00" } } ], "travelers": [ { "id": "1", "travelerType": "ADULT", "fareOptions": [ "STANDARD" ] }, { "id": "2", "travelerType": "CHILD", "fareOptions": [ "STANDARD" ] } ], "sources": [ "GDS" ], "searchCriteria": { "maxFlightOffers": 2, "flightFilters": { "cabinRestrictions": [ { "cabin": "BUSINESS", "coverage": "MOST_SEGMENTS", "originDestinationIds": [ "1" ] } ], "carrierRestrictions": { "excludedCarrierCodes": [ "AA", "TP", "AZ" ] } } } }

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v2/shopping/flight-offers' \
--header 'X-HTTP-Method-Override: GET' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: text/plain' \
--data-raw '{
    "currencyCode": "USD",
    "originDestinations": [
        {
            "id": "1",
            "originLocationCode": "BOS",
            "destinationLocationCode": "MAD",
            "departureDateTimeRange": {
                "date": "{{departureDate}}",
                "time": "10:00:00"
            }
        },
        {
            "id": "2",
            "originLocationCode": "MAD",
            "destinationLocationCode": "BOS",
            "departureDateTimeRange": {
                "date": "{{returnDate}}",
                "time": "17:00:00"
            }
        }
    ],
    "travelers": [
        {
            "id": "1",
            "travelerType": "ADULT",
            "fareOptions": [
                "STANDARD"
            ]
        },
        {
            "id": "2",
            "travelerType": "CHILD",
            "fareOptions": [
                "STANDARD"
            ]
        }
    ],
    "sources": [
        "GDS"
    ],
    "searchCriteria": {
        "maxFlightOffers": 2,
        "flightFilters": {
            "cabinRestrictions": [
                {
                    "cabin": "BUSINESS",
                    "coverage": "MOST_SEGMENTS",
                    "originDestinationIds": [
                        "1"
                    ]
                }
            ],
            "carrierRestrictions": {
                "excludedCarrierCodes": [
                    "AA",
                    "TP",
                    "AZ"
                ]
            }
        }
    }
}'

Responses

🟢200Flight Offers Search

application/json

Body

Example

{
    "meta": {
        "count": 2
    },
    "data": [
        {
            "type": "flight-offer",
            "id": "1",
            "source": "GDS",
            "instantTicketingRequired": false,
            "nonHomogeneous": false,
            "oneWay": false,
            "lastTicketingDate": "2024-03-21",
            "lastTicketingDateTime": "2024-03-21",
            "numberOfBookableSeats": 9,
            "itineraries": [
                {
                    "duration": "PT7H",
                    "segments": [
                        {
                            "departure": {
                                "iataCode": "BOS",
                                "terminal": "E",
                                "at": "2024-04-04T17:00:00"
                            },
                            "arrival": {
                                "iataCode": "MAD",
                                "terminal": "4S",
                                "at": "2024-04-05T06:00:00"
                            },
                            "carrierCode": "IB",
                            "number": "6166",
                            "aircraft": {
                                "code": "330"
                            },
                            "operating": {
                                "carrierCode": "IB"
                            },
                            "duration": "PT7H",
                            "id": "1",
                            "numberOfStops": 0,
                            "blacklistedInEU": false
                        }
                    ]
                },
                {
                    "duration": "PT29H5M",
                    "segments": [
                        {
                            "departure": {
                                "iataCode": "MAD",
                                "terminal": "4S",
                                "at": "2024-04-18T20:45:00"
                            },
                            "arrival": {
                                "iataCode": "LHR",
                                "terminal": "5",
                                "at": "2024-04-18T22:00:00"
                            },
                            "carrierCode": "IB",
                            "number": "7467",
                            "aircraft": {
                                "code": "319"
                            },
                            "operating": {
                                "carrierCode": "BA"
                            },
                            "duration": "PT2H15M",
                            "id": "4",
                            "numberOfStops": 0,
                            "blacklistedInEU": false
                        },
                        {
                            "departure": {
                                "iataCode": "LHR",
                                "terminal": "5",
                                "at": "2024-04-19T17:15:00"
                            },
                            "arrival": {
                                "iataCode": "BOS",
                                "terminal": "E",
                                "at": "2024-04-19T19:50:00"
                            },
                            "carrierCode": "AY",
                            "number": "5503",
                            "aircraft": {
                                "code": "781"
                            },
                            "operating": {
                                "carrierCode": "BA"
                            },
                            "duration": "PT7H35M",
                            "id": "5",
                            "numberOfStops": 0,
                            "blacklistedInEU": false
                        }
                    ]
                }
            ],
            "price": {
                "currency": "USD",
                "total": "6502.20",
                "base": "3898.00",
                "fees": [
                    {
                        "amount": "0.00",
                        "type": "SUPPLIER"
                    },
                    {
                        "amount": "0.00",
                        "type": "TICKETING"
                    }
                ],
                "grandTotal": "6502.20"
            },
            "pricingOptions": {
                "fareType": [
                    "PUBLISHED"
                ],
                "includedCheckedBagsOnly": false
            },
            "validatingAirlineCodes": [
                "IB"
            ],
            "travelerPricings": [
                {
                    "travelerId": "1",
                    "fareOption": "STANDARD",
                    "travelerType": "ADULT",
                    "price": {
                        "currency": "USD",
                        "total": "3251.10",
                        "base": "1949.00"
                    },
                    "fareDeta