Endpoints
Providers
Seller profiles, verification requests, ratings and payout destinations.
/v1/providersScope providers:read. The result depends on your key: a provider key sees itself, and a workspace key sees verified sellers only (the same rule discovery uses).
/v1/providers/:idScope providers:read. One provider: name, verified, status (pending_verification, active or suspended), reputation (0 to 1), website, and your own verification request (requested, approved or denied, with note, reason and timestamps).
/v1/providers/:id/verification-requestScope providers:read, owner only. Asks to be verified. Body is optional: { note?, contact? }. Asking again while requested updates the request and keeps its place in the queue. Asking after a denial starts a new request. See Getting verified.
/v1/providers/:id/rateScope ratings:write (workspace key). Rates a seller for a purchase.
| Field | Type | Required |
|---|---|---|
transactionId | string, from the receipt | yes |
rating | integer 1–5 | yes |
raterWalletId | string, your wallet that paid | yes |
raterAgentId | string | no |
Your wallet must hold a receipt for that transaction, from this provider. One rating per transaction. Returns 404 if there's no receipt, 403 if it's not your purchase or the wrong provider, and 400 if it's already rated or out of range.
/v1/providers/:id/payout-destinationScope payouts:write, owner only. Registers where payouts go.
| Field | Type | Required | Notes |
|---|---|---|---|
destination | string | yes | ext_… for bank rails, a 0x… address for USDC |
asset | "USD" | "USDC" | no | |
chain | "base" | no | for USDC |
The first registration is usable immediately. A change freezes payouts for that rail and asset for 24 hours and sends an alert.
/v1/providers/:id/payout-destinationsScope payouts:write, owner only. The registered destinations, one per chain and asset, with when each becomes usable.