Agency

Export Agency Usage Report

get

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

Agency Public Checkout

get

Creates a Stripe Checkout session for unauthenticated users (prospects) to purchase credits and become sub-accounts of an agency.

This endpoint is public — no authentication required. It is designed for shareable payment links that agencies can distribute to potential sub-accounts.

Flow:

1. Agency shares the checkout URL with query params agencyId and tierIndex

2. Endpoint validates params, fetches agency pricing config

3. Creates a Stripe Checkout session on the agency's own Stripe account (BYOK)

4. Redirects (303) to the Stripe hosted checkout page

5. Stripe collects the buyer's email and name

6. On payment success, a Firebase Auth user and Firestore doc are created automatically

7. A welcome email with a temporary password is sent to the buyer

Authorizations

ApiKeyAuthUserIdAuth

apiKeystringRequired

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

Query parameters

agencyIdstringRequired

Firebase UID of the agency

Example: fHjQASIIzfUcrvuAvaYWdDd65Bu2

tierIndexintegerRequired

Zero-based index into the agency's credit pricing tiers

Example: 0

Responses

303

Redirect to Stripe Checkout hosted page

400

Missing or invalid parameters

text/plain

404

Agency not found

text/plain

500

Internal server error

text/plain

get

/checkout

HTTPcURLJavaScriptPython

GET /v1/checkout?agencyId=text&tierIndex=1 HTTP/1.1
Host: api.dmchamp.com
Accept: */*

No content