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

# List call flows

`GET /api/fabric/resources/call_flows`

Lists the Call Flows in your SignalWire project. A Call Flow is a visual, reusable call handler built in Call Flow Builder; it can be assigned to phone numbers and other routing resources. Use [SWML Scripts](/docs/apis/rest/swml-scripts/list-swml-scripts) when you author SWML directly, or a [Relay Application](/docs/apis/rest/relay-application/list-relay-applications) when a Server SDK process handles the call.

#### 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` object — The calling SWML document this Call Flow executes. Uses [calling SWML methods](/docs/swml/reference/calling).
      - `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.

## Changes

> 137 revisions in range; 3 could not be searched.

- **2026-08-20** `e79dcc8b2150` — 1 breaking, 2 info
  - the `data/items/call_flow/allOf[#/components/schemas/CallFlow]/relayml` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - removed `#/components/schemas/SWML.Calling.SWMLObject` from the `data/items/call_flow/allOf[#/components/schemas/CallFlow]/relayml` response property `allOf` list for the response status `200`
  - added 'unevaluatedProperties' constraint to the `data/items/call_flow/allOf[#/components/schemas/CallFlow]/relayml` response property for the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/signalwire/apis/signalwire-rest-api/changes/api/fabric/resources/call_flows/get.md)

---

[API](https://skmtc.dev/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.dev/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/revisions/792d5b8e2970/schema)