---
title: "Health"
method: GET
path: "/health"
tags: ["System"]
---

# Health

`GET /health`

## Request

- Base URL: `https://api.markmesh.com/v1`
- URL: `https://api.markmesh.com/v1/health`
- Auth: none required

Returns 200 OK with `{status, api_version, timestamp}`. Public, no auth required. Suitable for uptime monitors — no DB hit, no rate-limit.

## Response `200`

Service is alive

- object
  - `api_version` string, required: The major API version this endpoint belongs to. Currently always `"v1"`; a future breaking change would ship under `"v2"` at a separate base path, and this field would let monitors detect the version they're hitting.
  - `status` 'ok', required: Always `"ok"` when the response reaches the caller. The endpoint is a liveness probe: if the API can answer at all, it answers `ok`. An unreachable service returns no JSON body (connection refused or upstream 5xx).
  - `timestamp` string, date-time, required

---

[API](https://skmtc.dev/markmesh/apis/markmesh-api.md) · [All operations](https://skmtc.dev/markmesh/apis/markmesh-api/llms.txt) · [OpenAPI document](https://skmtc.dev/markmesh/apis/markmesh-api/revisions/87d08d2479ee?raw)