Returns the calling customer’s lifetime API usage broken down by month and by country.
Usage is scoped automatically to the customer who owns the API key — there are no body, path, or query parameters that accept a customer identity. A caller can only see usage for the customer their key is bound to.
The response gives you three views of the same underlying data:
-
total_requests — the canonical lifetime total, computed as the sum of monthly[].request_count.
-
monthly — a per-month breakdown, sorted ascending by (year, month). Months with no recorded usage may be omitted.
-
by_country — a flat per-country breakdown across all time, sorted by request_count descending then country ascending.
Rate Limiting: This endpoint does not consume your monthly request quota — viewing your own usage is free.
Country codes in by_country are ISO 3166-1 alpha-2 (e.g., US, GB, IE)
API key authentication. Provide your API key in the Authorization header:Authorization: Bearer YOUR_API_KEYYou can also omit the “Bearer” prefix:Authorization: YOUR_API_KEY
Response
{
"customer_name": "www.customer.com",
"total_requests": 100,
"monthly": [
{
"year": 2026,
"month": 2,
"request_count": 100
},
{
"year": 2026,
"month": 3,
"request_count": 200
},
{
"year": 2026,
"month": 4,
"request_count": 300
},
{
"year": 2026,
"month": 5,
"request_count": 400
}
],
"by_country": [
{
"country": "GB",
"request_count": 700
},
{
"country": "US",
"request_count": 200
},
{
"country": "FR",
"request_count": 100
}
]
}
The name of your customer account
The total number of requests you have made to our API
An aggregation of the details of your requests by year, mount, and request count"monthly": [
{
"year": 2026,
"month": 2,
"request_count": 583
},
{
"year": 2026,
"month": 3,
"request_count": 14542
}
]
A list of all requests made by country"by_country": [
{
"country": "GB",
"request_count": 32895
}
]
