# Get call flow

> Returns the call flow for a phone number. By default returns the published flow (or an in-memory synthesis of the legacy IVR if none is published); pass…

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

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

## Behavior

Returns the call flow for a phone number. The `{number}` path parameter is the Allo phone number in E.164 format (e.g. `+14155551234`).

By default this returns the **published** flow. If the number has no published flow, Allo returns an in-memory synthesis of the legacy IVR configuration with `status: "SYNTHESIZED"` (nothing is persisted). Pass `?status=draft` to fetch the working **draft** instead.

<Note>
`?status=draft` falls back to the published flow (or the synthesis) when no draft exists. To read a draft **without** that fallback — getting a `404` instead — use [Get call flow draft](/docs/phone-numbers/get-call-flow-draft).
</Note>

## Fields

- `status` — `DRAFT`, `PUBLISHED`, or `SYNTHESIZED`.
- `lock_version` — optimistic-concurrency token. Pass it back when saving a draft.
- `number` — E.164 of the line this flow routes (null for a `SYNTHESIZED` flow).
- `confirmation_url` — present only on a `DRAFT`: the link where a signed-in user reviews and publishes it. See [Save call flow draft](/docs/phone-numbers/save-call-flow-draft).
- `definition` — the opaque call flow tree document (camelCase keys), rooted at `entry_node_id`.

## Errors

- `404 PHONE_NUMBER_NOT_FOUND` — the number is not one of your account's numbers. List them with `GET /v2/api/numbers`.
