All documentation
Documentation
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.
All requests require X-Application-Id and X-Api-Key.
Query parameters
page(optional): page number, starting at1. Default:1.limit(optional): creators per page. Default:100; maximum:100.startDateandendDate(optional): an inclusiveYYYY-MM-DDrange. Send both or neither.searchorquery(optional): searches creator names and email addresses.includeHidden(optional): set totrueto include hidden campaign creators.sortBy(optional):creatorName,totalViews,totalLikes,totalComments,totalShares, orcpmResultValue.sortOrder(optional):ascordesc.
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": "jordan@example.com",
"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 range401: missing or invalid SDK credentials404: campaign not found
