Fetch a client (members and loop staff)
Fetches one client with its profile, status, commission override and the merchant it settles to.
/v1/clients/{clientId}Fetches one client with its profile, status, commission override and the merchant it settles to. 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).
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
uuidResponse 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"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "merchant_id": "500924a8-3f5e-4c00-beb8-2efcde988aea", "org_alias": "string", "display_name": "string", "category": "string", "description": "string", "logo_url": "string", "commission_bps": 0, "status": "pending", "approved_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z"}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,...
Update the client's public identity
Replaces the client's public identity — display name, category, description and logo — as Explore shows it.