API REFERENCE

`GET /v1/health`

Endpoint status check. Used by load balancers, uptime monitors, and deployment smoke tests. Authentication is optional — works with or without a bearer token.

Request

GET /v1/health

Response — 200 OK

{
  "status": "ok"
}

A 200 response indicates the API process is up and able to accept requests. It does not indicate that the embedding model is warm, that downstream storage is reachable, or that validation succeeds — those are observed only on a real /v1/verify call.

Operational note

For deeper status — model warm-up, gate latency percentiles, anti-spoof scorer health — your dashboard surfaces real-time telemetry. /v1/health is intentionally minimal so it stays fast and safe to hit at high frequency.