GET /v1/usage

Returns today's UTC request count and daily limit per endpoint bucket for the authenticated account.

Authentication

Accepts either header — no API key required if you have a JWT:

• X-API-Key: scrf_your_key
• Authorization: Bearer <jwt>

This endpoint does not consume any quota bucket.

Response

{
  "date": "2026-04-15",
  "tier": "pro",
  "endpoints": {
    "svg":     { "used": 142, "limit": 2000 },
    "png":     { "used": 0,   "limit": 2000 },
    "webp":    { "used": 0,   "limit": 2000 },
    "catalog": { "used": 89,  "limit": 2000 },
    "search":  { "used": 12,  "limit": 300  },
    "domain":  { "used": 3,   "limit": 300  },
    "batch":   { "used": 1,   "limit": 2000 }
  }
}

Field	Type	Description
date	string	UTC date YYYY-MM-DD
tier	string	free, pro, enterprise, or internal
endpoints	object	Bucket name → { used, limit }
used	integer	Requests made today on this bucket
limit	integer | null	Daily cap. null = unlimited

Endpoint buckets

Bucket	Endpoint
svg	GET /v1/svg/{slug}
png	GET /v1/png/{slug}
webp	GET /v1/webp/{slug}
catalog	GET /v1/catalog/{slug}
search	GET /v1/search
domain	GET /v1/brand
batch	POST /v1/catalog/batch

Errors

Status	Code	Reason
401	invalid_api_key	Missing or invalid credentials
500	internal_error	Valkey read failure