Norba.ioAPI reference
LandingOverviewGet API key
Endpoint coming soon

The Orders API is under active development and not yet available in production. Reference-data endpoints (airlines, airports, aircraft types) are live. Sign up below to be notified when this endpoint ships.

Orders

Create order

Book a priced offer and receive a canonical PNR / OrderID.

POST/v1/ordersRequires X-API-Key

Submits passenger details and payment instructions against a priced offer. Returns the canonical `models.Order` plus the airline-issued PNR and OrderID. A `order.confirmed` webhook fires immediately on success.

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_idstringRequired

ID returned by /v1/offers/price.

travelersarray<Traveler>Required

Passenger details — name, DOB, document.

contactobjectRequired

Email and phone for the lead traveler.

paymentobject

Payment instructions (card token, account, etc.).

Error codes

offer_expired

Offer expired before order creation.

payment_declined

Payment processor rejected the charge.

airline_unavailable

Connector down or circuit breaker open.