Docs / Your usage

Your usage

Last updated 2026-11-13

Your key's usage this month, your limit and the reset date.

GET/v1/usage · API key required

Returns how many requests the key has used this month, the monthly limit, how many are left, and when the count resets. Calling this endpoint does not count against your quota and is not part of the fair-use checks, and it still answers when the quota is used up.

Request

curl https://recalldb.app/v1/usage \
  -H "Authorization: Bearer $RECALLDB_KEY"

const res = await fetch('https://recalldb.app/v1/usage', {
  headers: { Authorization: `Bearer ${process.env.RECALLDB_KEY}` },
})
const { data, source } = await res.json()
console.log(data, source.official_url)

import os, requests

r = requests.get("https://recalldb.app/v1/usage", headers={"Authorization": f"Bearer {os.environ['RECALLDB_KEY']}"})
r.raise_for_status()
body = r.json()
print(body["data"], body["source"]["official_url"])

Response

{
  "data": {
    "key_id": "8f32c2ee",
    "plan": "free",
    "period": "2026-11",
    "used": 120,
    "limit": 1000,
    "remaining": 880,
    "resets_at": "2026-12-01T00:00:00.000Z",
    "burst_limit_per_minute": 60,
    "key_status": "active"
  },
  "attribution": {
    "text": "Data from RecallDB",
    "url": "https://recalldb.app"
  }
}

Every response includes source (agency, official ID, official URL, last updated) and attribution. Attribution rules.

Notes

• The same numbers are in the X-RateLimit-* headers of every keyed response.

Errors: error codes. Limits: rate limits.