Rate limits
How aggressively you can call the API today, and what's coming.
There are no published rate limits today. The API runs on shared infrastructure and is monitored — be reasonable, and especially:
- Don't poll. Use webhooks (coming soon) or pull on a sensible cadence.
- Batch where the endpoint supports it.
- Back off on
5xxresponses.
We will publish formal per-key limits and the corresponding response headers
(X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) before the API
goes to General Availability. If your integration depends on a particular request
volume, write to us at support@yournexthome.app
so we can size the limits to your use case.
Today we may throttle or block traffic at our discretion if a key is producing obviously abusive load. We will email the org's billing contact before doing so except in an emergency.