What is NDC and why do I need an aggregator?

NDC (New Distribution Capability) is IATA's XML messaging standard for selling airline products. Every airline implements it differently. An aggregator gives you one integration that handles all those quirks.

How does pricing work?

You pay per request for data lookups (€0.01/request, first 50 free each month) and transaction fees when bookings, seats, or ancillaries are completed.

Orders endpoints in development

The Orders API endpoints are currently under active development. Request/response shapes may change.

Orders

Retrieve order

Look up any order by its Norba ID — check status, PNR, tickets, and history.

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

Fetch the full current state of any order you've created. Returns the canonical order object with all key information:
- PNR — The 6-character code travelers use at check-in
- Status — confirmed, ticketed, cancelled
- Fare details — Price breakdown, fare rules, ticket numbers
- Passenger information — Names, documents, assigned seats
- Timestamps — Created, ticketed, last modifiedSafe to poll — responses are served from Norba's local replica, not the airline, so there's no rate-limiting concern. Use this to power an order confirmation page, a "My Trips" dashboard, or to poll for status changes after payment.

Request example

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

Response example

{
  "order_id": "ord_01HVN9M5K...",
  "airline_order_id": "ABC123",
  "pnr": "X7Y8Z9",
  "status": "ticketed",
  "total_price": {
    "amount": 542.1,
    "currency": "GBP"
  },
  "travelers": [
    {
      "given_name": "Ada",
      "family_name": "Lovelace"
    }
  ],
  "created_at": "2026-05-15T10:31:42Z",
  "ticketed_at": "2026-05-15T10:31:58Z"
}

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

Internal ULID issued by Norba.

Example: ord_01HVN9M5K...