Create payouts in one request
/api/v2/payouts/batchCreates up to 100 payouts. Each item is a POST /payouts body, andThen included. All or nothing: one failing item fails the request with that item's code and error.index, and nothing is applied. Needs payouts:write, plus payouts:approve when any item sets andThen.
idempotency-key?stringClient-chosen key, 1 to 255 characters (a UUID is recommended). The same key on the same endpoint within 24 hours replays the stored response with Idempotent-Replayed: true.
1 <= length <= 255application/json- body
payouts*array<>1 to 100 payouts, each the body of POST /payouts. The response lists them in this order.
1 <= items <= 100Success
application/json- response
object*"list"Type of the object. Always list.
"list"data*array<>Every item. This list is never paged.
curl -X POST 'https://www.talentir.com/api/v2/payouts/batch' \ -H 'Content-Type: application/json' \ -d '{ "payouts": [ { "description": "string", "amount": "100.00", "currency": "USD", "recipient": { "type": "email", "email": "jane@example.com" } } ]}'{ "object": "list", "data": [ { "object": "payout", "id": "payout_0e4ba886-0bfe-4b6a-ae2e-d6d9d135dd1e", "customId": "campaign-42", "description": "string", "amount": "100.00", "currency": "USD", "recipient": { "type": "email", "email": "jane@example.com", "phone": "string" }, "status": "created", "locked": true, "availableOn": "2026-10-01", "availableInDays": -9007199254740991, "servicePeriod": { "start": "2026-10-01", "end": "2026-10-01" }, "expiresAt": "2026-09-24T10:00:00.000Z", "tags": [ "string" ], "paymentMethod": { "type": "crypto", "asset": "string", "currency": "EUR" }, "withInvoice": true, "senderInvoiceUrl": "string", "recipientInvoiceUrl": "string", "recipientInvoiceSource": "self_billing", "failureCode": "account_closed", "failureReason": "string", "approvedAt": "2026-09-24T10:00:00.000Z", "recipientNotifications": "enabled", "claimLinkSentAt": "2026-09-24T10:00:00.000Z", "requestedAt": "2026-09-24T10:00:00.000Z", "retry": { "url": "string", "code": "account_closed", "reason": "string" }, "completedAt": "2026-09-24T10:00:00.000Z", "createdAt": "2026-09-24T10:00:00.000Z", "updatedAt": "2026-09-24T10:00:00.000Z" } ]}Create a payout POST
Creates a payout in status `created`. `andThen` runs approval, and then `send-claim-link` or `pay`, in the same request and fails with their codes. Needs `payouts:write`, plus `payouts:approve` when `andThen` is set.
Get a payout GET
`{id}` is the payout id or your `customId`. Needs `payouts:read`.