# List Sequences

> Retrieve all sequence steps for a campaign, ordered by step number.

> Documentation index: https://www.foxreach.io/docs/llms.txt lists every page of these docs. Each page is also served as Markdown: add `.md` to its URL.

`GET` https://api.foxreach.io/api/v1/campaigns/{campaign_id}/sequences

## Path Parameters

- `campaign_id` string path required

  The unique identifier of the campaign.

## Response

- `data` array

  Array of sequence step objects.

  Sequence object:

  - `id` string: Unique sequence identifier.
  - `campaignId` string: Parent campaign ID.
  - `stepNumber` integer: Step order (1-based).
  - `name` string: Optional step name.
  - `subject` string: Email subject line. Supports template variables and spin syntax.
  - `body` string: Email body. Supports template variables and spin syntax.
  - `delayDays` integer: Days to wait after previous step.
  - `delayHours` integer: Additional hours to wait.
  - `sendOnlyIfNoReply` boolean: Skip this step if lead has already replied.
  - `createdAt` string: ISO 8601 timestamp.
  - `updatedAt` string: ISO 8601 timestamp.

**Request example**

```bash cURL
curl -X GET "https://api.foxreach.io/api/v1/campaigns/cmp_abc123/sequences" \
  -H "X-API-Key: otr_your_key"
```

```python Python SDK
from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
sequences = client.campaigns.sequences.list("cmp_xyz789")
```

```typescript TypeScript SDK
import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const sequences = await client.campaigns.sequences.list("cmp_xyz789");
```

**Response example**

```json
{
  "data": [
    {
      "id": "seq_001",
      "campaignId": "cmp_abc123",
      "stepNumber": 1,
      "name": "Initial outreach",
      "subject": "Quick question, {{firstName}}",
      "body": "Hi {{firstName}},\n\nI noticed {{company}} recently...",
      "delayDays": 0,
      "delayHours": 0,
      "sendOnlyIfNoReply": false,
      "createdAt": "2025-01-10T08:00:00",
      "updatedAt": "2025-01-10T08:00:00"
    },
    {
      "id": "seq_002",
      "campaignId": "cmp_abc123",
      "stepNumber": 2,
      "name": "Follow-up",
      "subject": "Re: Quick question, {{firstName}}",
      "body": "Hi {{firstName}},\n\nJust wanted to follow up on my last email...",
      "delayDays": 3,
      "delayHours": 0,
      "sendOnlyIfNoReply": true,
      "createdAt": "2025-01-10T08:05:00",
      "updatedAt": "2025-01-10T08:05:00"
    }
  ]
}
```

## Errors

| Status | Description |
|--------|-------------|
| `404` | Campaign not found |

## Rate Limit

- **300 requests per minute, shared by every `read` call in your workspace.** Fixed 60-second window.
- Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` (unix epoch seconds) and `X-RateLimit-Bucket` (`read`).
- A `429` response includes a `Retry-After` header (seconds until the bucket resets).

For client-side patterns (`Retry-After`, exponential backoff, monitoring `X-RateLimit-Remaining`), see [Rate Limiting](https://www.foxreach.io/docs/rate-limiting).
