---
title: "Get Health Check Status"
method: GET
path: "/api/v1/health-checks"
tags: ["health-checks"]
---

# Get Health Check Status

`GET /api/v1/health-checks`

## Request

- The document declares no server URL.
- Auth: one of:
  - API key in header `Otari-Key`
  - API key in header `x-api-key`

The settings, the run in progress, and the latest finished run by provider and by offering.

## Response `200`

Successful Response

- HealthCheckStatus: The Health page: settings, the run in progress, and the latest finished run by provider.
  - `last_run` HealthCheckRunPublic, required: One pass over every offering.
    - `failed` integer, required
    - `finished_at` string, date-time, nullable, required
    - `id` string, required
    - `included_reasoning` boolean, required
    - `passed` integer, required
    - `started_at` string, date-time, required
    - `total` integer, required
  - `providers` ProviderHealthSummary[], required
    - `answered` integer, required
    - `history` ProviderHistoryPoint[], required: Every finished run in the last 24 hours, oldest first.
      - `answered` integer, required
      - `started_at` string, date-time, required
      - `total` integer, required
    - `provider` string, required
    - `status` 'ok' | 'degraded' | 'down', required
    - `top_error` string, nullable, required: The most common failure, with the model id taken out.
    - `top_error_count` integer, required
    - `total` integer, required
  - `results` HealthCheckResultPublic[], required
    - `checked_at` string, date-time, required
    - `error` string, nullable, required
    - `failed_runs` integer: How many runs in a row it has failed.
    - `failing_since` string, date-time, nullable: When a failing model's unbroken run of failures began, as far back as results are kept (48 hours). Null when it answered.
    - `latency_ms` integer, required
    - `provider` string, required
    - `selector` string, required
    - `status` 'pass' | 'fail' | 'skip', required
    - `status_code` integer, nullable, required
  - `running` HealthCheckRunPublic, required: One pass over every offering.
    - `failed` integer, required
    - `finished_at` string, date-time, nullable, required
    - `id` string, required
    - `included_reasoning` boolean, required
    - `passed` integer, required
    - `started_at` string, date-time, required
    - `total` integer, required
  - `settings` HealthCheckSettingsPublic, required: Whether the checks run, how often, and what they send.
    - `alert_emails` string[], required
    - `interval_minutes` integer, required
    - `max_tokens` integer, required
    - `next_run_at` string, date-time, nullable, required
    - `prompt` string, required
    - `reasoning_every_runs` integer, required
    - `reasoning_max_tokens` integer, required
    - `run_requested` boolean, required
    - `schedule_enabled` boolean, required

## Changes

- **2026-10-19** `885075367a96`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mozilla-ai/apis/otari/changes/api/v1/health-checks/get.md)

---

[API](https://skmtc.dev/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.dev/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc.dev/mozilla-ai/apis/otari/revisions/98fe156839e6?raw)