---
title: "List Flow Loop Pauses"
method: GET
path: "/api/v1/flows/{flow_id}/loop-pauses"
tags: ["Flows"]
---

# List Flow Loop Pauses

`GET /api/v1/flows/{flow_id}/loop-pauses`

## Request

- Base URL: `https://api.sendseven.com`
- URL: `https://api.sendseven.com/api/v1/flows/{flow_id}/loop-pauses`
- Auth: HTTP bearer

List the contacts this flow is (or was) paused for by loop protection.

``contact_name`` is filled only when the caller ALSO holds
``contacts:read`` (otherwise ``null``).

A flow is paused for a contact when it started for that contact too many
times in a short window via contact triggers. Newest pause first.

**Required Scopes:** `flows:read`

## Path parameters

- `flow_id` string, required

## Query parameters

- `status` string: active (default), resumed or all.
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- FlowLoopPauseListResponse
  - `items` FlowLoopPauseResponse[], required
    - `id` string, required
    - `flow_id` string, required
    - `contact_id` string, required
    - `contact_name` string, nullable
    - `status` string, required
    - `start_count` integer, required
    - `window_seconds` integer, required
    - `pause_count` integer, required
    - `last_trigger_type` string, nullable
    - `last_origin` string, nullable
    - `paused_at` string, required
    - `resumed_at` string, nullable
    - `resumed_by_user_id` string, nullable
  - `pagination` PaginationMeta, required: Pagination metadata for list responses. Supports both offset-based and page-based pagination. Clients should use page/page_size for new implementations.
    - `total` integer, required: Total number of items matching the query
    - `page` integer, required: Current page number (1-indexed)
    - `page_size` integer, required: Number of items per page
    - `total_pages` integer, required: Total number of pages
    - `has_next` boolean, required: Whether there are more pages
    - `has_prev` boolean, required: Whether there are previous pages
    - `next_cursor` string, nullable: Cursor for next page (if using cursor pagination)
    - `prev_cursor` string, nullable: Cursor for previous page

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sendseven/apis/sendseven.md) · [All operations](https://skmtc.dev/sendseven/apis/sendseven/llms.txt) · [OpenAPI document](https://skmtc.dev/sendseven/apis/sendseven/revisions/ea628483e29a?raw)