The clients the caller may manage
A consumer gets the clients its organization memberships cover, which is how a founder finds their own client after onboarding.
/v1/clientsA consumer gets the clients its organization memberships cover, which is how a founder finds their own client after onboarding. Staff holding clients:manage get the loop's clients instead, optionally by status.
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
Query Parameters
A self-onboarded client starts pending: it can build its profile and draft offerings, but nothing reaches Explore until the platform approves it. Suspended hides its catalog again without touching its money.
Value in
- "pending"
- "active"
- "suspended"
1 <= value <= 10050Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/clients"[ { "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" }]Upload one image and get the URL to store on a profile or offering
Stores one image in the deployment's object store and answers with its public URL, which you then pass as logo_url or image_url on a separate profile or offering write; uploading alone changes noth...
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.