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

Refund order

Request a refund quote — see what you'll get back before cancelling.

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

Before cancelling a booking, call this endpoint to get a clear financial picture of the outcome.Returns a CancellationQuote with:
- Refundable amount — What the traveler gets back
- Penalty amount — Airline cancellation fee
- Quote validity — How long this quote is validFare refundability varies:
- Fully refundable fares → Most or all money back
- Partially refundable → Refund minus penalty
- Non-refundable fares → No refund (but cancellation still releases the seat)Present this breakdown to the traveler so they can make an informed decision. To actually cancel, call DELETE /v1/orders/{orderID} after the traveler accepts the quote.

Request example

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

Response example

{
  "quote_id": "qte_01...",
  "order_id": "ord_01...",
  "refund_amount": {
    "amount": 199,
    "currency": "EUR"
  },
  "penalty_amount": {
    "amount": 50,
    "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...

Error codes

non_refundable

The fare is non-refundable.