---
title: "Health check"
method: GET
path: "/v2/liveness"
tags: ["liveness"]
---

# Health check

`GET /v2/liveness`

Check if the Unkey API service is healthy and ready to handle requests.

Use this for load balancer health checks, monitoring systems, and orchestration platforms. No authentication required with minimal processing overhead.

**Required Permissions**

None - this endpoint requires no authentication.

**Side Effects**

None - this is a read-only health check that does not modify any data or state.

## Response `200`

Service is healthy and ready to process requests. Returns 'OK' message for normal operation.

- V2LivenessResponseBody
  - `meta` Meta, required — Metadata object included in every API response. This provides context about the request and is essential for debugging, audit trails, and support inquiries. The `requestId` is particularly important when troubleshooting issues with the Unkey support team.
    - `requestId` string, required — A unique id for this request. Always include this ID when contacting support about a specific API request. This identifier allows Unkey's support team to trace the exact request through logs and diagnostic systems to provide faster assistance.
  - `data` V2LivenessResponseData, required — Response data for the liveness check endpoint. This provides a simple indication of whether the Unkey API service is running and able to process requests. Monitoring systems can use this endpoint to track service availability and trigger alerts if the service becomes unhealthy.
    - `message` string, required — Status message indicating the health of the service. A value of 'OK' indicates that the service is functioning properly and ready to accept requests. Any other value indicates a potential issue with the service health.

## Other responses

- `412`
- `500` — Service is unhealthy and unable to process requests properly. Significant service issue requiring immediate attention.

---

[API](https://skmtc.net/unkeyed/apis/unkey-api.md) · [All operations](https://skmtc.net/unkeyed/apis/unkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unkeyed/unkey-api/versions/fa78aafac89c/schema)