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

Change order

Modify a booked order — add bags, change seats, reissue tickets, or cancel segments.

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

Post-booking modifications happen through this single flexible endpoint driven by the action field.Supported actions:
- ancillaries — Add bags, meals, or other services
- seats — Assign or change seat selections
- ticketing — Reissue after changes
- reissue — Date/flight changes with fare difference calculation
- cancel_segments — Remove specific flights from the itinerary
- complete_payment — Incremental payment for added servicesThe response includes the updated order with new pricing. This is the endpoint behind any "Manage my booking" feature in your application.

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": "ancillaries", "ancillaries": [{ "service_id": "svc-checked-bag", "passenger_id": "pax1" }] }'

Response example

{
  "order_id": "ord_01...",
  "status": "confirmed",
  "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.

Example: ord_01HVN9M5K...

Request body

actionstringRequired

Change action type.

ancillariesarray

Ancillaries to add: [{service_id, passenger_id}].

seatsarray

Seats to assign: [{seat_id, passenger_id}].

paymentobject

Payment for paid changes.