# List menu options

> Flattens the phone-menu tree of the line's published call flow. Each option carries a ready MENU BRANCH condition. A line without a phone menu, or whose…

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

<Note>
**Required scope:** `INBOXES_READ`
</Note>

## Behavior

Flattens the phone-menu tree of the line's **published** call flow. Drafts are ignored. Each option gives:

- `path`: the menu choices from the first menu down to this option.
- `digits`: the same path as keys, for example `1>2`.
- `label`: the option's name in the call flow.
- `condition`: a ready `MENU_BRANCH` condition for this option. It is always a `MENU_BRANCH`.

A line without a phone menu returns an empty list, and so does a line whose calls are not routed by the call-flow engine. Menu conditions are only accepted on lines where this list is not empty, and only with paths from it. On any other line, use a whole-line source with empty `conditions`.

Use it only to build a custom branch. For the common case, start from [Get inbox suggestions](/docs/inboxes/get-inbox-suggestions).

## Combine several options

A line appears once in `sources`, with at most one `MENU_BRANCH`. To cover several options of the same line, concatenate the `branches` of their conditions into one `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
    }
  ]
}
```

## Errors

| Status | Code | When |
|--------|------|------|
| `403` | `ALLO_NUMBER_FORBIDDEN` | The caller cannot access this line |
