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

# Status

> Check public API health before retrying scraper work.

Use status endpoints to distinguish Tovuk API availability from a scraper
request failure.

```sh theme={"dark"}
curl https://api.tovuk.com/health
curl https://api.tovuk.com/healthz
curl https://api.tovuk.com/v1/status
tovuk scraper health --json
```

`/health` is the simple public health alias. `/healthz` is the readiness probe.
`/v1/status` returns structured availability state, stable public identifiers,
per-check `latency_ms` and `latency_us`, optional non-secret diagnostic
metadata, `agent_instruction`, and docs links. Use `latency_us` for fast probes
that round down to `latency_ms: 0`. A check `message` is `reachable`,
`unavailable`, or `timed_out`. `tovuk scraper health --json` returns
data-source readiness for high-count public-data work without exposing service
topology or provider configuration.

When the CLI cannot reach the API, it returns `api_unreachable` with a status
docs URL. Retry once, then check `/v1/status` before changing scraper inputs.