Skip to main content
GET
GET /v1/usage/history Time series of the calling key’s requests and credits over the last days days, bucketed at 15m, 1h, 6h or 1d: the graph of a usage dashboard. Free: never billed, and still reachable when the monthly credit allowance is exhausted. A key only ever sees its own usage.
Each point is { t, requests, credits }; t is the bucket start in unix seconds. Buckets without traffic are absent from the series.

Authorizations

Authorization
string
header
required

Your raw API key (not needed on the demo server).

Query Parameters

days
integer
default:30

1 to 90. Default 30.

Required range: 1 <= x <= 90
bucket
string
default:1d

15m, 1h, 6h or 1d (default). A bucket too fine for the range (more than about 2,200 points) is refused with 400: pick a coarser one.

Response

200

Standard { data, meta } envelope.