# Quickstart: Distribution Manager (v3)

This walkthrough lists your distributions and downloads a basic CSV report for one of them, using the v3 Distribution 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.

## 1. List your distributions


```bash
curl --request GET \
  --url [Your API Base URL]/v3/distribution-manager/distributions \
  --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 Distribution Name",
      "businessEntity": "Talli"
      // ... other distribution fields
    }
  ]
}
```

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

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

Use the distribution 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]/v3/distribution-manager/reports/distributions/YOUR_DISTRIBUTION_ID/basic?pageNumber=1&pageSize=1000' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Accept: text/csv' \
  --output distribution_report.csv
```

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

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

## Next steps

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