Rate Limiting

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.

HeaderDescription
X-RateLimit-Limit-MinuteThe minutely rate limit for your subscription tier.
X-RateLimit-Remaining-MinuteNumber of hits you have available for the remaining minute.
X-RateLimit-Reset-MinuteDate or time when your minutely rate limit resets in GMT.
X-RateLimit-Limit-Period-TypePeriod duration associated with your period limit.
X-RateLimit-Limit-PeriodThe period rate limit for your subscription tier.
X-RateLimit-Remaining-PeriodNumbers of hits you have available for the remaining period.
X-RateLimit-Reset-PeriodDate 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.