List campaign creators (v1 legacy)

GET /sdk/v1/campaigns/:campaignId/creators

Returns the original campaign creator record used by existing SDK v1 clients. The response includes creator profile, role, media, payout, contract, and operational fields in one object.

Existing clients can continue using this endpoint without changing their response parsing. Use the v2 creator list for new integrations and a smaller response.

All requests require X-Application-Id and X-Api-Key.

Query parameters

page (optional): page number, starting at 1. Default: 1.
limit (optional): creators per page. Default: 100; maximum: 100.
startDate and endDate (optional): an inclusive YYYY-MM-DD range. Send both or neither.
search or query (optional): searches creator names and email addresses.
includeHidden (optional): set to true to include hidden campaign creators.
sortBy (optional): creatorName, totalViews, totalLikes, totalComments, totalShares, or cpmResultValue.
sortOrder (optional): asc or desc.

The v1 endpoint always returns the legacy record. It does not project the response with a fields parameter.

Response fields

Each item may include:

Creator: creatorName, creatorProfileId, creatorImage, creatorEmail, isVerified, isRetainer, isHidden, testPhaseCreator, campaignCreatorRecordId
Role: roleName, rolePay, rolePayFrequency, rolePayFrequencyTimePeriod, roleColor
Payment: payoutType, campaignPaymentStatus, pendingValue, pendingManualBonusValue, spentValue, currency, invoiceId, hasCancelledPayout, installments, paidThroughUploadDate, waitingVideoCount
Media and performance: contentUrls, mediaCount, totalViews, totalLikes, totalComments, totalShares, cpmResultValue
Contract: contractId, fixed-rate, CPM, crosspost, bonus, pay-cycle, and payment-template fields
Operational: fixed-media history, sheet-sync overrides, accrual cutoff, and score-calculation state

Fields without a value may be null or omitted. paidThroughUploadDate is the last upload day (YYYY-MM-DD) the creator’s contract is paid through: the latest day a reserved, settled, or ambiguous payout covers. waitingVideoCount counts the tracked videos uploaded after that day. When nothing is paid yet, paidThroughUploadDate is null and waitingVideoCount counts every tracked video. Both are null when the creator has no contract history.

Example response

{
  "success": true,
  "data": [
    {
      "creatorName": "Jordan Lee",
      "creatorProfileId": "CP_123",
      "creatorImage": "https://example.com/jordan.jpg",
      "creatorEmail": "[email protected]",
      "isVerified": true,
      "isRetainer": false,
      "isHidden": false,
      "payoutType": "HYBRID",
      "campaignPaymentStatus": "PARTIALLY_PAID",
      "pendingValue": 550,
      "spentValue": 300,
      "currency": "USD",
      "paidThroughUploadDate": "2026-05-31",
      "waitingVideoCount": 1,
      "contentUrls": ["https://www.tiktok.com/@jordan/video/123"],
      "mediaCount": 4,
      "totalViews": 50000,
      "totalLikes": 3000,
      "totalComments": 200,
      "totalShares": 100,
      "fixedRate": 300,
      "performanceRate": 5,
      "campaignCreatorRecordId": "CCR_123"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 100,
    "total": 1,
    "totalPages": 1
  },
  "effectiveTimeZone": "America/New_York"
}

effectiveTimeZone is the IANA timezone Grade uses for campaign business dates after applying the campaign override, agency fallback, and final UTC fallback.

Common errors

400: invalid date range
401: missing or invalid SDK credentials
404: campaign not found

​GET /sdk/v1/campaigns/:campaignId/creators

​Query parameters

​Response fields

​Example response

​Common errors

GET /sdk/v1/campaigns/:campaignId/creators

Query parameters

Response fields

Example response

Common errors