---
title: "List executions for a flow"
method: GET
path: "/v2/flows/{id}/executions"
tags: ["Flows Api Service"]
---

# List executions for a flow

`GET /v2/flows/{id}/executions`

## Request

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

## Path parameters

- `id` integer, required

## Query parameters

- `status` 'completed' | 'running' | 'failed'

## Response `200`

Executions retrieved successfully

- JsonOkListResponseFlowExecutionDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` FlowExecutionDto[]
    - `triggerId` string: Execution identifier
    - `triggeredAt` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `triggerUserId` string: Instagram user ID that triggered the flow
    - `network` string: Social network
    - `status` 'completed' | 'running' | 'failed': Execution status. Skipped and blocked executions are reported as failed; reason tells them apart
    - `reason` string: Catalog code of why the execution did not complete. Only present when status is failed, and absent on executions recorded before reasons existed
    - `errorDetail` string: The social network's own error text, untranslated and with credentials masked. Only present when status is failed and the network sent one

## Other responses

- `401`: User not authenticated
- `403`: Insufficient permissions
- `404`: Flow not found

---

[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/b51dcfc02f38?raw)