WalletD developers
Platform administration

Ecosystem clients across all tenants, the review queue (global admin only)

Ecosystem clients across every tenant — the moderation queue.

GET/v1/platform/clients

Ecosystem clients across every tenant — the moderation queue. Filter by status and by tenant. Requires a platform staff token holding platform:read, which only the global admin role carries; everyone else, including platform provisioning staff, is refused global_read_only (403). The read is recorded in the cross-tenant access log. Cursor paged: pass the last id you saw as cursor; limit is clamped to 1-100 and defaults to 50.

Authorization

bearerAuth
AuthorizationBearer <token>

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

tenant_id?string

Restrict a cross-tenant listing to one tenant

Formatuuid
status?string

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"
cursor?string

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.

Formatuuid
limit?integer
Range1 <= value <= 100
Default50

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/platform/clients"
[  {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "tenant_id": "34f5c98e-f430-457b-a812-92637d0c6fd0",    "tenant_name": "string",    "merchant_id": "500924a8-3f5e-4c00-beb8-2efcde988aea",    "org_alias": "string",    "display_name": "string",    "category": "string",    "status": "pending",    "approved_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z"  }]

Whole-platform ledger view — every tenant's position and health (global admin only)

One row per tenant with its user count, 30-day movement, treasury float, outstanding liabilities and whether its books net to zero, plus totals per currency.

Let a pending client publish to Explore (platform staff only)

Lets a pending client publish its offerings to Explore.