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

# Check the health of microservice

`GET /v1/health`

## Request

- Base URL: `http://localhost:9001`
- URL: `http://localhost:9001/v1/health`
- Auth: none required

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.dev/qualcomm/apis/llm-vlm-genai-microservice-apis.md) - [All operations](https://skmtc.dev/qualcomm/apis/llm-vlm-genai-microservice-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/qualcomm/apis/llm-vlm-genai-microservice-apis/revisions/8557fe985a5e?raw)
