Getting started · Sandbox
Testing in sandbox
Every account starts in the sandbox: the same host, endpoints, schema and errors as production, against the airlines' test systems.
Sandbox keys
- A
nbr_test_key runs every request in the sandbox; anbr_live_key in production. Both callhttps://api.norba.io. - Orders and webhooks never cross: an order from the other environment answers
404. Orders carryenvironment, webhooksX-Norba-Environment. - Sandbox orders are test bookings. No real ticket is issued.
Test card
Pay sandbox orders with this card in payment.card:
| Field | Value |
|---|---|
| number | 4111111111111111 |
| expiry_month, expiry_year | Any date in the future. |
| cvv | Any three digits, or omit it. |
What it costs
Sandbox bookings and servicing raise no fee. Requests count against your free allowance and are metered as in production: see Pricing.
Suggested routes
Search 2 to 8 weeks ahead. GET /v1/aviation/airlines/{id}/routes lists every route an airline publishes.
| Airline | Try | Notes |
|---|---|---|
| Aegean Airlines (A3) | ATH–JTR, or a route from Athens (ATH) to Europe or the Middle East | Airline page |
| American Airlines (AA) | BCN–JFK, or a route through Dallas/Fort Worth (DFW) | Airline page |
| Olympic Air (OA) | A Greek domestic route from Athens (ATH) | Comes back as Aegean offers. Airline page |
A full test
- Search:
POST /v1/shopping/offers. - Price the offer you pick:
POST /v1/offers/price. - Book it as a hold (no
payment), then pay it withPOST /v1/orders/{orderID}/commit; or book and pay in one call. - Add a seat or a bag, then quote and confirm a change or a cancellation: see Servicing.
- Check your webhooks received each event.
Going live
- In the dashboard, open Go live: company details, incorporation and tax documents, and your signature on the production agreement.
- Norba reviews the request. Your sandbox keeps working throughout.
- Once approved, create a production key under API keys and swap it in.
- An airline that needs its own agreement answers
403 carrier_agreement_requireduntil it approves; Go live shows its state.