Limits
Request rate, response size and paging.
| Limit | Value | When exceeded |
|---|---|---|
| Requests per API key | 240 per minute | 429 rate_limited, with Retry-After |
| Requests without a key | 30 per minute per IP address | 429 rate_limited, with Retry-After and where to get a key |
| Points per values request | 100,000 at the series' resolution: 11 years at PT1H, 1,041 days at PT15M, under 28 hours at PT1S | 400 bad_request (param: end); split the window |
| Series per many-series call | 2,000 (5 without a key); a page holds whole series up to 200,000 points | 400 bad_request over 2,000; series past a full page come with next |
| Time range for a series without a regular step (e.g. outages published as change-points, installed capacity) | 366 days, since the point count cannot be computed | 400 bad_request (param: end) |
| Search results per page | 100 by default, limit up to 1,000 | the rest pages with next |
| Snapshots per page | 100 by default, max_snapshots up to 1,000 | the rest pages with next |
All times are UTC, in ISO 8601. How to stay inside these limits with few requests: Calling rules.