List campaign creator line items

POST /sdk/v1/campaign-creators/line-items/query

Returns the calculated payment items for specific campaign creators or for one campaign. Each media item includes its URL and campaignCreatorMediaId. All requests require X-Application-Id and X-Api-Key.

Choose creators

Send exactly one of:

campaignCreatorRecordIds: up to 500 campaign creator record IDs.
campaignId: one campaign. You can also send page and limit; limit defaults to 100 and cannot exceed 500.

Optional fields

startDate and endDate: an inclusive YYYY-MM-DD payment range. Send both or neither.
includeNonPayable: include items that are not currently payable and the reason for each. Default: true.

Example request

curl -sS "$BASE_URL/sdk/v1/campaign-creators/line-items/query" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Application-Id: $APP_ID" \
  -H "X-Api-Key: $API_KEY" \
  -d '{
    "campaignCreatorRecordIds": ["CCR_123", "CCR_456"],
    "startDate": "2026-07-01",
    "endDate": "2026-07-31",
    "includeNonPayable": true
  }'

To read a campaign one page at a time, use this body instead:

{
  "campaignId": "camp_123",
  "page": 1,
  "limit": 500,
  "startDate": "2026-07-01",
  "endDate": "2026-07-31"
}

Response

{
  "success": true,
  "data": [
    {
      "campaignId": "camp_123",
      "campaignName": "Summer launch",
      "campaignCreatorRecordId": "CCR_123",
      "creatorProfileId": "CP_123",
      "creatorEmail": "[email protected]",
      "effectiveTimeZone": "America/New_York",
      "dateRange": {
        "startDate": "2026-07-01",
        "endDate": "2026-07-31"
      },
      "currency": "USD",
      "totalAmount": 550,
      "paymentBreakdown": {
        "fixed": 300,
        "cpm": 250,
        "bonus": 0,
        "total": 550
      },
      "lineItems": [
        {
          "campaignCreatorMediaId": "CCMEDIA_123",
          "url": "https://www.tiktok.com/@jordan/video/123",
          "platform": "TIKTOK",
          "uploadedAt": "2026-07-08",
          "paymentType": "CPM",
          "amount": 250,
          "currency": "USD",
          "payable": true
        },
        {
          "campaignCreatorMediaId": "CCMEDIA_456",
          "url": "https://www.instagram.com/p/example/",
          "platform": "INSTAGRAM",
          "uploadedAt": "2026-07-10",
          "paymentType": "BONUS",
          "amount": 0,
          "currency": "USD",
          "payable": false,
          "reason": "The post has not reached a bonus tier."
        }
      ]
    }
  ],
  "failures": [],
  "pagination": {
    "page": 1,
    "limit": 2,
    "total": 2,
    "totalPages": 1
  }
}

Each result includes the campaign’s effectiveTimeZone, resolved from the campaign override, agency fallback, or UTC. The dateRange and media business dates should be interpreted in that IANA timezone.

Bonus tiers do not stack. If the tiers pay 10 at 1,000 views and 50 at 10,000 views, a post with 50,000 views earns 50—not 60.

An unknown or inaccessible creator is returned in failures without stopping the rest of the request.

Common errors

400: invalid selector, more than 500 creators, or incomplete date range
401: missing or invalid SDK credentials
404: selected campaign not found

SDK v1

Campaign management

List campaign creator line items

POST /sdk/v1/campaign-creators/line-items/query

Choose creators

Optional fields

Example request

Response

Common errors

​POST /sdk/v1/campaign-creators/line-items/query

​Choose creators

​Optional fields

​Example request

​Response

​Common errors

POST /sdk/v1/campaign-creators/line-items/query

Choose creators

Optional fields

Example request

Response

Common errors