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

# Retrieve a Contact

> Retrieve a single contact by ID, including its blockchain, address, status, tags, and assets.

**GET** `/api/external/contacts/{contactId}/`

## Path parameters

<ParamField path="contactId" type="string" required>
  The unique contact identifier.
</ParamField>

## Response

```json theme={null}
{
  "id": "contact_123",
  "orgId": "org_456",
  "subOrgId": "sub_org_123",
  "name": "Operations Wallet",
  "blockChain": "ETHEREUM",
  "address": "0xAbC1234567890abcdef1234567890abcdef1234",
  "status": "PENDING",
  "tags": [
    "vendor",
    "priority"
  ],
  "createdById": "api_user_123",
  "externalId": "vendor-1001",
  "assetList": [
    "USDC",
    "ETH"
  ],
  "createdAt": "2026-08-04T10:30:00Z",
  "updatedAt": "2026-08-04T10:30:00Z",
  "isDeleted": false
}
```

## JavaScript SDK

```typescript theme={null}
const contact = await apiClient.getContactById("contact_123");
```

<RequestExample dropdown>
  ```json Request example theme={null}
  {
    "path": {
      "contactId": "contact_123"
    }
  }
  ```

  ```bash cURL theme={null}
  # Sample only. Generate a new signed token for each request
  # (see Authentication). Tokens expire after 120 seconds.
  curl --request GET \
    --url "https://api.primevault.com/api/external/contacts/contact_123/" \
    --header "Authorization: Bearer <signed JWT>" \
    --header "Api-Key: <API key>" \
    --header "Accept: application/json"
  ```

  ```typescript JavaScript SDK theme={null}
  getContactById(contactId: string): Promise<Contact>
  ```
</RequestExample>

<ResponseExample>
  ```json JSON example theme={null}
  {
    "id": "contact_123",
    "orgId": "org_456",
    "subOrgId": "sub_org_123",
    "name": "Operations Wallet",
    "blockChain": "ETHEREUM",
    "address": "0xAbC1234567890abcdef1234567890abcdef1234",
    "status": "PENDING",
    "tags": [
      "vendor",
      "priority"
    ],
    "createdById": "api_user_123",
    "externalId": "vendor-1001",
    "assetList": [
      "USDC",
      "ETH"
    ],
    "createdAt": "2026-08-04T10:30:00Z",
    "updatedAt": "2026-08-04T10:30:00Z",
    "isDeleted": false
  }
  ```
</ResponseExample>


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