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.

Servicing endpoints in development

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

Servicing

Add ancillaries

Add bags, meals, lounge access, Wi‑Fi and more to an existing booking.

POST/v1/orders/{orderID}/ancillariesRequires X-API-Key

Enhance an order with additional services after the initial booking.Common scenarios:
- Traveler decides to check a bag after booking
- Add an in-flight meal for a long-haul flight
- Purchase lounge access for a long layover
- Add Wi‑Fi for a business traveler
- Bring sports equipment or a petProvide a list of service_id values (from the service catalogue at POST /v1/shopping/services) paired with passenger_id to specify who gets each service. The response includes the **updated total_price** reflecting all additions.Ancillaries can be added up until the service cutoff time set by the airline — typically 24–72 hours before departure.

Request example

curl --request POST \
  --url https://api.norba.io/v1/orders/{orderID}/ancillaries \
  --header "X-API-Key: $NORBA_KEY" \
  --header "Content-Type: application/json" \
  --data '{ "ancillaries": [{ "service_id": "svc-checked-bag", "passenger_id": "pax1" }] }'

Response example

{
  "order_id": "ord_01...",
  "total_price": {
    "amount": 294,
    "currency": "EUR"
  }
}

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

Order ULID.

Request body

ancillariesarrayRequired

Services to add: Array of {service_id, passenger_id} objects. service_id comes from POST /v1/shopping/services.