---
title: "List existing sequences"
method: GET
path: "/sequences"
tags: ["Sequences"]
---

# List existing sequences

`GET /sequences`

## Request

- Base URL: `https://app.pumpgtm.com/api/v1`
- URL: `https://app.pumpgtm.com/api/v1/sequences`
- Auth: HTTP bearer

Read tenant-owned sequences, ordered steps and exact lead counts in a compact shape: steps use index and message and there is no executionModel. GET /sequences/{id} returns the full shape (stepIndex, messageTmpl, executionModel); read it before PUT. Create with POST /sequences, replace steps with PUT /sequences/{id}, pause or resume with PATCH /sequences/{id}/status.

## Headers

- `X-PumpGTM-Client` string, uuid
- `X-PumpGTM-User` string

## Response `200`

Successful response. Read outcome fields; success does not imply delivery.

- object
  - `sequences` object[], required
    - `id` string, uuid, required
    - `name` string, required
    - `status` string, required
    - `revision` integer, required
    - `approvedAt` string, nullable, required
    - `approvedRevision` integer, nullable, required
    - `executionBlockReason` string, nullable, required
    - `leadCount` integer, required
    - `channels` string[], required
    - `steps` object[], required
      - `index` integer, required
      - `kind` 'connect' | 'message' | 'engage' | 'email' | 'x_dm' | 'x_engage' | 'instagram_dm', required
      - `delayDays` integer, required
      - `subject` string, nullable, required
      - `message` string, nullable, required
      - `actions` object[], nullable, required
      - `variants` object[], nullable, required
      - `tool` object, nullable, required

## Other responses

- `400`: Invalid input; for partner keys also user_header_required when the account requires X-PumpGTM-User
- `401`: Missing, invalid or revoked key
- `403`: Workspace mismatch, channel or feature disabled; for partner keys also enterprise_required and user_disabled
- `404`: Resource unavailable in this workspace
- `409`: Revision, identity or state conflict: { error, message } and nothing changed
- `429`: Rate limit; respect Retry-After when provided
- `500`: internal_error: an unexpected failure on our side; retry, then contact PumpGTM
- `503`: Dependency unavailable; identity may be unknown

## Changes

- **2026-10-12** `06d2e4d0e84b`: 8 info
  - the response property `error` became required for the status `400`
  - the response property `error` became required for the status `401`
  - the response property `error` became required for the status `403`
  - the response property `error` became required for the status `404`
  - …4 more
- **2026-10-12** `08c80059d483`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pumpgtm/apis/pumpgtm-api/changes/sequences/get.md)

---

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