Get the programs of a Miele appliance

Use this action to retrieve the available programs of a Miele appliance, along with their parameters. For example, you can use it to find the program ID to pass to the Set program action.

The action returns an empty list if the appliance does not support programs, such as a freezer. The appliance must be in the same state required by the Set program action.

This action returns its result as response data and does not change anything on the appliance.

Using this action from the user interface

If you prefer building automations and scripts visually, Home Assistant walks you through this action step by step. You pick what to target, tweak a few options, and save. No YAML knowledge required.

To get the programs from an automation or a script:

1. Go to Settings > Automations & scenes.
2. Open an existing automation or script, or select Create automation > Create new automation.
3. If you’re setting up a new automation, add a trigger in the When section. Scripts don’t need a trigger. They run when something else calls them.
4. In the Then do section, select Add action.
5. Search for the action Miele: Get programs and select it.
6. Select the appliance in the Device field.
7. Select Save.

Options in the UI

Using this action in YAML

If you work directly in YAML, or you want to know exactly what Home Assistant does under the hood, this section has the technical reference. It lists the field names you use in YAML, their types, and which ones are required.

In YAML, refer to this action as miele.get_programs. A basic example looks like this:

action: miele.get_programs
data:
  device_id: abcde1234567890abcde1234567890ab
response_variable: programs

This stores the available programs of the appliance in a variable named programs.

Options in YAML

This action does not support targets. Select the appliance through the Device field.

Response data

The action returns a programs list. Each entry has a program_id, a program name, and a parameters mapping. The parameters can include a temperature and a duration range, each with whether it is mandatory. Parameters that the program does not support are returned as empty.

programs:
  - program_id: 1
    program: Cottons
    parameters:
      temperature:
        min: 30
        max: 90
        step: 10
        mandatory: false
      duration:
        min:
          hours: 1
          minutes: 0
        max:
          hours: 3
          minutes: 0
        mandatory: false

Try it yourself

Ready to test this? Open Developer tools > Actions, search for this action, fill in the fields, and select Perform action. You see what happens on your actual entitiesAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] without writing a line of YAML.

Still stuck?

The Home Assistant community is quick to help: join Discord for real-time chat, post on the community forum with the action you’re calling and what you expected to happen, or share on our subreddit /r/homeassistant.

Related actions

These actions work well alongside this one:

• Set a program on a Miele appliance: Sets and starts a program on a Miele appliance.

• Set a program on a Miele oven: Sets and starts a program on a Miele oven.