marketplace
GET /v1/marketplace/vendor/payouts/{payout_id}/statement
One paid payout's statement — also the self-billed invoice.
Authentication
Send an API key as a bearer token. This endpoint checks no specific permission, so any key for your organisation can call it.
This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.
Try it
Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.
curl -X GET https://api.zinndigital.com/v1/marketplace/vendor/payouts/{payout_id}/statement \
-H "Authorization: Bearer zdk_live_…"Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console
Details
docs/78 §11.4 + §13.2. Every paid payout has a statement listing each sale (gross, commission, net), the at-cost provider fee, what reached the seller, the method and the provider's reference. Under self-billing it doubles as the seller's invoice to us, numbered from the gapless SBI series. ⛔ A payout that is not paid has no statement (404), and another seller's payout is a 404, never a 403.
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
payout_id (path) | Uuid | Yes | — |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
payout_id | Uuid | Yes | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
statement_number | string | Yes | — |
issued_at | string | Yes | — |
currency | CurrencyCode | Yes | ISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8). |
supplier | object | Yes | The seller — the supplier on a self-billed invoice. |
customer | object | Yes | Our issuing legal entity — the customer on a self-billed invoice. |
vat_treatment | string<not_registered, registered_domestic, registered_reverse_charge, unknown> | Yes | — |
lines | object[] | Yes | — |
total_owed_minor | integer | Yes | — |
fee_minor | integer | Yes | — |
paid_minor | integer | Yes | — |
method | string | Yes | — |
destination | string | No | The destination MASKED — never the full address. |
external_ref | string | No | — |
credit_only | boolean | Yes | True when paid as Zinn® account credit — spend-only (owner ruling 2026-10-25): it is spent on hosting, plugins and services and is never withdrawn or converted to cash. |
Errors this endpoint can return
401 · 404