Skip to main content
GET
/
v1
/
usage
Get Usage
curl --request GET \
  --url https://api.example.com/v1/usage
{
  "object": "usage",
  "billing_period": {
    "start": "2026-03-01T00:00:00Z",
    "end": "2026-03-31T23:59:59Z"
  },
  "searches": {
    "used": 0,
    "limit": null
  },
  "lookups": {
    "used": 0,
    "limit": null
  },
  "rate_limit": {
    "remaining": 994,
    "resets_at": "2026-03-25T12:30:00Z"
  },
  "livemode": true,
  "request_id": "req_abc123"
}
The usage endpoint currently returns placeholder data. Detailed per-endpoint and per-day breakdowns are planned for a future release when Stripe Billing Meters integration is complete.

​
Overview

Returns API usage statistics for the current billing period, including rate limit status and quota utilization.

​
Response

​
object
string
Always "usage"
​
billing_period
object
​
searches
object
​
lookups
object
​
rate_limit
object
​
livemode
boolean
Whether this is live data
​
request_id
string
Request ID for debugging
{
  "object": "usage",
  "billing_period": {
    "start": "2026-03-01T00:00:00Z",
    "end": "2026-03-31T23:59:59Z"
  },
  "searches": {
    "used": 0,
    "limit": null
  },
  "lookups": {
    "used": 0,
    "limit": null
  },
  "rate_limit": {
    "remaining": 994,
    "resets_at": "2026-03-25T12:30:00Z"
  },
  "livemode": true,
  "request_id": "req_abc123"
}

​
Code Examples

curl "https://api.signa.so/v1/usage" \
  -H "Authorization: Bearer sig_live_xxxxxxxxxxxx"

​
Errors

StatusTypeDescription
401unauthorizedMissing or invalid API key
429rate_limitedToo many requests