GET /v1/usage

Return usage metadata for the current API key.

This endpoint is intended for self-service API keys and powers account dashboards and lightweight usage inspection.

Request

GET /v1/usage
x-api-key: YOUR_API_KEY

Response

200 OK

{
  "summary": {
    "totalRequests": 42,
    "totalRateLimited": 1,
    "endpointCount": 4,
    "hasUsage": true,
    "lastUsedAt": "2026-04-14T08:31:12.000Z",
    "lastUsedPath": "/v1/quote",
    "lastUsedIp": "203.0.113.10",
    "lastRateLimitedAt": null,
    "lastRateLimitedPath": null,
    "lastRateLimitedIp": null
  },
  "endpoints": [
    {
      "endpoint": "/v1/quote",
      "totalRequests": 20,
      "totalRateLimited": 0,
      "lastUsedAt": "2026-04-14T08:31:12.000Z"
    }
  ]
}

Errors

Status	Description
401	Missing or invalid API key
429	Rate limit exceeded

Rate Limit

See Plans & Rate Limits.