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

# Create US bank account

> Register a US ACH bank account for a client.

<Warning>
  **Deprecated.** This endpoint is no longer available in the public API and is kept for reference only.
</Warning>

Creates a new US bank account for the specified client with ACH transfer capabilities. Requires an API key with access level 3 or higher.

## Path parameters

<ParamField path="clientId" type="string" required>
  Unique identifier of the client.
</ParamField>

## Body

<ParamField body="bank_name" type="string">
  Name of the bank.
</ParamField>

<ParamField body="account_alias" type="string">
  User-friendly alias for the account.
</ParamField>

<ParamField body="bank_holder_name" type="string">
  Account holder's full name.
</ParamField>

<ParamField body="account_number" type="string">
  US bank account number.
</ParamField>

<ParamField body="routing_number" type="string">
  US 9-digit routing number.
</ParamField>

<ParamField body="account_type" type="string">
  Account type. One of `CHECKING`, `SAVINGS`.
</ParamField>

<ParamField body="address" type="object">
  Account holder's address with `street_line_1`, `street_line_2`, `city`, `postal_code`, `state`, `country`.

  `state` uses ISO 3166-2 codes that identify country subdivisions in the format `{COUNTRY}-{SUBDIVISION}` (e.g., `USA-CA` for California).
</ParamField>

## Response

<ResponseField name="id" type="string">
  Bank account identifier.
</ResponseField>

<ResponseField name="company_id" type="string">
  Company identifier.
</ResponseField>

<ResponseField name="client_id" type="string">
  Client identifier.
</ResponseField>

<ResponseField name="bank_name" type="string">
  Bank name.
</ResponseField>

<ResponseField name="bank_holder_name" type="string">
  Account holder full name.
</ResponseField>

<ResponseField name="account_alias" type="string">
  User-friendly alias.
</ResponseField>

<ResponseField name="type" type="string">
  Payment rail. `ACH` for US accounts.
</ResponseField>

<ResponseField name="currency" type="string">
  Account currency. `USD` for US accounts.
</ResponseField>

<ResponseField name="account_number" type="string">
  Account number.
</ResponseField>

<ResponseField name="routing_number" type="string">
  Routing number.
</ResponseField>

<ResponseField name="account_type" type="string">
  Account type.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.cryptomate.me/management/clients/client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d/banks/us" \
    -H "x-api-key: $CRYPTOMATE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "bank_name": "Chase Bank",
      "account_alias": "Primary Checking",
      "bank_holder_name": "John Michael Doe",
      "account_number": "123456789",
      "routing_number": "021000021",
      "account_type": "CHECKING",
      "address": {
        "streetLine1": "123 Main Street",
        "city": "San Francisco",
        "postal_code": "94102",
        "state": "USA-CA",
        "country": "USA"
      }
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "ba_abc123",
    "company_id": "comp_6f1e2a30-4a3c-4b2e-9a1d-5e8c9b7a1f23",
    "client_id": "client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "bank_name": "Chase Bank",
    "bank_holder_name": "John Michael Doe",
    "account_alias": "Primary Checking",
    "type": "ACH",
    "currency": "USD",
    "account_number": "123456789",
    "routing_number": "021000021",
    "account_type": "checking"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "code": "NOT_FOUND",
    "message": "Client does not have a customer ID for provider BRIDGE"
  }
  ```
</ResponseExample>