Get call flow
Phone Numbers
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 ?status=draft to return the working draft instead.
GET
Get call flow
Required scope:
PHONE_NUMBERS_READBehavior
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.
?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.Fields
status—DRAFT,PUBLISHED, orSYNTHESIZED.lock_version— optimistic-concurrency token. Pass it back when saving a draft.number— E.164 of the line this flow routes (null for aSYNTHESIZEDflow).confirmation_url— present only on aDRAFT: the link where a signed-in user reviews and publishes it. See Save call flow draft.definition— the opaque call flow tree document (camelCase keys), rooted atentry_node_id.
Errors
404 PHONE_NUMBER_NOT_FOUND— the number is not one of your account’s numbers. List them withGET /v2/api/numbers.
Authorizations
Path Parameters
Allo phone number in E.164 format
Example:
"+14155551234"
Query Parameters
Pass draft to fetch the working draft instead of the published flow.
Available options:
draft, published Response
The call flow
A version of a phone number's call flow.