Rate Limiting

The Weather 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.

Rate limits can be tracked with the response headers. AerisWeather 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 Numbers of hits you have available for the remaining minute.
X-RateLimit-Reset-Minute Date / time when your minutely rate limit resets in GMT.
X-RateLimit-Limit-Period-Type (coming soon) Period duration associated with your period limit.
X-RateLimit-Limit-Period (coming soon) The period rate limit for your subscription tier.
X-RateLimit-Remaining-Period (coming soon) Numbers of hits you have available for the remaining period.
X-RateLimit-Reset-Period (coming soon) Date / time when your period rate limit resets in GMT.

For more information about your specific limits, please reach out to Customer Success or your Account Executive.

Last modified: August 24, 2023