---
title: "List call flows"
method: GET
path: "/api/fabric/resources/call_flows"
tags: ["Call Flows"]
---

# List call flows

`GET /api/fabric/resources/call_flows`

A list of Call Flows

#### 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).

## Response `200`

The request has succeeded.

- CallFlowListResponse
  - `links` CallFlowAddressPaginationResponse, required
    - `self` string, uri, required — Link of the current page
    - `first` string, uri, required — Link to the first page
    - `next` string, uri — Link to the next page
    - `prev` string, uri — Link to the previous page
  - `data` CallFlowResponse[], required — An array of objects containing the CallFlow listing response
    - `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
              - …
      - `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)