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

> Retrieve a single bank account by ID, including its status, account details, and address.

**GET** `/api/external/bank_accounts/{bankAccountId}/`

Returns one bank account by its identifier. Use this to read the current status and exact account fields for a previously created bank account.

<Warning>
  Bank-account data is sensitive. Avoid logging full account and routing numbers, and preserve the organization or sub-org scope returned by the API.
</Warning>

## Path parameters

<ParamField path="bankAccountId" type="string" required>
  The bank account ID.
</ParamField>

## Response

```json theme={null}
{
  "id": "bank_account_123",
  "orgId": "org_456",
  "subOrgId": "sub_org_123",
  "orgEntityId": "org_entity_123",
  "createdById": "api_user_123",
  "createdAt": "2026-08-04T10:30:00Z",
  "updatedAt": "2026-08-04T10:30:00Z",
  "isDeleted": false,
  "status": "PENDING",
  "accountNumber": "111222333",
  "accountName": "Acme Corp",
  "routingNumber": "021000021",
  "clientBankAccountId": "erp-bank-001",
  "paymentMethod": "US_ACH",
  "bankName": "Chase",
  "streetLine": "270 Park Avenue",
  "city": "New York",
  "state": "NY",
  "postalCode": "10017",
  "country": "US"
}
```

## JavaScript SDK

```typescript theme={null}
getBankAccountById(bankAccountId: string): Promise<BankAccount>
```

<RequestExample dropdown>
  ```json Request example theme={null}
  {
    "path": {
      "bankAccountId": "bank_account_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/bank_accounts/bank_account_123/" \
    --header "Authorization: Bearer <signed JWT>" \
    --header "Api-Key: <API key>" \
    --header "Accept: application/json"
  ```

  ```typescript JavaScript SDK theme={null}
  getBankAccountById(bankAccountId: string): Promise<BankAccount>
  ```
</RequestExample>

<ResponseExample>
  ```json JSON example theme={null}
  {
    "id": "bank_account_123",
    "orgId": "org_456",
    "subOrgId": "sub_org_123",
    "orgEntityId": "org_entity_123",
    "createdById": "api_user_123",
    "createdAt": "2026-08-04T10:30:00Z",
    "updatedAt": "2026-08-04T10:30:00Z",
    "isDeleted": false,
    "status": "PENDING",
    "accountNumber": "111222333",
    "accountName": "Acme Corp",
    "routingNumber": "021000021",
    "clientBankAccountId": "erp-bank-001",
    "paymentMethod": "US_ACH",
    "bankName": "Chase",
    "streetLine": "270 Park Avenue",
    "city": "New York",
    "state": "NY",
    "postalCode": "10017",
    "country": "US"
  }
  ```
</ResponseExample>


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