# Quickstart: Campaign Manager (v2)

This walkthrough lists your campaigns and downloads a basic CSV report for one of them, using the v2 Campaign Manager API.

For credentials, the OAuth flow, error handling, and rate limits, see **[Getting Started](/docs/getting-started)**. This page assumes you already have a valid access token.

> **Starting fresh?** New integrations should prefer the **[Distribution Manager (v3) Quickstart](/docs/quickstart-distributions)**. v2 remains fully supported, but v3 reflects current naming and is the long-term API surface.


## 1. List your campaigns


```bash
curl --request GET \
  --url [Your API Base URL]/v2/campaign-manager/campaigns \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

A successful response looks like this:


```json
{
  "pageNumber": 1,
  "pageSize": 20,
  "totalItems": 1,
  "data": [
    {
      "id": "1a2b3c4d-e5f6-7890-1234-567890abcdef",
      "name": "Your Campaign Name",
      "businessEntity": "Talli"
      // ... other campaign fields
    }
  ]
}
```

Copy the `id` of the campaign you want to report on.

## 2. Download a basic campaign report (CSV)

Use the campaign ID from step 1. Note the `Accept: text/csv` header and the `--output` flag to save the file:


```bash
curl --request GET \
  --url '[Your API Base URL]/v2/campaign-manager/reports/campaigns/YOUR_CAMPAIGN_ID/basic?pageNumber=1&pageSize=1000' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Accept: text/csv' \
  --output campaign_report.csv
```

*Replace `YOUR_CAMPAIGN_ID` with the ID you copied.*

This saves a `campaign_report.csv` file in your current directory.

## Next steps

For the full set of v2 endpoints — payout instructions, bank accounts, transfers, templates, reports, and more — see the **Campaign Manager v2** API Reference in the sidebar.