# Status

`GET https://api.serpkite.com/v1/status` · Credits: Free, no key

Public live status: request volume, success rate and p50/p95 latency per endpoint over the last hour.

No API key needed. This powers our [status page](https://serpkite.com/status) and is safe to poll from your own monitoring (once a minute is plenty).

## Example request

cURL:

```bash
curl https://api.serpkite.com/v1/status
```

TypeScript:

```ts
const res = await fetch("https://api.serpkite.com/v1/status"); // no key needed
const { status, endpoints } = await res.json();
console.log(status, endpoints.map((e) => `${e.endpoint} p95=${e.p95_ms}ms`));
```

## Response fields

| Field | Type | Description |
| --- | --- | --- |
| `status` | string | `operational` or `degraded`. |
| `window_minutes` | integer | Length of the measurement window (60). |
| `updated_at` | string | ISO 8601 timestamp of the snapshot. |
| `endpoints[]` | array | `endpoint`, `requests`, `success_rate` (0–1, share without a 5xx), `p50_ms`, `p95_ms`. |

## Example response

```json
{
  "status": "operational",
  "window_minutes": 60,
  "updated_at": "2026-09-29T08:00:00Z",
  "endpoints": [
    {
      "endpoint": "/v1/search",
      "requests": 18234,
      "success_rate": 0.994,
      "p50_ms": 1080,
      "p95_ms": 2210
    },
    {
      "endpoint": "/v1/news",
      "requests": 2210,
      "success_rate": 0.997,
      "p50_ms": 940,
      "p95_ms": 1890
    }
  ]
}
```

## Errors

| Status | Code | Meaning |
| --- | --- | --- |
| 400 | `invalid_request` | A parameter is missing or invalid. |
| 401 | `unauthorized` | The API key is missing, invalid or revoked. |
| 402 | `insufficient_credits` | Your balance is too low. Buy a pack or wait for the monthly free grant. |
| 429 | `rate_limited` | Too many requests per second for your plan. Retry after the Retry-After header. |
| 503 | `upstream_error` | Google could not be fetched or parsed. Not billed; retry after Retry-After. |

All errors: https://serpkite.com/docs/errors

## Notes

- Sample numbers are illustrative. Call the endpoint for live values.

## Related

- [Status page](https://serpkite.com/status)