Sandbox orders are test bookings

Sandbox keys reach the airlines’ test systems: nobody flies on these orders and no booking fee is charged. Check status and tickets[], not the HTTP code.

Servicing

Seat map for an order

The seat map of a booked flight, priced for the travellers on the order.

GET/v1/orders/{orderID}/seatsRequires X-API-Key

The seat map of a booked flight, priced for the order's travellers. This is the catalogue POST /v1/orders/{orderID}/seats buys from.

segment_id returns one flight's map (an unknown one is 404 seat_map_segment_not_found with segments_available); loyalty prices status benefits in. A closed order is 409.

N-102Cabin section A–A — economy, 3–3

Sample data

Request example

curl --request GET \
  --url https://api.norba.io/v1/orders/{orderID}/seats \
  --header "X-API-Key: $NORBA_KEY"

Response example

{
  "flight_id": "SEG-2",
  "airline": "AA",
  "aircraft": "777",
  "rows": 24,
  "seats": [
    {
      "seat_id": "17A",
      "row": 17,
      "column": "A",
      "cabin": "Economy",
      "available": true,
      "price": {
        "amount": 23,
        "currency": "EUR"
      },
      "features": [
        "window",
        "extra_legroom"
      ],
      "segment_id": "SEG-2"
    }
  ]
}

Authorization

X-API-KeystringRequired

Your API key from the dashboard. A missing or invalid key answers 401; see Authentication.

Path parameters

orderIDstringRequired

Canonical order ID.

Example: AA001Y1XD7ZA6

Query parameters

loyaltystring

Frequent-flyer accounts, AIRLINE:NUMBER.

Example: AA:1234567

segment_idstring

One flight of the itinerary. Recommended unless the trip is a single non-stop.

Example: SEG-2

Error codes

404

order_not_found, or seat_map_segment_not_found with segments_available.

409

illegal_transition — a closed order has no seats to choose.

501

this airline does not support seat map qualifiers — segment_id or loyalty on a carrier that cannot honour them.

502

The airline could not produce a seat map.