- General
- Authorization
- Programs and Options
- States
- Settings
- Power State
- Setpoint Temperature Refrigerator
- Setpoint Temperature Freezer
- Setpoint Temperature Bottle Cooler
- Setpoint Temperature Chiller
- Setpoint Temperature Wine Comp.
- Super Mode Refrigerator
- Super Mode Freezer
- Eco Mode
- Sabbath Mode
- Vacation Mode
- Fresh Mode
- Current Map
- Names of Maps
- Functional Light
- Functional Light Brightness
- Ambient Light
- Ambient Light Brightness
- Ambient Light Color
- Ambient Light Custom Color
- Events
- Commands
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 user 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 user account per minute (more requests will be blocked for one minute)
- 5 program starts per client and Home Connect user account per minute (more program starts will be blocked for one minute)
- 5 program stops per client and Home Connect user account per minute (more program stops will be blocked for one minute)
- 10 successive requests per client and Home Connect user 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 user 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."
}
}