Home Connect (BSH appliances) Images API
Access the camera in the fridge
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/home-connect:home-connect-images-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Home Connect Images API
description: 'This API provides access to home appliances enabled by Home Connect
(https://home-connect.com). Through the API programs can be started and
stopped, or home appliances configured and monitored. For instance, you can
start a cotton program on a washer and get a notification when the cycle is
complete.
To get started with this web client, visit https://developer.home-connect.com
and register an account. An application with a client ID for this API client
will be automatically generated for you.
If you want to use your custom application here, please remember to set its
Redirect URI to https://apiclient.home-connect.com/o2c.html, otherwise
authorization process will fail.
In order to use this API in your own client, you need an OAuth 2 client
implementing the authorization code grant flow
(https://api-docs.home-connect.com/authorization?#authorization-code-grant-flow).
More details can be found here: https://www.rfc-editor.org/rfc/rfc6749.txt
Authorization URL: https://api.home-connect.com/security/oauth/authorize
Token URL: https://api.home-connect.com/security/oauth/token'
version: '1'
servers:
- url: https://api.home-connect.com/api
tags:
- name: Images
description: Access the camera in the fridge
paths:
/homeappliances/{haId}/images:
parameters:
- name: haId
in: path
description: ID of home appliance
required: true
schema:
type: string
- name: Accept-Language
in: header
description: Language for localized assets
schema:
type: string
enum:
- de-DE
- en-GB
- en-US
get:
summary: Get a list of available images
tags:
- Images
operationId: get_images
responses:
200:
description: List of available images
content:
application/vnd.bsh.sdk.v1+json:
schema:
$ref: '#/components/schemas/ArrayOfImages'
401:
$ref: '#/components/responses/Unauthorized'
403:
$ref: '#/components/responses/Forbidden'
406:
$ref: '#/components/responses/NotAcceptable'
408:
$ref: '#/components/responses/RequestTimeout'
429:
$ref: '#/components/responses/QuotaError'
500:
$ref: '#/components/responses/InternalError'
security:
- homeconnect_auth:
- Images
- FridgeFreezer-Images
- FridgeFreezer
/homeappliances/{haId}/images/{imagekey}:
parameters:
- name: haId
in: path
description: ID of home appliance
required: true
schema:
type: string
- name: imagekey
in: path
description: ID of the image
required: true
schema:
type: string
get:
summary: Get a specific image
tags:
- Images
operationId: get_image
responses:
200:
description: Requested image
401:
$ref: '#/components/responses/Unauthorized'
403:
$ref: '#/components/responses/Forbidden'
404:
description: The requested image was not found
406:
$ref: '#/components/responses/NotAcceptable'
408:
$ref: '#/components/responses/RequestTimeout'
429:
$ref: '#/components/responses/QuotaError'
500:
$ref: '#/components/responses/InternalError'
security:
- homeconnect_auth:
- Images
- FridgeFreezer-Images
- FridgeFreezer
components:
schemas:
ForbiddenError:
type: object
required:
- error
properties:
error:
type: object
required:
- key
properties:
key:
type: string
description:
type: string
example:
error:
key: insufficient_scope
description: Insufficient scope for this resource
InteralServerError:
type: object
required:
- error
properties:
error:
type: object
required:
- key
properties:
key:
type: string
description:
type: string
example:
error:
key: Internal Server Error
description: Could not validate permissions to access HomeAppliance
NotAcceptableError:
type: object
required:
- error
properties:
error:
type: object
required:
- key
properties:
key:
type: string
description:
type: string
example:
error:
key: '406'
description: Resource representation is only available with these types:\napplication/vnd.bsh.sdk.v1+json
RequestTimeoutError:
type: object
required:
- error
properties:
error:
type: object
required:
- key
properties:
key:
type: string
description:
type: string
example:
error:
key: SDK.Error.408.RequestTimeout
UnauthorizedError:
type: object
required:
- error
properties:
error:
type: object
required:
- key
properties:
key:
type: string
description:
type: string
example:
error:
key: invalid_token
description: The access token expired
TooManyRequestsError:
type: object
required:
- error
properties:
error:
type: object
required:
- key
properties:
key:
type: string
description:
type: string
example:
error:
key: '429'
description: The user has sent too many requests in a given amount of time.
ArrayOfImages:
type: object
description: List of images available from the home appliance
required:
- data
properties:
data:
type: object
required:
- images
properties:
images:
type: array
items:
type: object
required:
- key
- imagekey
- previewimagekey
- timestamp
- quality
properties:
key:
type: string
description: Feature key of image type
name:
type: string
description: User-friendly, localized name of the image type
imagekey:
type: string
description: Unique identifier for the image
previewimagekey:
type: string
description: Unique identifier for the preview image
timestamp:
type: integer
format: int64
description: Unix timestamp when the image was shot
quality:
type: string
description: 'Quality of the captured image, possible values: good, bad:
image is flagged bad e.g. if the door has been closed too fast to shoot a sharp picture
'
example:
data:
images:
- key: Refrigeration.FridgeFreezer.Status.DoorCameraPresentRefrigerator
imagekey: 56e2ceea1f0000ab54d661f3
previewimagekey: 56e2cee91f0000a654d661f1
timestamp: 1457704646
quality: good
- key: Refrigeration.FridgeFreezer.Status.InteriorCameraPresentRefrigerator
imagekey: 56e2cee91f0000a654d661f2
previewimagekey: 56e2cee91f0000a654d661f0
timestamp: 1457704646
quality: good
responses:
InternalError:
description: Internal Server Error
content:
application/vnd.bsh.sdk.v1+json:
schema:
$ref: '#/components/schemas/InteralServerError'
QuotaError:
description: 'The number of requests for a specific endpoint exceeded the quota of the client.
'
content:
application/vnd.bsh.sdk.v1+json:
schema:
$ref: '#/components/schemas/TooManyRequestsError'
RequestTimeout:
description: API Server failed to produce an answer or has no connection to backend service
content:
application/vnd.bsh.sdk.v1+json:
schema:
$ref: '#/components/schemas/RequestTimeoutError'
NotAcceptable:
description: The resource identified by the request is only capable of generating response entities which have content characteristics not acceptable according to the accept headers sent in the request.
content:
application/vnd.bsh.sdk.v1+json:
schema:
$ref: '#/components/schemas/NotAcceptableError'
Unauthorized:
description: Unauthorized - No or invalid access token
content:
application/vnd.bsh.sdk.v1+json:
schema:
$ref: '#/components/schemas/UnauthorizedError'
Forbidden:
description: Forbidden - Scope has not been granted
content:
application/vnd.bsh.sdk.v1+json:
schema:
$ref: '#/components/schemas/ForbiddenError'
securitySchemes:
homeconnect_auth:
type: oauth2
flows:
authorizationCode:
scopes:
IdentifyAppliance: Grants right to identify a home appliance under /api/homeappliances
Monitor: Grants access to read resources under /api/homeappliances except images and settings
Control: Grants access to modify resources under under /api/homeappliances except images and settings
Images: Grants access to read resources under /api/homeappliances/{haId}/images
Settings: Grants access to read and modify resources under /api/homeappliances/{haId}/settings
Oven: Grants access to read or modify all resources under /api/homeappliances on ovens
Oven-Monitor: Grants access to read resources under /api/homeappliances except images and settings on ovens
Oven-Control: Grants access to modify resources under under /api/homeappliances except images and settings on ovens
Oven-Settings: Grants access to read and modify resources under /api/homeappliances/{haId}/settings on ovens
Dishwasher: Grants access to read or modify all resources under /api/homeappliances on dishwashers
Dishwasher-Monitor: Grants access to read resources under /api/homeappliances except images and settings on dishwashers
Dishwasher-Control: Grants access to modify resources under under /api/homeappliances except images and settings on dishwashers
Dishwasher-Settings: Grants access to read and modify resources under /api/homeappliances/{haId}/settings on dishwashers
Washer: Grants access to read or modify all resources under /api/homeappliances on washers
Washer-Monitor: Grants access to read resources under /api/homeappliances except images and settings on washers
Washer-Control: Grants access to modify resources under under /api/homeappliances except images and settings on washers
Washer-Settings: Grants access to read and modify resources under /api/homeappliances/{haId}/settings on washers
Dryer: Grants access to read or modify all resources under /api/homeappliances on dryers
Dryer-Monitor: Grants access to read resources under /api/homeappliances except images and settings on dryers
Dryer-Control: Grants access to modify resources under under /api/homeappliances except images and settings on dryers
Dryer-Settings: Grants access to read and modify resources under /api/homeappliances/{haId}/settings on dryers
WasherDryer: Grants access to read or modify all resources under /api/homeappliances on washerdryers
WasherDryer-Monitor: Grants access to read resources under /api/homeappliances except images and settings on washerdryers
WasherDryer-Control: Grants access to modify resources under under /api/homeappliances except images and settings on washerdryers
WasherDryer-Settings: Grants access to read and modify resources under /api/homeappliances/{haId}/settings on washerdryers
FridgeFreezer: Grants access to read or modify all resources under /api/homeappliances on fridgefreezers
FridgeFreezer-Monitor: Grants access to read resources under /api/homeappliances except images and settings on fridgefreezers
FridgeFreezer-Control: Grants access to modify resources under /api/homeappliances except images and settings on fridgefreezers
FridgeFreezer-Settings: Grants access to read and modify resources under /api/homeappliances/{haId}/settings on fridgefreezers
FridgeFreezer-Images: Grants access to read resources under /api/homeappliances/{haId}/images on fridgefreezers
CoffeeMaker: Grants access to read or modify all resources under /api/homeappliances on coffee makers
CoffeeMaker-Monitor: Grants access to read resources under /api/homeappliances except images and settings on coffee makers
CoffeeMaker-Control: Grants access to modify resources under under /api/homeappliances except images and settings on coffee makers
CoffeeMaker-Settings: Grants access to read and modify resources under /api/homeappliances/{haId}/settings on coffee makers
Hob: Grants access to read or modify all resources under /api/homeappliances on hobs
Hob-Monitor: Grants access to read resources under /api/homeappliances except images and settings on hobs
Hob-Control: Grants access to modify resources under under /api/homeappliances except images and settings on hobs
Hob-Settings: Grants access to read and modify resources under /api/homeappliances/{haId}/settings on hobs
Hood: Grants access to read or modify all resources under /api/homeappliances on hoods
Hood-Monitor: Grants access to read resources under /api/homeappliances except images and settings on hoods
Hood-Control: Grants access to modify resources under under /api/homeappliances except images and settings on hoods
Hood-Settings: Grants access to read and modify resources under /api/homeappliances/{haId}/settings on hoods
CleaningRobot: Grants access to read or modify all resources under /api/homeappliances on cleaning robots
CleaningRobot-Monitor: Grants access to read resources under /api/homeappliances except images and settings on cleaning robots
CleaningRobot-Control: Grants access to modify resources under under /api/homeappliances except images and settings on cleaning robots
CleaningRobot-Settings: Grants access to read and modify resources under /api/homeappliances/{haId}/settings on cleaning robots
CleaningRobot-Map: Grants access to read resources under /api/homeappliances/{haId}/map on cleaning robots
Refrigerator: Grants access to read or modify all resources under /api/homeappliances on refrigerators
Refrigerator-Monitor: Grants access to read resources under /api/homeappliances except images and settings on refrigerators
Refrigerator-Control: Grants access to modify resources under under /api/homeappliances except images and settings on refrigerators
Refrigerator-Settings: Grants access to read and modify resources under /api/homeappliances/{haId}/settings on refrigerators
Freezer: Grants access to read or modify all resources under /api/homeappliances on freezers
Freezer-Monitor: Grants access to read resources under /api/homeappliances except images and settings on freezers
Freezer-Control: Grants access to modify resources under under /api/homeappliances except images and settings on freezers
Freezer-Settings: Grants access to read and modify resources under /api/homeappliances/{haId}/settings on freezers
WineCooler: Grants access to read or modify all resources under /api/homeappliances on wine coolers
WineCooler-Monitor: Grants access to read resources under /api/homeappliances except images and settings on wine coolers
WineCooler-Control: Grants access to modify resources under under /api/homeappliances except images and settings on wine coolers
WineCooler-Settings: Grants access to read and modify resources under /api/homeappliances/{haId}/settings on wine coolers
CookProcessor: Grants access to read or modify all resources under /api/homeappliances on cookprocessors
CookProcessor-Monitor: Grants access to read resources under /api/homeappliances except images and settings on cookprocessors
CookProcessor-Control: Grants access to modify resources under under /api/homeappliances except images and settings on cookprocessors
CookProcessor-Settings: Grants access to read and modify resources under /api/homeappliances/{haId}/settings on cookprocessors
authorizationUrl: https://api.home-connect.com/security/oauth/authorize
tokenUrl: https://api.home-connect.com/security/oauth/token
description: 'The Home Connect API uses the authorization code grant flow of the OAuth2
Authorization Framework as specified in RFC 6749 (https://tools.ietf.org/html/rfc6749).
Authorization tokens have to be transmitted in the HTTP headers as defined
in RFC 6750 (https://tools.ietf.org/html/rfc6750).
'
externalDocs:
description: Home Connect Developer Portal
url: https://developer.home-connect.com/