Skip to main content
GET
/
v1
/
usage
Summarize usage
curl --request GET \
  --url https://api.visor.vin/v1/usage \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "date": "2026-06-09",
      "metering_class": "listing_search",
      "requests": 1,
      "charged_micros": 2000
    }
  ],
  "totals": {
    "requests": 1,
    "charged_micros": 2000
  },
  "meta": {
    "start_date": "2026-05-11",
    "end_date": "2026-06-09",
    "interval": "day",
    "currency": "USD",
    "source": "public_api_usage_events",
    "freshness": "Usage analytics are eventually consistent with the billing ledger."
  }
}

Authorizations

Authorization
string
header
required

Send API keys as Authorization: Bearer <api_key>. Query-string API keys are rejected.

Query Parameters

start_date
string

Inclusive UTC start date in YYYY-MM-DD format. Defaults to 29 days before end_date.

end_date
string

Inclusive UTC end date in YYYY-MM-DD format. Defaults to today.

metering_class
string

Optional comma-separated metering classes to include.

Response

Successful public API response.

Public API usage summary response envelope.

data
object[]
required

Daily usage buckets ordered by date and metering class.

totals
object
required
meta
object
required