API Rate Limiting
Learn about Visier API call rate limiting.
Visier imposes limits on the number of API calls that you can make using your API key. Calls over these limits are rejected. In the event that you reach or exceed the rate limit, a failure response with an HTTP 429 status code is returned. For more information about errors, see Errors.
Visier's default rate limits are 100 calls per minute or 6000 calls per hour.
Visier includes information on remaining limits in every response header. When using the APIs, please make allowances for checking the response headers for details on the number of outstanding calls available for the applicable time period and adjust the code to ensure alignment within the limits.
Headers
Header |
Description |
Type |
---|---|---|
X-RateLimit-Limit-Minute |
The number of API calls that can be made per minute. |
integer |
X-RateLimit-Remaining-Minute |
The number of API calls that can still be made during the current minute. |
integer |
X-RateLimit-Limit-Hour |
The number of API calls that can be made per hour. |
integer |
X-RateLimit-Remaining-Hour |
The number of API calls that can still be made during the current hour. |
integer |
Sample response
{
X-RateLimit-Limit-Minute: 100
X-RateLimit-Remaining-Minute: 7
X-RateLimit-Limit-Hour: 6000
X-RateLimit-Remaining-Hour: 700
}
Query limits
- Aggregate query responses can contain a maximum of 300,000 cells.
- List query responses can contain a maximum of 100 million cells and 500 fields.
- Time axes can have a maximum of 120 positions. For time axes, refer to the intervalCount field in the Data Query API.
- Non-time axes can have a maximum of 10 million positions.