Rate Limiting

Welcome to the Rachio API documentation. Let's get started!

Rachio's public API has rate limiting in order to improve server performance for all users. We allow 1,700 calls per day, which is over 1 call per minute, for each of our APIs (Controllers and Smart Hose Timers). In general, this limit is only reached by integrations that are polling.

Limits are reset at midnight UTC every day

If you’d like to explore a non-polling method, we do support webhooks for our Controller API. We are willing to work with users to discuss exceptions on rate limiting for specific use cases.

We return the following response headers for rate limit information:

X-RateLimit-Limit – The total call limit we support
X-RateLimit-Remaining – The number of calls you have remaining until the reset time
X-RateLimit-Reset – The timestamp in UTC formatted to HTTP spec per RFC 1123 for when the limits will be reset.

Example of response header data:

x-ratelimit-limit →1700
x-ratelimit-remaining →4
x-ratelimit-reset →2023-03-13T00:00:00Z

We would love to hear about how you have built integrations on top of our API, send me an email at [email protected].