Seat

Atlas API seatAvailability.do reference for retrieving seat options within a valid booking flow.

💬 Need help? If you're stuck, ask Eva in the Help Center for instant diagnostics.

Ask Eva

Use this endpoint for inflow seat lookup.

seatAvailability.do no longer supports independent mode.

Call it only with a valid sessionId from verify.do or OfferId from getOffers.do.

Do not call it with flight data alone.

seatAvailability.do shares one 60 QPM ancillary pool with getLuggage.do.

Over-limit requests return HTTP 429 Too Many Requests.

Wait for the returned retryAfter value before retrying.

SeatAvailability call rules

Use seatAvailability.do only inside a valid booking chain.

Supported request context:

• sessionId returned by verify.do

• OfferId returned by getOffers.do

Unsupported request context:

• flight information alone

Regional handling

Global customers

Keep the current flow.

Use sessionId or OfferId as before.

China OTA scenarios

Some upstream seat requests contain only flight information.

For this case, keep the sessionId returned by verify.do.

When the seat request arrives, match the flight to the cached sessionId.

If the match succeeds, call seatAvailability.do with that sessionId.

If no match exists, treat it as a pure quote request.

Atlas does not support that case.

Why this changed

This rule keeps seat pricing and fulfillment aligned with the real booking chain.

It also reduces invalid airline-side queries.

Use API Request Limits for shared rules and counting details.

Seat Availability

post

Dependency: Verify or getOffer function should be called in prior to this call.

In a booking process, please call the 'seatAvailability' API to get seat availability information after price verification via 'verify' or 'getOffer'. Steps:

1. API sequence

   • Search - Verify- seatAvailability - Order - Pay

   • getOffer - seatAvailability - Order - Pay

2. Pass 'offerId' in 'seatAvailability' requests:

   • From 'verify': Use sessionId directly. From 'getOffer': Use its offerId.

3. In the Order step, use the productCode to add specific seat to the ticket order.

Endpoint: https://sandbox.atriptech.com/seatAvailability.do

Header parameters

AcceptstringRequiredExample: application/json

Content-TypestringRequiredExample: application/json

Accept-EncodingstringRequiredExample: gzip

x-atlas-client-idstringRequiredExample: NAR65434_api_1

x-atlas-client-secretstringRequiredExample: <YOUR_CLIENT_SECRET>

Body

sessionIdstringRequired

ThesessionIdreturned by price verification api(verify.do). Only required in Non-independent mode.

offerIdstringRequired

TheofferIDreturned by get offer api(getOffers.do). Only required in Non-independent mode.

carrierstringRequired

The IATA code of MSC(known as Most Significant Carrier) of the itinerary.

Responses

200Success

application/json

statusinteger · enumRequired

• 214: Session ID invalid or expired.
• 215: Segment index missing.
• 216: Seat selection failed.
• 217: Unknown error.
• 218: The airline don’t support seat selection currently.
• 219: The route don’t support seat selection currently.
• 220: illegal request parameter.
• 221: Fare family is empty and not configured with lowest price fare family.
• 223: The ratio of seat quotation requests to payment orders has exceeded the allowed threshold.

Possible values:

msgstring · nullableOptional

It serves 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. For example, do not judge whether the interface responds successfully based on this field. Instead, you should only determine it by checking whether the status is equal to0at any time.

post/seatAvailability.do

POST /seatAvailability.do HTTP/1.1
Accept: text
Accept-Encoding: text
x-atlas-client-id: NAR65434_api_1
x-atlas-client-secret: text
Content-Type: application/json
Content-Length: 52

{
  "sessionId": "f623b2c4-a1ed-4e8f-9cfb-5de1ae7739d6"
}

200Success

{
  "cabins": [
    {
      "segmentIndex": 1,
      "cabin": {
        "deck": "main",
        "cabinClass": 1,
        "cabinLayout": {
          "columns": [
            {
              "designator": "A",
              "characteristics": "W"
            },
            {
              "designator": "B",
              "characteristics": "M"
            },
            {
              "designator": "C",
              "characteristics": "A"
            },
            {
              "designator": "D",
              "characteristics": "W"
            },
            {
              "designator": "E",
              "characteristics": "M"
            },
            {
              "designator": "F",
              "characteristics": "A"
            }
          ],
          "rows": {
            "first": 4,
            "last": 20
          },
          "exitRowPositions": [
            {
              "first": 4,
              "last": 5
            },
            {
              "first": 10,
              "last": 11
            },
            {
              "first": 20,
              "last": 20
            }
          ]
        },
        "rows": [
          {
            "number": 4,
            "seats": [
              {
                "column": "A",
                "seatStatus": "F",
                "seatCharacteristics": [
                  "W",
                  "L",
                  "E"
                ],
                "price": 26.29,
                "currency": "USD",
                "vendorPrice": 26.29,
                "vendorCurrency": "USD",
                "productCode": "SCI_SEAT_4A_W6_FCO_BUD"
              },
              {
                "column": "B",
                "seatStatus": "F",
                "seatCharacteristics": [
                  "M",
                  "L",
                  "E"
                ],
                "price": 10.79,
                "currency": "USD",
                "vendorPrice": 10.79,
                "vendorCurrency": "USD",
                "productCode": "SCI_SEAT_4B_W6_FCO_BUD"
              },
              {
                "column": "C",
                "seatStatus": "F",
                "seatCharacteristics": [
                  "A",
                  "L",
                  "E"
                ],
                "price": 30.13,
                "currency": "USD",
                "vendorPrice": 30.13,
                "vendorCurrency": "USD",
                "productCode": "SCI_SEAT_4C_W6_FCO_BUD"
              },
              {
                "column": "D",
                "seatStatus": "F",
                "seatCharacteristics": [
                  "W",
                  "L",
                  "E"
                ],
                "price": 88.43,
                "currency": "USD",
                "vendorPrice": 88.43,
                "vendorCurrency": "USD",
                "productCode": "SCI_SEAT_4D_W6_FCO_BUD"
              },
              {
                "column": "E",
                "seatStatus": "F",
                "seatCharacteristics": [
                  "M",
                  "L",
                  "E"
                ],
                "price": 56.78,
                "currency": "USD",
                "vendorPrice": 56.78,
                "vendorCurrency": "USD",
                "productCode": "SCI_SEAT_4E_W6_FCO_BUD"
              },
              {
                "column": "F",
                "seatStatus": "F",
                "seatCharacteristics": [
                  "A",
                  "L",
                  "E"
                ],
                "price": 29.47,
                "currency": "USD",
                "vendorPrice": 29.47,
                "vendorCurrency": "USD",
                "productCode": "SCI_SEAT_4F_W6_FCO_BUD"
              }
            ]
          }
        ]
      }
    },
    {
      "segmentIndex": 2,
      "cabin": {
        "deck": "main",
        "cabinClass": 1,
        "cabinLayout": {
          "columns": [
            {
              "designator": "A",
              "characteristics": "W"
            },
            {
              "designator": "B",
              "characteristics": "M"
            },
            {
              "designator": "C",
              "characteristics": "A"
            },
            {
              "designator": "D",
              "characteristics": "W"
            },
            {
              "designator": "E",
              "characteristics": "M"
            },
            {
              "designator": "F",
              "characteristics": "A"
            }
          ],
          "rows": {
            "first": 4,
            "last": 20
          },
          "exitRowPositions": [
            {
              "first": 4,
              "last": 5
            },
            {
              "first": 10,
              "last": 11
            },
            {
              "first": 20,
              "last": 20
            }
          ]
        },
        "rows": [
          {
            "number": 5,
            "seats": [
              {
                "column": "A",
                "seatStatus": "F",
                "seatCharacteristics": [
                  "W",
                  "L",
                  "E"
                ],
                "price": 34.25,
                "currency": "USD",
                "vendorPrice": 34.25,
                "vendorCurrency": "USD",
                "productCode": "SCI_SEAT_5A_W6_BUD_FCO"
              },
              {
                "column": "B",
                "seatStatus": "F",
                "seatCharacteristics": [
                  "M",
                  "L",
                  "E"
                ],
                "price": 26.42,
                "currency": "USD",
                "vendorPrice": 26.42,
                "vendorCurrency": "USD",
                "productCode": "SCI_SEAT_5B_W6_BUD_FCO"
              },
              {
                "column": "C",
                "seatStatus": "F",
                "seatCharacteristics": [
                  "A",
                  "L",
                  "E"
                ],
                "price": 25.53,
                "currency": "USD",
                "vendorPrice": 25.53,
                "vendorCurrency": "USD",
                "productCode": "SCI_SEAT_5C_W6_BUD_FCO"
              },
              {
                "column": "D",
                "seatStatus": "F",
                "seatCharacteristics": [
                  "W",
                  "L",
                  "E"
                ],
                "price": 22.75,
                "currency": "USD",
                "vendorPrice": 22.75,
                "vendorCurrency": "USD",
                "productCode": "SCI_SEAT_5D_W6_BUD_FCO"
              },
              {
                "column": "E",
                "seatStatus": "F",
                "seatCharacteristics": [
                  "M",
                  "L",
                  "E"
                ],
                "price": 68.06,
                "currency": "USD",
                "vendorPrice": 68.06,
                "vendorCurrency": "USD",
                "productCode": "SCI_SEAT_5E_W6_BUD_FCO"
              },
              {
                "column": "F",
                "seatStatus": "F",
                "seatCharacteristics": [
                  "A",
                  "L",
                  "E"
                ],
                "price": 29.83,
                "currency": "USD",
                "vendorPrice": 29.83,
                "vendorCurrency": "USD",
                "productCode": "SCI_SEAT_5F_W6_BUD_FCO"
              }
            ]
          }
        ]
      }
    }
  ],
  "status": 0,
  "msg": "success"
}