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

# Blockchain Contacts

> Save external blockchain addresses as contacts, get them approved, and use them as destinations for transfers and payouts from your vaults.

A blockchain contact is a saved external wallet: a named address on a specific chain, such as a customer's or vendor's wallet. After your API user approves it, reference the contact by its `id` with `type: "CONTACT"` as the destination of a [transfer](/transactions/on-chain-operations/create-transfer) or [payout](/payment-flows/payout/payout-wallet), or as the source of an [LP vault deposit](/payment-flows/trade/deposit-into-lp-vault).

Each [Contact](/api-basics/data-models#contact) records:

* **Address:** `name`, `blockChain`, and `address`.
* **Permitted assets:** `assetList`, the assets the contact can be used with.
* **Your references:** `tags` and `externalId`. Filter lists by `name`, `status`, or `externalId`. See [Filtering and Pagination](/api-basics/filtering-and-pagination).
* **Screening:** `isSanctioned`, whether the address is flagged by sanctions screening.

To keep a contact inside a [sub-org](/sub-orgs/overview), pass `subOrgId` when you create it.

<Note>
  **Lifecycle:** Creating or updating a contact needs your API user's approval. The contact stays `PENDING` until it's approved, then moves to `APPROVED` or `DECLINED`. See [Approvals](/approvals/overview). After creation, you can change only `assetList` and `contactGroupIds`; a contact's name and address can't be changed.
</Note>

<CardGroup cols={2}>
  <Card title="List contacts" icon="list" href="/blockchain-contacts/list-contacts">
    **GET** `/api/external/contacts/`
  </Card>

  <Card title="Retrieve a contact" icon="magnifying-glass" href="/blockchain-contacts/retrieve-contact">
    **GET** `/api/external/contacts/{contactId}/`
  </Card>

  <Card title="Create a contact" icon="plus" href="/blockchain-contacts/create-contact">
    **POST** `/api/external/contacts/`
  </Card>

  <Card title="Update a contact" icon="pen" href="/blockchain-contacts/update-contact">
    **PUT** `/api/external/contacts/{contactId}/`
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.