Rate Limiting
The Xweather API will limit the number of requests you can make based on your subscription. Your rate limit will be determined by your accesses per billing period. In addition to period based rate limiting, the Weather API will also enforce a minutely rate limit. Once you have surpassed your minutely or period based limit, the API will return a 429 status code (opens in a new tab).
Rate limits can be tracked with the response headers. The Weather API has custom headers for both minutely and period-based limits.
| Header | Description |
|---|---|
X-RateLimit-Limit-Minute | The minutely rate limit for your subscription tier. |
X-RateLimit-Remaining-Minute | Number of hits you have available for the remaining minute. |
X-RateLimit-Reset-Minute | Date or time when your minutely rate limit resets in GMT. |
X-RateLimit-Limit-Period-Type | Period duration associated with your period limit. |
X-RateLimit-Limit-Period | The period rate limit for your subscription tier. |
X-RateLimit-Remaining-Period | Numbers of hits you have available for the remaining period. |
X-RateLimit-Reset-Period | Date or time when your period rate limit resets in GMT. |
For more information about your specific limits, please reach out to support (opens in a new tab) or your account executive.