API reference

GETAPI status

GET /v1/status: Unauthenticated liveness check (no database access).

GEThttps://api.light-ai.app/v1/status

Unauthenticated liveness check (no database access). HEAD works here and on every GET route (uptime monitors).

Credential	None (public).

Response 200#

The API is up.

objectstringrequired#

Always status.

okbooleanrequired#

Always true.

api_versionstringrequired#

Errors#

Status	Meaning
`400`	Bad request. `bad_request`, `test_mode_mismatch`, `test_mode_unsupported`, `unsupported_api_version`
`404`	Not found (also for objects of other organizations and for organizations without an active grant).
`422`	Validation failed. `idempotency_key_reused`
`429`	Rate limited or daily cap reached. See Retry-After and the RateLimit headers. `rate_limited`, `daily_cap_reached`
`500`	Unexpected server error. Safe to retry with exponential backoff; quote the Request-Id to support. `internal_error`
`503`	Temporarily unavailable. Retry with exponential backoff. `service_unavailable`

Request

curl -X GET "https://api.light-ai.app/v1/status"

const response = await fetch('https://api.light-ai.app/v1/status', {
  method: 'GET',
  headers: {
  },
});
const data = await response.json();

import os, uuid, requests

response = requests.get(
    "https://api.light-ai.app/v1/status",
    headers={
    },
    timeout=30,
)
data = response.json()

Response 200JSON

{
  "object": "status",
  "ok": true,
  "api_version": "2026-11-01"
}