Wallets
List Wallets
Every wallet attached to a customer record
GET
/
customers
/
api
/
manage
/
{customerId}
/
wallets
curl "https://api.trusset.org/customers/api/manage/cus_abc123/wallets" \
-H "X-API-Key: trusset_your_key_here"
{
"success": true,
"data": {
"primary": "0xAbCdEf0123456789AbCdEf0123456789AbCdEf01",
"total": 2,
"wallets": [
{
"address": "0xAbCdEf0123456789AbCdEf0123456789AbCdEf01",
"label": "Primary",
"isPrimary": true,
"addedAt": "2026-08-01T09:00:00.000Z"
},
{
"id": "clw_7f2a",
"address": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52",
"label": "Custody account",
"isPrimary": false,
"addedAt": "2026-09-01T11:30:00.000Z",
"addedBy": "iss_xyz789"
}
]
}
}
Returns the customer’s primary wallet and every additional wallet linked to them, oldest first.
Path Parameters
string
required
Customer record ID.
Response Fields
object
Show child attributes
Show child attributes
string
The primary wallet address, or
null when the record has none.integer
Wallets in the list, primary included.
array
Show child attributes
Show child attributes
string
The wallet.
string
A label. The primary is always labelled
Primary.boolean
Whether this is the primary wallet.
string
ISO 8601. For the primary this is when the customer record was created.
string
The link record ID. Absent on the primary, which is a field on the customer rather than a link.
string
Who linked it. Absent on the primary.
The primary wallet is a field on the customer record, not a link row, which is why it carries no
id or addedBy. It is always first in the list when one is set.curl "https://api.trusset.org/customers/api/manage/cus_abc123/wallets" \
-H "X-API-Key: trusset_your_key_here"
{
"success": true,
"data": {
"primary": "0xAbCdEf0123456789AbCdEf0123456789AbCdEf01",
"total": 2,
"wallets": [
{
"address": "0xAbCdEf0123456789AbCdEf0123456789AbCdEf01",
"label": "Primary",
"isPrimary": true,
"addedAt": "2026-08-01T09:00:00.000Z"
},
{
"id": "clw_7f2a",
"address": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52",
"label": "Custody account",
"isPrimary": false,
"addedAt": "2026-09-01T11:30:00.000Z",
"addedBy": "iss_xyz789"
}
]
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
NOT_FOUND | 404 | No such customer on your instance, or the record is archived |
FETCH_FAILED | 500 | The wallet list could not be read |
⌘I
curl "https://api.trusset.org/customers/api/manage/cus_abc123/wallets" \
-H "X-API-Key: trusset_your_key_here"
{
"success": true,
"data": {
"primary": "0xAbCdEf0123456789AbCdEf0123456789AbCdEf01",
"total": 2,
"wallets": [
{
"address": "0xAbCdEf0123456789AbCdEf0123456789AbCdEf01",
"label": "Primary",
"isPrimary": true,
"addedAt": "2026-08-01T09:00:00.000Z"
},
{
"id": "clw_7f2a",
"address": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52",
"label": "Custody account",
"isPrimary": false,
"addedAt": "2026-09-01T11:30:00.000Z",
"addedBy": "iss_xyz789"
}
]
}
}