System
Health check
Quick connectivity test — no auth required, ideal for monitoring and load balancers.
GET
/v1/healthRequires X-API-KeyThe simplest endpoint in the API. Call it to verify the Norba gateway is up and accepting connections.Returns a plain
- Uptime monitors (Better Stack, Pingdom, Datadog)
- Load-balancer health checks
- CI/CD smoke testsImportant: A 200 response confirms the gateway process is running and the HTTP stack is functional, but does not validate downstream airline connectivity.
{"status":"ok"} with HTTP 200 when healthy. This is the only endpoint that does not require an API key, making it safe to use in:- Uptime monitors (Better Stack, Pingdom, Datadog)
- Load-balancer health checks
- CI/CD smoke testsImportant: A 200 response confirms the gateway process is running and the HTTP stack is functional, but does not validate downstream airline connectivity.
Request example
curl --request GET \
--url https://api.norba.io/v1/health \
--header "X-API-Key: $NORBA_KEY"Response example
Response example
{
"status": "ok"
}Authorization
X-API-KeystringRequiredOpaque 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.Response fields
statusstringRequiredAlways
ok when the service is healthy.