---
title: "Comprehensive Readiness Check"
method: GET
path: "/api/v1/readiness"
tags: ["health", "Health"]
---

# Comprehensive Readiness Check

`GET /api/v1/readiness`

Comprehensive readiness probe that checks all critical dependencies with timeouts.
    
    This endpoint verifies:
    - Redis connectivity and performance
    - Azure OpenAI client health
    - Speech services (TTS/STT) availability
    - ACS caller configuration and connectivity
    - RT Agents initialization
    - Authentication configuration (when ENABLE_AUTH_VALIDATION=True)
    - Event system health
    
    When authentication validation is enabled, checks:
    - BACKEND_AUTH_CLIENT_ID is set and is a valid GUID
    - AZURE_TENANT_ID is set and is a valid GUID  
    - ALLOWED_CLIENT_IDS contains at least one valid GUID
    
    Returns 503 if any critical services are unhealthy, 200 if all systems are ready.

## Response `200`

All services are ready

- ReadinessResponse — Comprehensive readiness check response model.
  - `status` 'ready' | 'not_ready' | 'degraded', required — Overall readiness status
  - `timestamp` number, required — Timestamp when check was performed
  - `response_time_ms` number, required — Total time taken for all checks in milliseconds
  - `checks` ServiceCheck[], required — Individual component health checks
    - `component` string, required — Name of the component being checked
    - `status` 'healthy' | 'unhealthy' | 'degraded', required — Health status of the component
    - `check_time_ms` number, required — Time taken to perform the check in milliseconds
    - `error` string, nullable — Error message if check failed
    - `details` string, nullable — Additional details about the check
  - `event_system` object, nullable — Event system status information

## Other responses

- `503` — One or more services are not ready

---

[API](https://skmtc.net/azure/apis/real-time-voice-agent-api.md) · [All operations](https://skmtc.net/azure/apis/real-time-voice-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/real-time-voice-agent-api/revisions/3e24c76dccd5/schema)