---
title: "Check the health of microservice"
method: GET
path: "/v1/health"
tags: ["Health"]
---

# Check the health of microservice

`GET /v1/health`

Health check for container orchestration (Docker Swarm / Kubernetes). Returns HTTP 200 when healthy, HTTP 503 when unhealthy. Unhealthy conditions: any model has >= 3 consecutive inference failures (DSP/FastRPC fault), or available system memory < 100 MB.

## Response `200`

Service is healthy

- HealthResponse — Health check response for container orchestration.
  - `status` 'healthy' | 'unhealthy', required — Overall health status of the service.
  - `reason` string — Present only when status is "unhealthy". Describes the reason for the unhealthy state.

## Other responses

- `503` — Service is unhealthy

---

[API](https://skmtc.net/qualcomm/apis/llm-vlm-genai-microservice-apis.md) · [All operations](https://skmtc.net/qualcomm/apis/llm-vlm-genai-microservice-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qualcomm/llm-vlm-genai-microservice-apis/revisions/8557fe985a5e/schema)