NorbaNorba
Get API Key
Live and bookable — pre-production, and no payment

These endpoints work against real American Airlines inventory: a search returns real offers and you can create a real booking with a carrier PNR. Two limits are worth knowing before you build against them.

  • Orders are pre-production. They are genuine reservations in the airline's pre-production system, not commercial tickets — nobody flies on them. Cancel what you create; anything left over expires on its own payment time limit.
  • Payment and ticketing cannot complete. An order is created as an unpaid hold, which is the normal agency flow, but ticketing is inhibited on this IATA number, so POST /v1/orders/{orderID}/commit returns 502. Everything up to and including the reservation works.
Servicing

Quote a change

Structured servicing: price a voluntary change before committing to it.

POST/v1/orders/{orderID}/changeRequires X-API-Key
The quote half of the structured quote → confirm change flow. Returns the same ChangeQuote as POST /v1/orders/{orderID}/quote — original fare, new fare, penalty, difference.**Present the quote to the traveller, then call POST /v1/orders/{orderID}/change/confirm.**> The body is currently decoded and discarded: action, segment_ids and reason are accepted and validated as JSON, but the handler reprices the whole order regardless. Send {} and rely on the quote. Targeted per-segment change pricing is not implemented.?airline= is required.

Request example

curl --request POST \
  --url https://api.norba.io/v1/orders/{orderID}/change \
  --header "X-API-Key: $NORBA_KEY" \
  --header "Content-Type: application/json" \
  --data '{ "action": "reissue" }'

Response example

Response example
{
  "quote_id": "qte_01K2M8ZC3AC5N8",
  "order_id": "AA001Y1XD7ZA6",
  "original_fare": {
    "amount": 380.62,
    "currency": "EUR"
  },
  "new_fare": {
    "amount": 380.62,
    "currency": "EUR"
  },
  "penalty": {
    "amount": 0,
    "currency": "EUR"
  },
  "difference": {
    "amount": 0,
    "currency": "EUR"
  },
  "valid_until": "2026-08-14T10:15:00Z"
}

Authorization

X-API-KeystringRequired
Opaque API key issued from the Norba dashboard. Sent on every request as the X-API-Key HTTP header. Missing or invalid keys are rejected with 401 Unauthorized.

Path parameters

orderIDstringRequired
Canonical order ID.
Example: AA001Y1XD7ZA6

Query parameters

airlinestringRequired
IATA code. Required — 400 unknown airline; provide ?airline=XX.
Example: AA

Request body

actionstring
reissue, ancillaries or cancel_segments. Accepted but not acted on.
segment_idsarray<string>
Accepted but not acted on.
reasonstring
Accepted but not acted on.

Error codes

400
invalid json, or unknown airline; provide ?airline=XX.
502
The airline rejected the quote.
POST /v1/orders/{orderID}/change — Quote a change