Read this month's usage

THE CALL, PART BY PART

method

GET

host

strait.link

version

/v1

resource

/usage

GET /v1/usage

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

Request

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).

No parameters.

Response

  • 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
Request · curl
curl -X GET https://strait.link/v1/usage \
  -H "Authorization: Bearer $SECRET_KEY"

The response, printed

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