Agency

Export Agency Usage Report

get

https://api.dmchamp.com/v1https://us-central1-whatzaidev.cloudfunctions.net/api/v1

/agencies/usage/export

Export credit usage data for all sub-accounts as a CSV file.

Requires Agency or Dev role. This endpoint only accepts apiKey authentication (userId is not supported).

Returns a downloadable CSV file with columns: Sub Account ID, Sub Account Email, Sub Account Name, Date, Amount, Reason, Campaign Name, Contact Name, Credit Type, Custom Keys Used, Description, AI Model.

Authorizations

ApiKeyAuth

apiKeystringRequired

Your DM Champ API key. Obtain from Settings → API Keys.

Query parameters

apiKeystringOptional

API key for authentication. At least one of apiKey or userId is required for protected endpoints.

Example: your_api_key

fromstring · dateOptional

Start date for the report range (YYYY-MM-DD). Defaults to 30 days ago.

Example: 2024-01-01

tostring · dateOptional

End date for the report range (YYYY-MM-DD). Defaults to today.

Example: 2024-01-31

subAccountIdstringOptional

Filter report to a specific sub-account ID. If omitted, all sub-accounts are included.

Example: uid123abc

Responses

200

CSV usage report downloaded successfully

text/csv

stringOptional

CSV file with agency usage data. Headers: Sub Account ID, Sub Account Email, Sub Account Name, Date, Amount, Reason, Campaign Name, Contact Name, Credit Type, Custom Keys Used, Description, AI Model

400

Invalid date format or date range

application/json

401

Invalid or missing API key

application/json

403

Authenticated user is not an Agency or Dev account

application/json

500

Internal server error

application/json

get

/agencies/usage/export

HTTPcURLJavaScriptPython

GET /v1/agencies/usage/export HTTP/1.1
Host: api.dmchamp.com
Accept: */*

text