---
title: "List all flows for a brand"
method: GET
path: "/v2/flows"
tags: ["Flows Api Service"]
---

# List all flows for a brand

`GET /v2/flows`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/flows`
- Auth: none declared

## Response `200`

Flows retrieved successfully

- JsonOkListResponseFlowSummaryDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` FlowSummaryDto[]
    - `id` integer, required: Flow identifier
    - `name` string, required: Flow name
    - `flowType` string, required: Type of flow
    - `socialNetwork` string, required: Social network associated with the flow
    - `status` string, required: Current flow status
    - `lastExecutionAt` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `createdAt` DateTimeInfo, required
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `updatedAt` DateTimeInfo, required
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `metrics` FlowMetricsDto: Flow performance metrics
      - `sendings` integer: Total number of messages sent by the flow
      - `interactions` integer: Total number of user interactions received
      - `ctr` number, double: Click-through rate as a percentage (interactions / sendings * 100)
    - `profileConnected` boolean, required: Whether the social network profile is currently connected

## Other responses

- `401`: User not authenticated
- `403`: Insufficient permissions or subscription plan does not support Flows

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/cd0ca612fa01?raw)