Orders endpoints in development

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

Orders

List orders

Browse all your agency's bookings — filter by status, airline, or date.

GET/v1/ordersRequires X-API-Key
Returns a paginated list of all orders created by your API key, ordered newest first.Filter by:
- statuspending, confirmed, ticketed, cancelled

- airline — IATA carrier code (e.g. EI, BA)

- Date range — Created between two dates
Each order in the list includes essential fields: order_id, airline, status, total price, and creation date. Use this to build an orders dashboard, generate booking reports, or reconcile daily activity.

Request example

curl --request GET \
  --url https://api.norba.io/v1/orders \
  --header "X-API-Key: $NORBA_KEY"

Response example

Response example
{
  "orders": [
    {
      "order_id": "ord_01...",
      "airline": "AA",
      "status": "ticketed",
      "total_price": {
        "amount": 249,
        "currency": "EUR"
      }
    }
  ],
  "meta": {
    "page": 1,
    "limit": 50,
    "total": 42
  }
}

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.

Query parameters

statusstring
Filter: pending, confirmed, ticketed, cancelled.
airlinestring
IATA airline code.
Example: AA
pageinteger
1-based page.
limitinteger
Page size (max 100).
List orders · Norba API