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

# List campaigns

## 📄 List Campaigns

Returns a list of all campaigns for a company.

### 📤 Request Example

```bash theme={null}
curl -X GET https://betaapi.audiohook.com/v2/companies/:companyUUID/campaigns?page=0&size=1 \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "request_headers": [
      { "name": "X-Request-Header", "value": "Header value" }
    ]
  }'
```

### 🌐 HTTP Request

```http theme={null}
GET /v2/companies/:companyUUID/campaigns
```

### 🧾 Query Parameters

| Parameter           | Default | Type    | Description                                                         |
| ------------------- | ------- | ------- | ------------------------------------------------------------------- |
| page                | 0       | int     | The page of campaigns to return.                                    |
| size                | 100     | int     | The total number of campaigns to be returned.                       |
| q                   | None    | string  | Search by campaign name.                                            |
| archive             | false   | boolean | Return archived or non-archived campaigns.                          |
| status              | all     | string  | Filter by status: `active-running`, `active`, `inactive`, or `all`. |
| startDate           | -1      | string  | Start date in `Y-M-D` format. Defaults to `-1` (all).               |
| endDate             | -1      | string  | End date in `Y-M-D` format. Defaults to `-1` (all).                 |
| order\_by           | None    | string  | Order by a key like `name-ORDER`.                                   |
| data                | true    | boolean | Include impressions, spend, conversions, and cost per conversion.   |
| campaign\_ids\_data | None    | string  | Comma-separated campaign IDs to include in response.                |

***