> ## Documentation index
> Fetch the complete documentation index at: https://docs.leadmcp.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Health check

`GET /health`

Returns the service state, the build id and the month the current data was loaded. No row totals. Free.

Returns the service state, the build id and the month the current data was loaded. No row totals. Free.

Cost: Free.

## Response

- `status` | enum | required. The state of the service. The list is frozen. Values: `ok`, `degraded`, `unavailable`.
- `release` | string | required. The build id currently serving.
- `data_loaded` | YearMonth | required. The month of the current data load.

## Failures

| Status | Meaning |
| --- | --- |
| `401` | The credential is missing, unknown or revoked. |
| `429` | The key passed 300 requests a minute or 2 concurrent requests. |
| `503` | The data is unavailable for a short time. |

## Example

```bash
curl -sS "https://api.leadmcp.ai/v1/health" \
  -H "Authorization: Bearer lm_live_YOUR_API_KEY" \
  -H "LeadMCP-Version: 2026-09-19"
```

Response `200`:

```json
{
  "ok": true,
  "request_id": "req_01JBQ2W8K9V6M3T0X5Y7Z4A1BC",
  "release": "b_2026_09_15",
  "data": {
    "status": "ok",
    "release": "b_2026_09_15",
    "data_loaded": "2026-08"
  },
  "quota": {
    "plan": "free",
    "contact_credits_used": 50,
    "month_remaining": 950,
    "today_remaining": 950,
    "binding": "month",
    "resets_at": "9999-12-31T23:59:59.000Z"
  },
  "warnings": []
}
```