Fetch a wallet user
Fetches one wallet user. Requires users:read.
/v1/users/{userId}Fetches one wallet user. Requires users:read. An API key may read any user in the tenant; a user token may read only itself and is refused forbidden (403) for anyone else. An unknown id gives user_not_found (404). A staff read is recorded in the sensitive-read access log.
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/users/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "external_id": "string", "kind": "consumer", "display_name": "string", "phone": "string", "email": "user@example.com", "handle": "string", "status": "string", "created_at": "2019-08-24T14:15:22Z"}Create or attach a wallet user
Creates a wallet user, or attaches one to an identity you already have.
List a user's balances per account purpose
One row per account purpose and commodity, each with balance, held and available, as the tenant's ledger of record reports them; held is money reserved by an authorization that has not been captured.