Clip Rewards Claims

A Claim is created when a clipper enrolls a published clip in a Clip Rewards campaign (via publish). Each claim tracks view count and accrued earnings.

Claims follow a 7-day cooling-off period: views accrued in the last 7 days are pending and may still be revised (fraud check, takedown, etc.). Older views are eligible to be swept into your pending balance via the POST endpoint.

GET /api/v1/clip-rewards/claims

Returns the authenticated user's claims.

{
  "data": [
    {
      "id": "crw_clm_xxx",
      "campaignId": "crw_cmp_xxx",
      "clipId": "clip_xxx",
      "platform": "tiktok",
      "rawViews": 124500,
      "verifiedViews": 121200,
      "pendingUsd": 12.18,
      "sweptUsd": 0,
      "status": "cooling",
      "coolsDownAt": "2026-08-18T10:10:00Z",
      "createdAt": "2026-08-11T10:10:00Z"
    }
  ],
  "pendingBalanceUsd": 48.23
}

POST /api/v1/clip-rewards/claims

Sweep all cooled claims into the user's pending balance. Claims still in the cooling-off window are skipped. Returns the amount swept.

{
  "sweptUsd": 12.18,
  "sweptClaimCount": 1,
  "pendingBalanceUsd": 60.41
}

Once swept, funds are withdrawable via POST /v1/clip-rewards/payout. The clip_reward.paid webhook is fired for each swept claim.

Example

curl -X POST https://pepe.business/api/v1/clip-rewards/claims \
  -H "Authorization: Bearer pk_live_xxx"