Health & status

API reference

Unauthenticated endpoints for liveness and platform status.

Liveness check

GET/healthcheckno auth

Returns {"status": "ok"} when the API process is up. No authentication.

Responses

Status	Description	Body
200	Successful Response	object

curl

curl -X GET "https://acme.aiotic.ai/healthcheck"

Python SDK

client.health()                      # HealthCheck(status='ok')

Platform status

GET/system-statusno auth

Current processing status of the tenant: operational, degraded or unknown, with an optional message and the time it was last updated. No authentication. Suitable for a status widget or for pausing uploads while degraded.

Responses

Status	Description	Body
200	Current status	SystemStatus

curl

curl -X GET "https://acme.aiotic.ai/system-status"

Python SDK

st = client.system_status()          # SystemStatus(status='operational', message=None, updated_at=…)

Response

{
  "status": "operational",
  "message": null,
  "updated_at": "2026-04-01T06:03:20+00:00"
}