# Lister les options de menu

> Met à plat l'arbre du menu téléphonique du call flow publié de la ligne. Les brouillons sont ignorés. Chaque option donne :

`GET /v2/api/numbers/{number}/menu_options`

<Note>
**Scope requis :** `INBOXES_READ`
</Note>

## Comportement

Met à plat l'arbre du menu téléphonique du call flow **publié** de la ligne. Les brouillons sont ignorés. Chaque option donne :

- `path` : les choix de menu depuis le premier menu jusqu'à cette option.
- `digits` : le même chemin en touches, par exemple `1>2`.
- `label` : le nom de l'option dans le call flow.
- `condition` : une condition `MENU_BRANCH` prête à l'emploi pour cette option. C'est toujours une `MENU_BRANCH`.

Une ligne sans menu téléphonique retourne une liste vide, de même qu'une ligne dont les appels ne sont pas routés par le moteur de call flow. Les conditions de menu ne sont acceptées que sur les lignes où cette liste n'est pas vide, et seulement avec des chemins qui en viennent. Sur toute autre ligne, utilisez une source sur toute la ligne, avec des `conditions` vides.

Utilisez-le seulement pour construire une branche sur mesure. Dans le cas courant, partez de [Obtenir les suggestions de boîtes](/fr/docs/inboxes/get-inbox-suggestions).

## Combiner plusieurs options

Une ligne apparaît une seule fois dans `sources`, avec au plus une `MENU_BRANCH`. Pour couvrir plusieurs options d'une même ligne, concaténez les `branches` de leurs conditions dans une seule `MENU_BRANCH` :

```json
{
  "allo_number": "+33612345678",
  "conditions": [
    {
      "type": "MENU_BRANCH",
      "branches": [
        [{"node_id": "node-1", "digit": "1"}, {"node_id": "node-3", "digit": "2"}],
        [{"node_id": "node-1", "digit": "2"}]
      ],
      "include_no_choice": false
    }
  ]
}
```

## Erreurs

| Statut | Code | Quand |
|--------|------|-------|
| `403` | `ALLO_NUMBER_FORBIDDEN` | L'appelant n'a pas accès à cette ligne |
