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

# List Campaigns

> Returns all campaigns for the authenticated user, optionally filtered by status.

## Headers

<ParamField header="token" type="string" required>
  Your LinkedCamp API token.
</ParamField>

## Query Parameters

<ParamField query="status" type="string">
  Filter campaigns by status. You can pass multiple statuses separated by commas.

  Available values: `PENDING`, `ACTIVE`, `PAUSED`, `DRAFTED`, `COMPLETED`, `FAILED`, `ARCHIVED`

  Example: `status=ACTIVE` or `status=ACTIVE,PAUSED`
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Whether the request was successful.
</ResponseField>

<ResponseField name="message" type="string">
  A human-readable result message.
</ResponseField>

<ResponseField name="total" type="number">
  Total number of campaigns returned.
</ResponseField>

<ResponseField name="data" type="array">
  Array of campaign objects.

  <Expandable title="Campaign Properties">
    <ResponseField name="_id" type="string">
      Campaign ID.
    </ResponseField>

    <ResponseField name="title" type="string">
      Campaign name.
    </ResponseField>

    <ResponseField name="url" type="string">
      LinkedIn search URL associated with the campaign.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current campaign status.
    </ResponseField>

    <ResponseField name="total" type="number">
      Total number of leads in the campaign.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.linkedcamp.com/campaigns?status=ACTIVE" \
    -H "token: YOUR_API_TOKEN"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.linkedcamp.com/campaigns",
      headers={"token": "YOUR_API_TOKEN"},
      params={"status": "ACTIVE"},
  )
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://api.linkedcamp.com/campaigns?status=ACTIVE",
    {
      headers: { "token": "YOUR_API_TOKEN" },
    }
  );
  const data = await response.json();
  console.log(data);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "message": "ACTIVE campaigns found successfully!",
    "total": 2,
    "data": [
      {
        "_id": "60f7a1b2c3d4e5f6a7b8c9d0",
        "title": "Outreach Campaign",
        "url": "https://www.linkedin.com/search/results/people/...",
        "status": "ACTIVE",
        "total": 150
      }
    ]
  }
  ```

  ```json 200 - No results theme={null}
  {
    "success": false,
    "message": "Compaigns not found!"
  }
  ```
</ResponseExample>