Atlas API-Sabre
  1. Shopping and Ticketing
Atlas API-Sabre
  • Shopping and Ticketing
    • Search
      POST
    • Verify
      POST
    • Order
      POST
    • Order Commit
      POST
    • Payment
      POST
    • Retrieve Booking
      POST
    • Smart Search
      POST
    • Get Offer
      POST
    • Seat Availability
      POST
    • Get Luggage
      POST
  • Post Ticketing Service
    • Search Ancillary
      POST
    • Order Ancillary
      POST
  • Notifications and Webhook
    • Register Webhook
      POST
    • Incident List
      POST
  • Refund
    • Refund Quotation
      POST
    • Make a Refund
      POST
    • Query Refund Status
      POST
  • Other Functions
    • Regenerate Order
      POST
    • Stop Ticket Issuance
      POST
    • Order List
      POST
    • PNR Claim
      POST
    • Get Balance
      POST
    • City Pairs API
      POST
    • Email List
      POST
    • Extract PNR
      POST
    • getAtripToken
      POST
  1. Shopping and Ticketing

Get Offer

POST
/getOffers.do

Request

Header Params
Accept
string 
required
Example:
application/json
Content-Type
string 
required
Example:
application/json
Accept-Encoding
string 
required
Example:
gzip
x-atlas-client-id
string 
required
Example:
NAR65434_api_1
x-atlas-client-secret
string 
required
Example:
<YOUR_CLIENT_ID>
Body Params application/json
adults
integer 
required
Number of adults
>= 1<= 9
Default:
0
Example:
1
children
integer  | null 
optional
Number of children
>= 0<= 9
Default:
0
Example:
0
infants
integer  | null 
optional
Number of infants
>= 0<= 9
Default:
0
Example:
0
outboundSegments
array[object (UniqueSellingSegment) {5}] 
required
Return flight segments are arranged in the order of flight.
>= 1 items
carrier
string 
required
IATA two letter code of marketing carrier, case sensitive
>= 2 characters<= 2 characters
Example:
U2
departureAirport
string 
required
IATA three letter code of departure airport which is case sensitive. If the value is illegal, the system will prompt that the airport does not exist.
>= 3 characters<= 3 characters
Example:
LON
arrivalAirport
string 
required
IATA three letter code of arrival airport which is case sensitive. If the value is illegal, the system will prompt that the airport does not exist.
>= 3 characters<= 3 characters
Example:
PAR
flightNumber
string 
required
Marketing flight number. Attention: Without airline code prefix. It should be noted that some users may enter flight numbers with or without zero padding, for example, you may enter 06 (or 6), but the airline may be 6 (or 06). Anyway, we will return to the user based on the actual flight number provided by the airline, and the user may need to handle the differences between request and response.
>= 1 characters
Example:
673
departureDate
string <date>
required
Departure date. Format: yyyyMMdd. We do not require users to specify departure times, nor do we want to return segments based on specific departure time. Considering that the externally transmitted time may not match the actual flight segment time on the supplier's (airline's) side, this can lead to search results being lost. Therefore, we will return the results of all flight segments that took off within the specified date, and it will be up to the user to decide how to use them.
>= 8 characters<= 8 characters
Example:
20250301
Match pattern:
^[\d]{8}$
inboundSegments
array[object (UniqueSellingSegment) {5}]  | null 
optional
Arrange the outbound flight segments in the order of flight. Optional, null or [] indicates one-way.
>= 0 items
carrier
string 
required
IATA two letter code of marketing carrier, case sensitive
>= 2 characters<= 2 characters
Example:
U2
departureAirport
string 
required
IATA three letter code of departure airport which is case sensitive. If the value is illegal, the system will prompt that the airport does not exist.
>= 3 characters<= 3 characters
Example:
LON
arrivalAirport
string 
required
IATA three letter code of arrival airport which is case sensitive. If the value is illegal, the system will prompt that the airport does not exist.
>= 3 characters<= 3 characters
Example:
PAR
flightNumber
string 
required
Marketing flight number. Attention: Without airline code prefix. It should be noted that some users may enter flight numbers with or without zero padding, for example, you may enter 06 (or 6), but the airline may be 6 (or 06). Anyway, we will return to the user based on the actual flight number provided by the airline, and the user may need to handle the differences between request and response.
>= 1 characters
Example:
673
departureDate
string <date>
required
Departure date. Format: yyyyMMdd. We do not require users to specify departure times, nor do we want to return segments based on specific departure time. Considering that the externally transmitted time may not match the actual flight segment time on the supplier's (airline's) side, this can lead to search results being lost. Therefore, we will return the results of all flight segments that took off within the specified date, and it will be up to the user to decide how to use them.
>= 8 characters<= 8 characters
Example:
20250301
Match pattern:
^[\d]{8}$
currency
string  | null 
optional
Quotation currency, optional, default will be determined based on a certain strategy, such as the currency of the customer's pre deposit account
Example:
USD
Example
{
    "adults": 1,
    "children": 1,
    "infants": 1,
    "inboundSegments": [
        {
            "departureAirport": "LON",
            "arrivalAirport": "PAR",
            "carrier": "U2",
            "flightNumber": "673",
            "departureDate": "20250301"
        }
    ],
    "outboundSegments": null
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://sandbox.atriptech.com/getOffers.do' \
--header 'Accept: application/json' \
--header 'Accept;' \
--header 'Accept-Encoding: gzip' \
--header 'Accept-Encoding;' \
--header 'x-atlas-client-id;' \
--header 'x-atlas-client-id;' \
--header 'x-atlas-client-secret;' \
--header 'x-atlas-client-secret;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "adults": 1,
    "children": 1,
    "infants": 1,
    "inboundSegments": [
        {
            "departureAirport": "LON",
            "arrivalAirport": "PAR",
            "carrier": "U2",
            "flightNumber": "673",
            "departureDate": "20250301"
        }
    ],
    "outboundSegments": null
}'

Responses

🟢200成功
application/json
Body
status
enum<integer> 
required
0: success
116: airline error
112: timed out
9999: system error
Allowed values:
01161129999
msg
string  | null 
optional
As an additional description of the response result. Especially when the interface reports an error (status ≠ 0), it is usually a human-readable error message.

Note: Do not use this field in any programming scenarios, such as judging whether the interface response is successful based on this field. You should always judge solely based on whether the status is equal to 0.
data
array [object {4}]  | null 
optional
offer
object 
required
serviceFee
object (Service-Fee) 
required
bookingRequirement
object (Booking-Requirement-Schema) 
required
supportedPaymentMethods
array[string]
optional
Supported payment methods. nullor[]indicates that no payment methods are available.
Allowed values:
DepositVCC_PassthroughBYOAMoR
Example
{
    "status": 0,
    "msg": "string",
    "data": [
        {
            "offer": {
                "offerID": "o_b07c7d690aea44889eca1f22ad90841c_1",
                "offerToken": "string",
                "paxFares": [
                    {
                        "paxType": "ADT",
                        "price": {
                            "baseAmount": 100,
                            "taxes": 0,
                            "currency": "USD"
                        }
                    }
                ],
                "penalties": [
                    {
                        "journeyRefIDs": [
                            "string"
                        ],
                        "amount": 0,
                        "currency": "USD",
                        "rule": {
                            "type": "Refund",
                            "paxTypes": [
                                "ADT"
                            ],
                            "levelType": "Full",
                            "effectiveMinutes": 0,
                            "expirationMinutes": 0,
                            "fixedAmount": 0,
                            "airlineFee": 0,
                            "currency": "USD",
                            "percent": 0.2,
                            "percentBase": "fare+tax"
                        }
                    }
                ],
                "services": [
                    {
                        "serviceID": "string",
                        "segmentRefIDs": [
                            "string"
                        ],
                        "type": "Baggage",
                        "level": "Free",
                        "paxTypes": [
                            "ADT"
                        ],
                        "metadata": {
                            "type": "StandardCheckInBaggage",
                            "maximumWeight": 20,
                            "maximumPiece": 1,
                            "maximumDimension": "L+W+H<=158cm"
                        }
                    }
                ],
                "outboundJourney": {
                    "journeyID": "string",
                    "segments": [
                        {
                            "segmentID": "string",
                            "carrier": "string",
                            "flightNumber": "string",
                            "operatingCarrier": "string",
                            "operatingFlightNumber": "string",
                            "duration": 0,
                            "legs": [
                                {
                                    "departureAirport": "string",
                                    "departureTime": "202503011100",
                                    "departureTerminal": "string",
                                    "arrivalAirport": "string",
                                    "arrivalTime": "string",
                                    "arrivalTerminal": "string",
                                    "aircraftType": "string"
                                }
                            ],
                            "fareFamily": "string",
                            "RBD": "string",
                            "cabinClass": "Economy",
                            "seatsLeft": 0
                        }
                    ]
                },
                "inboundJourney": {
                    "journeyID": "string",
                    "segments": [
                        {
                            "segmentID": "string",
                            "carrier": "string",
                            "flightNumber": "string",
                            "operatingCarrier": "string",
                            "operatingFlightNumber": "string",
                            "duration": 0,
                            "legs": [
                                {
                                    "departureAirport": "string",
                                    "departureTime": "202503011100",
                                    "departureTerminal": "string",
                                    "arrivalAirport": "string",
                                    "arrivalTime": "string",
                                    "arrivalTerminal": "string",
                                    "aircraftType": "string"
                                }
                            ],
                            "fareFamily": "string",
                            "RBD": "string",
                            "cabinClass": "Economy",
                            "seatsLeft": 0
                        }
                    ]
                },
                "terms": [
                    {
                        "carrier": "string",
                        "URL": "string"
                    }
                ]
            },
            "serviceFee": {
                "amountPerUnit": 0,
                "unit": "PER_SEGMENT",
                "currency": "USD"
            },
            "bookingRequirement": {
                "passenger": {
                    "name": {
                        "type": "string",
                        "required": true,
                        "description": "string",
                        "maxLength": "string"
                    },
                    "passengerType": {
                        "type": "string",
                        "required": true,
                        "description": "string",
                        "maxLength": "string"
                    },
                    "birthday": {
                        "type": "string",
                        "required": true,
                        "description": "string",
                        "maxLength": "string"
                    },
                    "gender": {
                        "type": "string",
                        "required": true,
                        "description": "string",
                        "maxLength": "string"
                    },
                    "nationality": {
                        "type": "string",
                        "required": true,
                        "description": "string",
                        "maxLength": "string"
                    },
                    "cardType": {
                        "type": "string",
                        "required": true,
                        "description": "string",
                        "maxLength": "string"
                    },
                    "cardNum": {
                        "type": "string",
                        "required": true,
                        "description": "string",
                        "maxLength": "string"
                    },
                    "cardIssuePlace": {
                        "type": "string",
                        "required": true,
                        "description": "string",
                        "maxLength": "string"
                    },
                    "cardExpired": {
                        "type": "string",
                        "required": true,
                        "description": "string",
                        "maxLength": "string"
                    }
                }
            },
            "supportedPaymentMethods": [
                "Deposit"
            ]
        }
    ]
}
Modified at 2025-07-01 01:10:38
Previous
Smart Search
Next
Seat Availability
Built with