Rate Limiting

The Home Connect API uses the following rate limits. Please make sure not to reach the limits regularly, otherwise your account may be locked.

The following limits are currently configured:

  • Generally if too many requests are sent, further requests are rejected with the HTTP status code 429. In this case, please check the Retry-After header. This states the number of seconds that you need to wait, before you try your request again.
  • 1000 requests per client and Home Connect account per day.
    If the quota is reached, additional requests may be blocked. Thus, do not query for state information but use the monitoring function instead, and start/stop programs with care. Furthermore, only one monitoring channel per device per home appliance is allowed.
  • 50 requests per client and Home Connect account per minute (more requests will be blocked for one minute)
  • 5 program starts per client and Home Connect account per minute (more program starts will be blocked for one minute)
  • 5 program stops per client and Home Connect account per minute (more program stops will be blocked for one minute)
  • 10 successive requests per client and Home Connect account per 10 minutes which result in an error (more requests will be blocked for 10 minutes)
  • 10 event monitoring channels per client and Home Connect account at any time (the request for further channels will be blocked)
  • 10 requests per second on average (20 requests max. burst) with leaky bucket algorithm, otherwise HTTP 429 error

Example


{
    "error": {
        "key": "429",
        "description": "The rate limit \"5 start program calls in 1 minute\" was reached. Requests are blocked during the remaining period of 52 seconds."
    }
}