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

> Retrieve a single vault by ID, including its wallets, asset, and sub-org.

**GET** `/api/external/vaults/{vaultId}/`

## Path parameter

<ParamField path="vaultId" type="string" required>
  ID returned by a vault list or create response.
</ParamField>

## Response

Vault, including `wallets`, optional nullable `asset`, and optional `subOrgId`.

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

  ```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/vaults/vault_ngn_business/" \
    --header "Authorization: Bearer <signed JWT>" \
    --header "Api-Key: <API key>" \
    --header "Accept: application/json"
  ```

  ```typescript JavaScript SDK theme={null}
  const vault = await apiClient.getVaultById("vault_ngn_business");
  console.log(vault.id, vault.asset); // vault_ngn_business, NGN
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "vault_ngn_business",
    "orgId": "org_456",
    "subOrgId": "sub_org_123",
    "vaultName": "NGN Business Account",
    "vaultType": "DEFAULT",
    "asset": "NGN",
    "wallets": [],
    "walletsGenerated": false,
    "createdAt": "2026-09-27T10:00:00Z",
    "updatedAt": "2026-09-27T10:00:00Z",
    "isDeleted": false
  }
  ```
</ResponseExample>


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