> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# General health check endpoint

> Operational endpoint for status, liveness, readiness, tool metadata, or function diagnostics.

Operational endpoint for status, liveness, readiness, tool metadata, or function diagnostics.

### Response

`HealthResponse`

<ResponseField name="activeSessions" type="integer" required>
  Number of active voice sessions
</ResponseField>

<ResponseField name="audioProviderFallback" type="boolean" required>
  Whether runtime is currently falling back from configured provider
</ResponseField>

<ResponseField name="configuredAudioOutputProvider" type="string" required>
  Configured per-tenant audio output provider (`openai` or `elevenlabs`)
</ResponseField>

<ResponseField name="effectiveAudioOutputProvider" type="string" required>
  Effective provider after runtime fallback checks
</ResponseField>

<ResponseField name="elevenlabsConfigured" type="boolean" required>
  Whether ElevenLabs credentials are configured for this tenant
</ResponseField>

<ResponseField name="elevenlabsReady" type="boolean" required>
  Whether ElevenLabs service initialized successfully for this tenant
</ResponseField>

<ResponseField name="ok" type="boolean" required>
  Service status
</ResponseField>

<ResponseField name="org_id" type="string,null">
  Organization ID
</ResponseField>

<ResponseField name="tenant" type="string" required>
  Tenant identifier
</ResponseField>

<ResponseField name="tools" type="integer" required>
  Number of registered tools/functions
</ResponseField>

<ResponseField name="uptime" type="integer (int64)" required>
  Server uptime in seconds
</ResponseField>

### Status codes

| Code  | Meaning        |
| ----- | -------------- |
| `200` | Service health |
| `401` | Unauthorized   |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.voice.stateset.com/health' \
    --header 'Authorization: Bearer YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "activeSessions": 3,
    "audioProviderFallback": false,
    "configuredAudioOutputProvider": "elevenlabs",
    "effectiveAudioOutputProvider": "elevenlabs",
    "elevenlabsConfigured": true,
    "elevenlabsReady": true,
    "ok": true,
    "org_id": "org-456",
    "tenant": "tenant_acme_dental",
    "tools": 15,
    "uptime": 3600
  }
  ```
</ResponseExample>