Get Customer
One customer of the workspace, by id.
Takes a workspace-scoped API key or a dashboard session. An account-scoped key is refused with 401.
Replaces GET /api/v2/accounts/{id}.
Authorization:
Every request is signed with your API key: a short-lived JWT, signed with your private key, sent in one header on /v3/* and /api/v2/* alike.
Headers:
Authorization: APIKey {SIGNED_JWT}
How to build and sign the JWT: Authentication.
Endpoint
/v3/customers/{customer_id}
Path parameters
| Parameter | Type | Description |
|---|---|---|
customer_id | string (cst_…) | Required. The customer. |
To find a customer by its reference, search for it with q on List Customers.
Response Sample
{
"id": "cst_01k8x40x9gfx6sv8a99hswy9bd",
"reference": "019a3a40-7530-7f4d-9da1-494c73cf256d",
"name": "Samantha Reyes",
"email": "samantha@example.com",
"customer_type": "individual",
"status": "active",
"phone": "+14155550123",
"verification_status": "approved",
"created_at": "2025-10-31T12:31:34Z",
"updated_at": "2025-11-02T09:14:05Z"
}
Response Schema
A customer, with the fields of a List Customers item.
Errors
| Status | message | When |
|---|---|---|
400 | failed to parse request | customer_id is not a cst_… TypeID. |
401 | unauthorized | Missing or invalid signature, or the caller is an account-scoped key or a customer session. |
403 | forbidden | A dashboard member whose role does not allow this. A workspace-scoped key always may. |
404 | customer_not_found | No such customer in this workspace. |
Coming from v2
v2 (GET /api/v2/accounts/{id}) | v3 |
|---|---|
{id}: the account's uuid or its reference | {customer_id}: the cst_… id only; search by reference with List Customers q |
accountType, accountName | customer_type, name |
firstName, lastName | not returned |
createdAt, updatedAt | created_at, updated_at |
| none | verification_status, phone, blocked_at, frozen_at |
Support and Resources
If you need assistance or have any questions, our support team is here to help. You can contact our support team at support@blockwyre.com.
Stay Updated
Stay up-to-date with the latest news, updates, and features from BlockWyre by following us on social media:
- Instagram: BlockWyre Instagram
- Twitter: BlockWyre Twitter
- Facebook: BlockWyre Facebook
- LinkedIn: BlockWyre LinkedIn
We are excited to have you on board and look forward to seeing how you leverage BlockWyre's powerful tools to enhance your financial operations. Happy integrating!