Skip to main content
GET
/
api
/
v1
/
health
Health Check
curl --request GET \
  --url https://api.example.com/api/v1/health
{
  "status": "<string>",
  "timestamp": "<string>",
  "version": "<string>",
  "providers": {}
}
Public endpoint that returns the current health status of Theo’s infrastructure and AI engine subsystems. No authentication required.
Health check results are cached for 30 seconds. The X-Cache header indicates HIT or MISS.

​
Request Example

curl https://www.hitheo.ai/api/v1/health

​
Response

​
status
string
Overall system status: "healthy", "degraded", or "down".
​
timestamp
string
ISO 8601 timestamp of the health check.
​
version
string
API version identifier (e.g., "2026-03-28").
​
providers
object
AI engine subsystem health.

​
Example Response

{
  "status": "healthy",
  "timestamp": "2026-04-10T12:00:00.000Z",
  "version": "2026-03-28",
  "providers": {
    "theo-core": { "status": "healthy" },
    "theo-vision": { "status": "healthy" },
    "theo-search": { "status": "healthy" }
  }
}

​
Status Codes

StatusMeaning
200System is healthy or degraded
503System is down — Retry-After: 30 header included