Skip to main content

Rate Limits

The Homesoon Third-Party API enforces per-origin rate limits to protect shared infrastructure.

  • Default: 60 requests per minute per registered origin.
  • Bulk endpoints (list operations with paging > 20) count as 2 requests each.
  • File upload endpoints share a 10 MB/s aggregate bandwidth budget per origin.

When you exceed the limit the API returns 429 Too Many Requests with:

{
  "status": "failure",
  "error": {"code": "RATE_LIMIT_EXCEEDED", "message": "Retry later"}
}

Back off using exponential retry, starting at 1 second. If your integration consistently needs a higher quota, contact support@homesoon.jp.