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

List extras for an order

What the airline still sells against an existing booking — bags, meals, lounge, assistance.

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

The extras the airline sells for this booking, priced for its passengers and flights. This is the catalogue POST /v1/orders/{orderID}/services buys from; what it lists, and when, is the airline's choice.

ssr (e.g. WCHR,UMNR) and loyalty (AIRLINE:NUMBER) qualify the list; an airline that cannot answers 501. A closed order returns an empty list.

Request example

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

Response example

{
  "order_id": "AA001Y1XD7ZA6",
  "services": [
    {
      "service_id": "AA-SVC…|ITEM…",
      "type": "bag_checked",
      "name": "1st checked bag",
      "price": {
        "amount": 45,
        "currency": "EUR"
      },
      "segment_refs": [
        "SEG-1"
      ],
      "pax_refs": [
        "PAX96101"
      ]
    }
  ]
}

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, comma-separated.

Example: AA:1234567

ssrstring

Comma-separated SSR (special service request) codes to ask offers for (WCHR,UMNR).

Example: WCHR

Response fields

order_idstringRequired

The order the catalogue is for.

services[]array<Service>Required

service_id (pass it back as ancillary_offer_id), type, name, description, price, segment_refs, pax_refs.

Error codes

404

order_not_found — not this account's order in this key's environment.

501

this airline does not support service list qualifiers — ssr or loyalty on a carrier that cannot honour them.

502

The airline could not list its services.