---
title: "List treasury contacts"
method: GET
path: "/v1/multisig-wallets/{walletId}/contacts"
tags: ["Multisig Wallets"]
---

# List treasury contacts

`GET /v1/multisig-wallets/{walletId}/contacts`

## Request

- Base URL: `https://api.prod.keyban.io`
- URL: `https://api.prod.keyban.io/v1/multisig-wallets/{walletId}/contacts`
- Auth: one of:
  - API key in header `X-Api-Key`
  - `bearer` (a scheme the document does not define)

List the named destinations this treasury can transfer to. Archived contacts are left out: they can no longer receive anything, and only exist to keep naming the transfers they already received.

## Path parameters

- `walletId` string, uuid, required

## Response `200`

List of contacts retrieved successfully

- PaginatedMultisigContactDtoOutput
  - `data` object[], required: Array of items for the current page
    - `id` string, uuid, required: Entity UUID
    - `createdAt` string, date-time, required: Creation date (ISO 8601)
    - `updatedAt` string, date-time, required: Last update date (ISO 8601)
    - `label` string, required: Name a signer gave this destination. What one picks in the transfer form, and what the signer app shows instead of a bare address.
    - `address` string, required: Destination address, 0x-prefixed 20 bytes. Stored lowercase; a mixed-case input has its EIP-55 checksum verified on the way in.
    - `archivedAt` string, date-time, nullable, required: When the contact was retired. An archived contact can no longer receive a transfer, but still names the past transfers that went to it. Null while it stands.
    - `lastUsedAt` string, date-time, nullable, required: When a transfer to this contact last EXECUTED — never when one was merely opened, so a cancelled transfer does not make an address look familiar. Null means never used, which the signer app calls out.
  - `total` integer, required: Total count of items matching the query

## Other responses

- `404`: Multisig wallet not found

---

[API](https://skmtc.dev/keyban/apis/keyban-rest-apis.md) · [All operations](https://skmtc.dev/keyban/apis/keyban-rest-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/keyban/apis/keyban-rest-apis/revisions/0bb79a1da961?raw)