> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.

# List Wallets

> Every wallet attached to a customer record

Returns the customer's primary wallet and every additional wallet linked to them, oldest first.

## Path Parameters

<ParamField path="customerId" type="string" required>Customer record ID.</ParamField>

## Response Fields

<ResponseField name="data" type="object">
  <Expandable>
    <ResponseField name="primary" type="string">The primary wallet address, or `null` when the record has none.</ResponseField>
    <ResponseField name="total" type="integer">Wallets in the list, primary included.</ResponseField>

    <ResponseField name="wallets" type="array">
      <Expandable>
        <ResponseField name="address" type="string">The wallet.</ResponseField>
        <ResponseField name="label" type="string">A label. The primary is always labelled `Primary`.</ResponseField>
        <ResponseField name="isPrimary" type="boolean">Whether this is the primary wallet.</ResponseField>
        <ResponseField name="addedAt" type="string">ISO 8601. For the primary this is when the customer record was created.</ResponseField>
        <ResponseField name="id" type="string">The link record ID. Absent on the primary, which is a field on the customer rather than a link.</ResponseField>
        <ResponseField name="addedBy" type="string">Who linked it. Absent on the primary.</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<Note>
  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.
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.trusset.org/customers/api/manage/cus_abc123/wallets" \
    -H "X-API-Key: trusset_your_key_here"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "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"
        }
      ]
    }
  }
  ```
</ResponseExample>

## 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                            |