# Live health of every endpoint

Status

GET `/status.json`

Public, no API key. `status` is health from the scheduled canaries: an endpoint is degraded after repeated failed runs and healthy again after several passes; unknown until first checked, and again when the canary has not run recently. `success_rate` is the share of customer requests in the last `success_rate_window_minutes` that got an answer, measured where every request ends (failures on SocialTap's side, including capacity refusals, count against it; requests refused for credits or rate do not count), rounded down; null when there was too little traffic. Cached for 60 seconds.

## Example

cURL:

```shell
curl 'https://socialtap.dev/status.json'
```

## Authorizations

No API key: anyone may call it.

## Response

### 200

Health document

| Field | Type | Description |
| --- | --- | --- |
| `endpoints` | `object[]` |  |
| `endpoints[].id` | `string` |  |
| `endpoints[].last_checked` | `string` (date-time) or `null` |  |
| `endpoints[].measured` | `object` or `null` | Requests, success rate and latency between measured_from and measured_to; null when the endpoint had fewer than measured_min_requests requests. |
| `endpoints[].measured.check_requests` | `integer` | Of requests, how many were our own scheduled checks. |
| `endpoints[].measured.p50_ms` | `integer` or `null` | Median time the engine took for a successful answer, ms; null when none was timed. |
| `endpoints[].measured.p95_ms` | `integer` or `null` | 95th percentile of that time, ms; null when none was timed. |
| `endpoints[].measured.requests` | `integer` | Requests measured: customer requests plus scheduled checks. |
| `endpoints[].measured.success_rate` | `number` | Share of requests that succeeded (0..1, rounded down). |
| `endpoints[].since` | `string` (date-time) or `null` |  |
| `endpoints[].status` | `string` | Canary health; unknown until first checked, or when the canary has not run recently.<br>One of `healthy`, `degraded`, `unknown` |
| `endpoints[].success_rate` | `number` or `null` | Real-traffic success rate over the window (0..1, rounded down); null when there was too little traffic. |
| `environment` | `string` |  |
| `generated_at` | `string` (date-time) |  |
| `measured_from` | `string` (date-time) or `null` | Start of every endpoint's measured window; null until the measurement has run. |
| `measured_min_requests` | `integer` | Fewest requests an endpoint needs in the window for its measured numbers to be published. |
| `measured_to` | `string` (date-time) or `null` | End of every endpoint's measured window; null until the measurement has run. |
| `success_rate_window_minutes` | `integer` | Window of every endpoint's success_rate. |

operationId `status.get`

---

[HTML version](https://socialtap.dev/docs/reference/status/get/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)