Payouts

List due creator payouts

Returns completed billing periods that have no recorded payouts yet. Uses campaign billing anchors and creator assignment windows to surface only fully finished periods.

get/payouts/due

Request

  • Base URL: https://viral.app/api/v1
  • URL: https://viral.app/api/v1/payouts/due
  • Auth: API key in header x-api-key

Query parameters

pagenumber

Page number (1-based index)

Example:1
perPagenumber

Number of items per page (1-100)

Example:10
sortColstring

Sort column

Example:publishedAt
sortDir'asc' | 'desc'

Sort direction

Example:asc
campaignIdsstring[] 
[
  "orgcamp_RwmraAffhMt9"
]
creatorIdsstring[]
includeEmptyboolean

Include zero-amount payouts in the results. They are excluded by default.

mode'data' | 'count' | 'totals'
referenceDatestring date-time

Response

OK

pageinteger required
perPageinteger required
totalinteger required
distinctCreatorCountinteger

Example response

{
  "data": [
    {
      "campaignId": "orgcamp_RwmraAffhMt9",
      "campaignStatus": "active",
      "timeZone": "UTC",
      "warnings": [
        {
          "accounts": [
            {
              "platform": "facebook",
              "platformAccountId": "7123456789012345678"
            }
          ]
        }
      ],
      "startsAt": "2026-10-05T00:00:00.000-04:00",
      "endsAt": "2026-10-12T00:00:00.000-04:00"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.