Inflow Seat & Baggage

Seat Availability

post

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

The seat map API is divided into independent mode and non-independent mode.

• Independent mode means it can be used standalone without relying on other APIs.

• Non-independent mode depends on the price verification API or the get offer API.

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

application/json

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

HTTPcURLJavaScriptPython

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: 303

{
  "carrier": "W6",
  "outboundSegments": [
    {
      "flightNumber": "W62340",
      "segmentIndex": 1,
      "depAirport": "FCO",
      "arrAirport": "BUD",
      "cabinClass": "1",
      "depTime": "202501250825"
    }
  ],
  "inboundSegments": [
    {
      "flightNumber": "W62341",
      "segmentIndex": 2,
      "depAirport": "BUD",
      "arrAirport": "FCO",
      "cabinClass": "1",
      "depTime": "202501301915"
    }
  ]
}

Independent modeNon-independent mode with session idNon-independent mode with offer id

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"
}

Get Luggage

post

In a booking process, please call the 'getLuggage' API to get precise baggage quotes after price verification via 'verify' or 'getOffer'. Steps:

1. API sequence

   • Search - Verify- getLuggage - Order - Pay

   • getOffer - getLuggage - Order - Pay

2. For exact baggage prices, request 'getLuggage'.

3. Pass 'offerId' in 'getLuggage' requests:

   • From 'verify': Use sessionId as offerId

   • From 'getOffer': Use its offerId directly.

4. 'getLuggage' returns all flight segments' baggage data, each identified by a unique productCode.

5. In the Order step, use the productCode to add specific baggage products to the ticket order.

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

Header parameters

x-atlas-client-idstringRequired

api access id

Example: NAR65434_api_1

x-atlas-client-secretstringRequired

api access secret

Example: changeit

Accept-EncodingstringOptional

建议设置该请求头，能很大程度地减小网络传输报文的大小

Example: gzip

AcceptstringRequiredExample: application/json

Content-TypestringRequiredExample: application/json

Body

application/json

offerIdstringRequired

ThesessionIdreturned by verify api(verify.do)

Example: 85540632-ef14-4cb2-900e-453ef0a19477

maxResponseTimeinteger · nullableOptional

Query timeout, unit: milliseconds, default 5000ms.
Note: Due to network transmission and computational performance impacts, the client may still receive a normal result (rather than a timeout) even if this duration is exceeded. This time is used to control the overall response time of the interface within a certain range, with an error generally not exceeding a few hundred milliseconds.
If you have strict requirements for the timeout, it is recommended to set the timeout of your HTTP toolkit. If the HTTP toolkit you are using does not support this capability, you may need to leverage other tools—related capabilities are generally provided in most programming languages.

Default: 5000

Responses

200Success

application/json

statusinteger · enumRequired

• 212: illegal parameter.
• 214: offer not exists.
• 205: timed out.
• 299: airline error.
• 9999: system error.

Possible values:

msgstring · nullableOptional

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.

post

/getLuggage.do

HTTPcURLJavaScriptPython

POST /getLuggage.do HTTP/1.1
x-atlas-client-id: text
x-atlas-client-secret: text
Accept: text
Content-Type: application/json
Content-Length: 50

{
  "offerId": "o_d2c7d44baf2643ebac8b7926a8b0be60_1"
}

200Success

{
  "status": 0,
  "msg": null,
  "data": {
    "offerId": "o_d2c7d44baf2643ebac8b7926a8b0be60_1",
    "ancillaryProductElements": [
      {
        "ancillaryCode": "SCI_BAG_5KG",
        "auxBaggageElement": {
          "allWeight": true,
          "piece": 0,
          "size": "",
          "weight": 5
        },
        "canPurchasePostTicket": 1,
        "canPurchaseWithTicket": 1,
        "categoryCode": "StandardCheckInBaggage",
        "clientTechnicalServiceFee": 0,
        "currency": "USD",
        "maxQty": 1,
        "minQty": 1,
        "price": 10.17,
        "productCode": "SCI_BAG_5KG",
        "segmentIndex": 1,
        "vendorCurrency": "IDR",
        "vendorPrice": 165000
      },
      {
        "ancillaryCode": "SCI_BAG_10KG",
        "auxBaggageElement": {
          "allWeight": true,
          "piece": 0,
          "size": "",
          "weight": 10
        },
        "canPurchasePostTicket": 1,
        "canPurchaseWithTicket": 1,
        "categoryCode": "StandardCheckInBaggage",
        "clientTechnicalServiceFee": 0,
        "currency": "USD",
        "maxQty": 1,
        "minQty": 1,
        "price": 16.34,
        "productCode": "SCI_BAG_10KG",
        "segmentIndex": 1,
        "vendorCurrency": "IDR",
        "vendorPrice": 265000
      },
      {
        "ancillaryCode": "SCI_BAG_30KG",
        "auxBaggageElement": {
          "allWeight": true,
          "piece": 0,
          "size": "",
          "weight": 30
        },
        "canPurchasePostTicket": 1,
        "canPurchaseWithTicket": 1,
        "categoryCode": "StandardCheckInBaggage",
        "clientTechnicalServiceFee": 0,
        "currency": "USD",
        "maxQty": 1,
        "minQty": 1,
        "price": 36.06,
        "productCode": "SCI_BAG_30KG",
        "segmentIndex": 1,
        "vendorCurrency": "IDR",
        "vendorPrice": 585000
      },
      {
        "ancillaryCode": "SCI_BAG_20KG",
        "auxBaggageElement": {
          "allWeight": true,
          "piece": 0,
          "size": "",
          "weight": 20
        },
        "canPurchasePostTicket": 1,
        "canPurchaseWithTicket": 1,
        "categoryCode": "StandardCheckInBaggage",
        "clientTechnicalServiceFee": 0,
        "currency": "USD",
        "maxQty": 1,
        "minQty": 1,
        "price": 24.35,
        "productCode": "SCI_BAG_20KG",
        "segmentIndex": 1,
        "vendorCurrency": "IDR",
        "vendorPrice": 395000
      },
      {
        "ancillaryCode": "SCI_BAG_40KG",
        "auxBaggageElement": {
          "allWeight": true,
          "piece": 0,
          "size": "",
          "weight": 40
        },
        "canPurchasePostTicket": 1,
        "canPurchaseWithTicket": 1,
        "categoryCode": "StandardCheckInBaggage",
        "clientTechnicalServiceFee": 0,
        "currency": "USD",
        "maxQty": 1,
        "minQty": 1,
        "price": 48.38,
        "productCode": "SCI_BAG_40KG",
        "segmentIndex": 1,
        "vendorCurrency": "IDR",
        "vendorPrice": 785000
      }
    ],
    "inboundSegments": [],
    "outboundSegments": [
      {
        "aircraftCode": "320",
        "arrAirport": "CGK",
        "arrTerminal": "",
        "arrTime": "202508231100",
        "cabin": "",
        "cabinClass": 1,
        "carrier": "QG",
        "codeShare": false,
        "depAirport": "SIN",
        "depTerminal": "",
        "depTime": "202508231010",
        "duration": 110,
        "fareFamily": "ECO",
        "flightNumber": "QG523",
        "operatingCarrier": "",
        "operatingFlightnumber": "",
        "seatCount": 9,
        "segmentIndex": 1,
        "stopCities": ""
      }
    ]
  }
}