ReferencePayouts

List

Retrieve a list of payouts for the authenticated team.

GET/payouts

Retrieve a list of payouts for the authenticated team.

Authorization

AuthorizationBearer <token>

Team API key generated from team settings. Sent as Authorization: Bearer <api_key>.

In: header

Query Parameters

offset?integer

Number of items to skip

Range0 <= value <= 9007199254740991
Default0
limit?integer

Number of items to return. Maximum is 100.

Range1 <= value <= 100
Default50
order_by?"created_at"

Field to order results by

Default"created_at"

Value in

  • "created_at"
order_direction?string

Order direction: 'asc' or 'desc'

Default"desc"

Value in

  • "asc"
  • "desc"

Response Body

application/json

curl -X GET "https://example.com/payouts"
[  {    "id": "0e4ba886-0bfe-4b6a-ae2e-d6d9d135dd1e",    "uuid": "0e4ba886-0bfe-4b6a-ae2e-d6d9d135dd1e",    "customId": "campaign-42",    "description": "Payment for YouTube channel campaign",    "amount": "100.00",    "currency": "EUR",    "createdAt": "2026-06-20T10:00:00.000Z",    "updatedAt": "2026-06-20T10:00:00.000Z",    "creatorHandle": "@mrbeast",    "verificationMethod": "youtube-channel",    "tags": [],    "payoutType": "manual",    "status": "created",    "notifications": "allowed"  }]

Get GET

Retrieve a specific payout by ID or custom ID. By default, the endpoint expects an ID. To query by custom ID instead, add the query parameter `id_type=custom_id`. Examples: - Get by ID: `GET /payout/{id}` - Get by custom ID: `GET /payout/{custom_id}?id_type=custom_id`

Payout POST

Audience: the payout RECIPIENT — the creator/rightsholder being paid, who is not a member of the authenticated team. Validate a payout for the authenticated team and return a Talentir URL to send to that recipient: they sign in or sign up with their own email (inferred from the payout) and claim the payout. No team membership is required.