API and MCP reference

Payouts

2 operations. Each REST operation is also an MCP tool of the same name. REST https://tlntconnect.com/api/v1

GET/api/v1/payoutsList creator payouts, newest first, amounts in integer cents. Read only; admin members only.

Every creator payout of the workspace: id, creator {id, display_name}, campaign {id, name}, invoice_id, amount_cents, method, status, scheduled_date, paid_date, approved_at, failure_reason, transfer_status, notes, created_at, updated_at. Filter by status, creator_id or campaign_id; paged with page/limit (limit ≤ 100, default 50). Read only: approving, paying, releasing and direct pay are never available over the API (payments:execute is not grantable). Payee share links and bank/Stripe account details are never returned.

MCP tool
list_payouts
Scopes
finance:read
Members
admin
Idempotency-Key
Ignored (read)
Rate weight
1

Input

status query"pending" | "ready_to_pay" | "processing" | "completed" | "failed" | "needs_review"
creator_id querystring (uuid)
campaign_id querystring (uuid)
limit queryinteger — Page size, default 50.
page queryinteger — 1-based page, default 1.

Responses

200Success
400invalid_input / invalid_json / invalid_id
401missing_token / invalid_token / revoked_token / expired_token
403missing_scope / actor_unavailable / plan_upgrade_required / role_forbidden
404not_found (unknown, cross-workspace or not visible to the key's member)
429rate_limited (honour Retry-After)
500internal_error
503service_unavailable
GET/api/v1/payouts/{payout_id}One creator payout (amount in integer cents, status, dates). Read only; admin members only.

The list row for one payout. Another workspace's payout is 404.

MCP tool
get_payout
Scopes
finance:read
Members
admin
Idempotency-Key
Ignored (read)
Rate weight
1

Input

payout_id path, requiredstring (uuid) — Payout id in this workspace.

Responses

200Success
400invalid_input / invalid_json / invalid_id
401missing_token / invalid_token / revoked_token / expired_token
403missing_scope / actor_unavailable / plan_upgrade_required / role_forbidden
404not_found (unknown, cross-workspace or not visible to the key's member)
429rate_limited (honour Retry-After)
500internal_error
503service_unavailable