# Read this month's usage

Source: https://straitlink.in/docs/api/get-usage/

`GET /v1/usage`

Auth: secret key as Authorization: Bearer. Server-side only.

Where your workspace stands against its plan this calendar month (UTC): billed taps and new links, and what the plan includes (null = no limit). `level` is ok, warn from 80 % of the included taps, over from 100 %. Over your plan, links and deferred matching keep working: nothing here ever stops a redirect. `new_links_paused` is true at twice the included taps or at the plan's new-link limit; creating a link then answers 402 until you upgrade or the month ends. Secret key only (a publishable key gets 401); 30 calls a minute per workspace (429 with Retry-After).

```bash
curl -X GET https://strait.link/v1/usage \
  -H "Authorization: Bearer $SECRET_KEY"
```

Response 200:

```json
{
  "month": "2026-10",
  "plan": "free",
  "taps": {
    "used": 21400,
    "included": 25000
  },
  "links": {
    "created": 14,
    "included": 100
  },
  "level": "warn",
  "new_links_paused": false
}
```

- `200`: This month's usage, the plan and the over-limit flags.
- `401`: Missing or invalid secret key, or a publishable key
- `429`: Over 30 calls a minute for this workspace