Skip to content
Last updated

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. This page assumes you already have a valid access token.

1. List your distributions

curl --request GET \
  --url [Your API Base URL]/v3/distribution-manager/distributions \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

A successful response looks like this:

{
  "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:

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.

Previous page
Next page