> ## Documentation Index
> Fetch the complete documentation index at: https://docs.foxreach.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Campaign

> Retrieve a single campaign with its sequence steps.

## Path Parameters

<ParamField path="campaign_id" type="string" required>
  The unique identifier of the campaign.
</ParamField>

## Response

Returns the campaign object with an additional `sequences` array containing the email sequence steps.

<ResponseField name="data" type="object">
  Campaign object with sequences.

  <Expandable title="Sequence step object">
    <ResponseField name="id" type="string">Sequence step identifier.</ResponseField>
    <ResponseField name="campaignId" type="string">Parent campaign ID.</ResponseField>
    <ResponseField name="stepNumber" type="integer">Step order (1, 2, 3...).</ResponseField>
    <ResponseField name="name" type="string">Step name.</ResponseField>
    <ResponseField name="subject" type="string">Email subject line.</ResponseField>
    <ResponseField name="body" type="string">Email body (supports variables like `{{firstName}}`).</ResponseField>
    <ResponseField name="delayDays" type="integer">Days to wait after previous step.</ResponseField>
    <ResponseField name="delayHours" type="integer">Hours to wait after previous step.</ResponseField>
    <ResponseField name="sendOnlyIfNoReply" type="boolean">Skip if lead has replied.</ResponseField>
    <ResponseField name="createdAt" type="string">ISO 8601 timestamp.</ResponseField>
    <ResponseField name="updatedAt" type="string">ISO 8601 timestamp.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.foxreach.io/api/v1/campaigns/cmp_abc123" \
    -H "X-API-Key: otr_your_key"
  ```

  ```python Python SDK theme={null}
  from foxreach import FoxReach

  client = FoxReach(api_key="otr_your_key")
  campaign = client.campaigns.get("cmp_xyz789")
  ```

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

  const client = new FoxReach({ apiKey: "otr_your_key" });
  const campaign = await client.campaigns.get("cmp_xyz789");
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "data": {
      "id": "cmp_abc123",
      "name": "Q1 Outreach",
      "status": "active",
      "timezone": "America/New_York",
      "sendingDays": [1, 2, 3, 4, 5],
      "sendingStartHour": 9,
      "sendingEndHour": 17,
      "dailyLimit": 50,
      "sentToday": 12,
      "context": null,
      "totalLeads": 500,
      "totalSent": 234,
      "totalDelivered": 230,
      "totalBounced": 4,
      "totalReplied": 18,
      "totalOpened": 87,
      "createdAt": "2025-01-10T08:00:00",
      "updatedAt": "2025-01-15T10:30:00",
      "startedAt": "2025-01-10T09:00:00",
      "completedAt": null,
      "sequences": [
        {
          "id": "csq_001",
          "campaignId": "cmp_abc123",
          "stepNumber": 1,
          "name": "Initial outreach",
          "subject": "Quick question about {{company}}",
          "body": "Hi {{firstName}},\n\nI noticed...",
          "delayDays": 0,
          "delayHours": 0,
          "sendOnlyIfNoReply": true,
          "createdAt": "2025-01-10T08:00:00",
          "updatedAt": "2025-01-10T08:00:00"
        },
        {
          "id": "csq_002",
          "campaignId": "cmp_abc123",
          "stepNumber": 2,
          "name": "Follow-up",
          "subject": "Re: Quick question about {{company}}",
          "body": "Hi {{firstName}},\n\nJust following up...",
          "delayDays": 3,
          "delayHours": 0,
          "sendOnlyIfNoReply": true,
          "createdAt": "2025-01-10T08:05:00",
          "updatedAt": "2025-01-10T08:05:00"
        }
      ]
    }
  }
  ```
</ResponseExample>

## Rate Limit

* **100 requests per minute, per API key.** Fixed 60-second window.
* Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` (unix epoch seconds).
* 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](/rate-limiting).
