What this client sold, and what it kept
The client's own trading history: a summary (sales, gross, fees, marketplace commission, refunded and net, plus subscriber count) followed by a page of individual sales, newest first by created_at,...
/v1/clients/{clientId}/salesThe client's own trading history: a summary (sales, gross, fees, marketplace commission, refunded and net, plus subscriber count) followed by a page of individual sales, newest first by created_at, ties broken by the payment id so a page boundary never skips or repeats a sale. Needs authority over the client — membership of its organization, an API key bound to this client, or tenant staff holding clients:manage; anything else is refused not_client_member or insufficient_scope (403), and an unknown client client_not_found (404). Cursor paged: pass the last id you saw as cursor; limit is clamped to 1-100 and defaults to 50.
Authorization
bearerAuth A tenant API key (sk_{env}_{id}_{secret}), a wallet user token, or an IdP access token. Which principal the credential resolves to decides the scopes it carries; see the authentication guide.
In: header
Path Parameters
uuidQuery Parameters
Last seen id from the previous page. The listing resumes after that row, so an id that belongs to no row in the listing is refused invalid_request (400) rather than answered with an empty page.
uuid1 <= value <= 10050Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/clients/497f6eca-6276-4993-bfeb-53cbbbba6f08/sales"{ "summary": { "sales": 0, "gross": 0, "fees": 0, "commission": 0, "refunded": 0, "net": 0, "subscribers": 0 }, "sales": [ { "payment_id": "d43b87f9-9e28-4802-8eaa-6ee91a40ea71", "order_id": "93101167-9065-4b9c-b98b-5d789a3ed9fe", "offering_id": "a7d124b6-6a8c-44d1-9d46-4636e3f8c04e", "title": "string", "amount": 0, "fee": 0, "commission": 0, "refunded": 0, "net": 0, "status": "string", "created_at": "2019-08-24T14:15:22Z" } ]}Self-serve ecosystem client onboarding (org + merchant + profile)
Self-serve onboarding: creates the identity-provider organization, the merchant with its settlement account and the public profile in one call.
Fetch a client (members and loop staff)
Fetches one client with its profile, status, commission override and the merchant it settles to.