24-hour request volume, rate-limit hits, and currently-configured limits for the calling partner system.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Partner self-service visibility
Returns a 24-hour rolling summary of API calls made by the calling registered system, plus the currently-configured rate limits. Use this in place of scraping per-response
X-RateLimit-...headers when you want a wider view than the most-recent request.
Authentication
Requires valid
X-SystemandX-System-Keyrequest headers.
Cache window
The response is cached server-side for 30 seconds. Frequent polling within that window returns identical data — design your client to poll at most once per minute.
Limiter attribution not included
This response totals all rate-limited requests but does not break them down by which limiter (global, per-route, per-account) triggered.
Response
The aggregate window is exactly the last 24 hours, bucketed hourly. Per-hour buckets are summed for the totals; peak_hour is the hour with the highest combined (rate-limited + non-rate-limited) request count.
| Field | Type | Description |
|---|---|---|
system | string | The calling system's registered name. |
period | string | Always last_24h. |
usage.total_requests | int | All API calls attributed to this system in the trailing 24h. |
usage.rate_limited_requests | int | Subset of total_requests rejected by a global rate limiter. |
usage.rate_limit_percentage | float | (rate_limited_requests / total_requests) * 100, rounded to two decimals. 0 if there was no traffic. |
usage.peak_hour | string|null | ISO 8601 hour bucket (YYYY-MM-DDTHH:00:00Z) with the highest call count. null when no traffic. |
usage.current_limits.across_all_accounts | object | Per-route global ceilings. default is the catch-all; named keys are per-route overrides. |
usage.current_limits.per_account | object | Per-account ceilings. Same shape as across_all_accounts. |
Example response
{
"system": "your-system",
"period": "last_24h",
"usage": {
"total_requests": 1247,
"rate_limited_requests": 23,
"rate_limit_percentage": 1.84,
"peak_hour": "2026-05-19T14:00:00Z",
"current_limits": {
"across_all_accounts": { "default": 750, "GET.people": 100 },
"per_account": { "default": 25 }
}
}
}
Errors
| Status | Meaning |
|---|---|
| 401 | Missing or invalid user API key. |
| 403 | Only registered systems can call this endpoint. |
Related
- GET /v1/rateLimit/limits — currently-configured limits only (cheaper).
- Rate Limiting — overview of how rate limiting is enforced.