---
title: "Get call flow"
method: GET
path: "/api/fabric/resources/call_flows/{id}"
tags: ["Call Flows"]
---

# Get call flow

`GET /api/fabric/resources/call_flows/{id}`

Returns a Call Flow by ID

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Path parameters

- `id` string, uuid, required — Universal Unique Identifier.

## Response `200`

The request has succeeded.

- CallFlowResponse
  - `id` string, uuid, required — Universal Unique Identifier.
  - `project_id` string, uuid, required — Universal Unique Identifier.
  - `display_name` string, required — Display name of the Call Flow Fabric Resource
  - `type` 'call_flow', required — Type of the Fabric Resource
  - `created_at` string, date-time, required — Date and time when the resource was created.
  - `updated_at` string, date-time, required — Date and time when the resource was updated.
  - `call_flow` CallFlow, required
    - `id` string, uuid, required — Universal Unique Identifier.
    - `title` string, required — The name of the Call Flow
    - `flow_data` object — Call Flow Builder state, stored as an opaque JSON object. Produced and consumed by the SignalWire Call Flow Builder UI; not used by SWML execution.
    - `relayml` SWMLCallingSWMLObject — A SWML document for handling inbound and outbound calls. Contains a `sections` map where each section holds an array of methods that run sequentially. Execution starts at `sections.main`. See the [Calling SWML reference](/docs/swml/reference/calling) for the full list of available methods.
      - `version` '1.0.0'
      - `sections` SWMLCallingSection, required
        - `main` SWMLCallingSWMLMethod[], required
          - union
            - SWMLCallingAnswer
              - …
            - SWMLCallingAI
              - …
            - SWMLCallingAISidecar
              - …
            - SWMLCallingAmazonBedrock
              - …
            - SWMLCallingCond
              - …
            - SWMLCallingConnect
              - …
            - SWMLCallingDenoise
              - …
            - SWMLCallingEnterQueue
              - …
            - SWMLCallingExecute
              - …
            - SWMLCallingGoto
              - …
            - SWMLCallingLabel
              - …
            - SWMLCallingLiveTranscribe
              - …
            - SWMLCallingLiveTranslate
              - …
            - SWMLCallingHangup
              - …
            - SWMLCallingJoinRoom
              - …
            - SWMLCallingJoinConference
              - …
            - SWMLCallingPlay
              - …
            - SWMLCallingPrompt
              - …
            - SWMLCallingReceiveFax
              - …
            - SWMLCallingRecord
              - …
            - SWMLCallingRecordCall
              - …
            - SWMLCallingRequest
              - …
            - SWMLCallingReturn
              - …
            - SWMLCallingSendDigits
              - …
            - SWMLCallingSendFax
              - …
            - SWMLCallingSendSMS
              - …
            - SWMLCallingSet
              - …
            - SWMLCallingSleep
              - …
            - SWMLCallingSIPRefer
              - …
            - SWMLCallingStopDenoise
              - …
            - SWMLCallingStopRecordCall
              - …
            - SWMLCallingStopStream
              - …
            - SWMLCallingStopTap
              - …
            - SWMLCallingStream
              - …
            - SWMLCallingSwitch
              - …
            - SWMLCallingTap
              - …
            - SWMLCallingTranscribe
              - …
            - SWMLCallingTranscribeStop
              - …
            - SWMLCallingTransfer
              - …
            - SWMLCallingUnset
              - …
            - SWMLCallingPay
              - …
            - SWMLCallingDetectMachine
              - …
            - SWMLCallingUserEvent
              - …
    - `document_version` integer — The current revision of the call flow. Every update must increase this number.

## Other responses

- `401` — Access is unauthorized.
- `404` — The server cannot find the requested resource.
- `500` — An internal server error occurred.

---

[API](https://skmtc.net/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.net/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/versions/05c5164b85c7/schema)