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.

Shopping endpoints in development

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

Shopping

Price offer

Lock in a price before booking — essential step between search and purchase.

POST/v1/shopping/offers/priceRequires X-API-Key

Airline prices fluctuate constantly. Before you present a final price to your customer and collect payment, call this endpoint to lock the offer.It confirms the current price directly with the airline and returns a price_guaranteed_until timestamp — typically 5 to 15 minutes into the future.The booking flow:
- Search offers → Price-lock → Create order
- You must create the order (POST /v1/orders) before the lock window closes
- If the window expires, call this endpoint again for a fresh price lockThis two-step flow protects both you and your customer from surprise price changes at checkout.

Request example

curl --request POST \
  --url https://api.norba.io/v1/shopping/offers/price \
  --header "X-API-Key: $NORBA_KEY" \
  --header "Content-Type: application/json" \
  --data '{ "offer_ids": ["aa_offer-abc123"] }'

Response example

{
  "offer_id": "aa_offer-abc123",
  "airline": "AA",
  "currency": "EUR",
  "total_amount": 249,
  "base_fare": 199,
  "taxes_fees": 50,
  "cabin_class": "economy",
  "price_guaranteed_until": "2026-06-20T14:45: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.

Request body

offer_idsarray<string>Required

Offer IDs from a shopping response.

Example: ["aa_offer-abc123"]

Error codes

offer_expired

The offer is no longer available.

price_changed

The price has changed since the shopping response.