Rate limits

There are no published rate limits today. The API runs on shared infrastructure and is monitored, so be reasonable. In particular:

  • Don't poll for new data. Use webhooks, or pull on a sensible cadence if you must.
  • Batch where the endpoint supports it.
  • Back off on 5xx responses.

If we introduce formal per-key limits, we'll publish them here along with the corresponding response headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) and give integrators notice first. 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.

Warning

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.