Creators

All endpoints below require:

X-Application-Id
X-Api-Key

All creator endpoints require an email query parameter. The creator must exist and be associated with the authenticated agency.

GET /sdk/v1/creators/receipts

List receipts for a creator.

Query parameters

email (required)
page (default 1)
limit (default 50, max 100)
search or query (optional; searches campaign name)
sortBy (optional): campaignName, payoutDate, earningsValue, status
sortOrder (optional): asc or desc

Response

{
  "success": true,
  "data": [
    {
      "invoiceId": "inv_...",
      "status": "PAID",
      "payoutDate": "2026-02-19T00:00:00.000Z",
      "earningsValue": 150,
      "campaignName": "Spring campaign",
      "currency": "USD"
    }
  ],
  "pagination": { "page": 1, "limit": 50, "totalPages": 1, "totalItems": 1 }
}

Common errors

400: missing/invalid email
404: creator not found for this agency

GET /sdk/v1/creators/total-paid

Get total paid to a creator, returning both USD and the agency preferred currency totals.

Query parameters

email (required)

Response

{
  "success": true,
  "data": {
    "email": "[email protected]",
    "spentAmountUSD": 100,
    "spentAmountPreferred": 141.32,
    "preferredCurrency": "CAD"
  }
}

GET /sdk/v1/creators/payouts

List payouts for a creator.

Query parameters

Same as GET /sdk/v1/payouts, plus:

email (required)

Response

{
  "success": true,
  "data": [{ "payoutId": "pay_...", "status": "claimed", "currency": "USD" }],
  "pagination": { "page": 1, "limit": 50, "totalPages": 1, "totalItems": 1 },
  "meta": { "bufferBusinessDays": 1, "accelerated": false, "bankClosedDates": [] }
}

SDK v1

Campaign management

GET /sdk/v1/creators/receipts

Query parameters

Response

Common errors

GET /sdk/v1/creators/total-paid

Query parameters

Response

GET /sdk/v1/creators/payouts

Query parameters

Response

​GET /sdk/v1/creators/receipts

​Query parameters

​Response

​Common errors

​GET /sdk/v1/creators/total-paid

​Query parameters

​Response

​GET /sdk/v1/creators/payouts

​Query parameters

​Response

GET /sdk/v1/creators/receipts

Query parameters

Response

Common errors

GET /sdk/v1/creators/total-paid

Query parameters

Response

GET /sdk/v1/creators/payouts

Query parameters

Response