# Health, latency and data freshness

`GET /api/v1/status/data`

- Authentication: No authentication
- Billing: Free.
- Group: Status

The facts behind the public status page, without authentication: `ok` (the service answered and its databases are readable), the sync date and range counts of every dataset behind email and IP lookups, and measured API latency per endpoint group over the last hour and the last 24 hours. Point a monitor at it, or read it before a big run to know how fresh the feeds are. Throttled at 60 requests per minute per IP.

## Example request

```bash
curl https://spaw.co/api/v1/status/data
```

## Responses

### 200 — The current status.

```json
{
    "success": true,
    "data": {
        "ok": true,
        "checked_at": "2026-09-04T18:00:00+00:00",
        "datasets": [
            {
                "dataset": "dbip-city-lite",
                "version": "2026-08-01",
                "installed": true
            },
            {
                "dataset": "datacenter-ranges",
                "version": "2026-09-04",
                "installed": true,
                "feeds": 12
            }
        ],
        "latency": [
            {
                "group": "ip",
                "window": "1h",
                "p50_ms": 2,
                "p95_ms": 6,
                "sample": 812
            },
            {
                "group": "email",
                "window": "1h",
                "p50_ms": 410,
                "p95_ms": 2100,
                "sample": 1204
            }
        ]
    }
}
```

### 429 — Over 5 requests per second for the key. Retry after the limit resets.

```json
{
    "success": false,
    "error": {
        "code": "RATE_LIMITED",
        "message": "Too many requests. Retry after the limit resets.",
        "request_id": "req_01m1kgdm4xngzmbmff68g94w0c"
    }
}
```

## Error codes

- `RATE_LIMITED` — https://spaw.co/docs/errors/RATE_LIMITED

---

Canonical page: https://spaw.co/docs/api/get-data-status · OpenAPI document: https://spaw.co/openapi.json · All endpoints: https://spaw.co/docs/api