---
title: "Add Bank Account"
method: POST
path: "/off-ramp/bank-accounts"
tags: ["off-ramp"]
---

# Add Bank Account

`POST /off-ramp/bank-accounts`

## Headers

- `Authorization-Signature` string, required

## Request body

- AddBankAccountRequest
  - `account_name` string
  - `account_owner_name` string, required
  - `address` BankAccountAddress, required
    - `street_line_1` string, required
    - `street_line_2` string, nullable
    - `city` string, required
    - `state` string, nullable
    - `postal_code` string, nullable
    - `country` string, required
  - `bank_name` string, required
  - `account_owner_type` 'individual' | 'business' — Whether the bank account owner is an individual or business
  - `first_name` string
  - `last_name` string
  - `business_name` string
  - `currency` 'usd' | 'eur' | 'mxn' | 'brl' | 'gbp', required — Currency used by the external bank account
  - `account_type` 'us' | 'iban' | 'swift' | 'clabe' | 'pix' | 'gb', required — Bank account rail: us (ACH), iban, swift, clabe, pix, or gb (FPS)
  - `account` BankAccount
    - `account_number` string, required
    - `routing_number` string, nullable
    - `sort_code` string, nullable
    - `checking_or_savings` 'checking' | 'savings' — US account subtype for ACH accounts
  - `iban` IBANBankAccount
    - `account_number` string, required
    - `country` string, required
    - `bic` string, nullable
  - `swift` SWIFTBankAccount
    - `account` SWIFTAccountInfo, required
      - `account_number` string, nullable
      - `country` string, nullable
      - `bic` string, nullable
    - `address` BankAccountAddress, required
      - `street_line_1` string, required
      - `street_line_2` string, nullable
      - `city` string, required
      - `state` string, nullable
      - `postal_code` string, nullable
      - `country` string, required
    - `category` 'client' | 'parent_company' | 'subsidiary' | 'supplier', required — Relationship category for SWIFT external accounts
    - `purpose_of_funds` string[], required
    - `short_business_description` string, required
  - `clabe` CLABEBankAccount
    - `account_number` string, required
  - `pix` PIXBankAccount
    - `document_number` string, nullable
    - `pix_key` string, nullable
    - `br_code` string, nullable

## Response `201`

Bank account created

- BankAccountDetails
  - `id` string, required
  - `account_name` string, nullable
  - `bank_name` string, nullable
  - `account_type` 'us' | 'iban' | 'swift' | 'clabe' | 'pix' | 'gb', required — Bank account rail: us (ACH), iban, swift, clabe, pix, or gb (FPS)
  - `account_owner_type` 'individual' | 'business' — Whether the bank account owner is an individual or business
  - `account_details` AccountDetails, required
    - `bank_name` string, nullable
    - `routing_number` string, nullable
    - `sort_code` string, nullable
    - `account_number` string, required
    - `checking_or_savings` string, nullable
    - `bic` string, nullable
    - `pix_key` string, nullable
  - `currency` 'usd' | 'eur' | 'mxn' | 'brl' | 'gbp', required — Currency used by the external bank account
  - `active` boolean, required
  - `beneficiary_address_valid` boolean, nullable
  - `deactivation_reason` string, nullable
  - `deactivation_details` string, nullable

## Other responses

- `401` — Unauthorized
- `404` — Organization verification not found
- `422` — Invalid request body or validation failed

---

[API](https://skmtc.net/coinvoyage/apis/coinvoyage-api-v3.md) · [All operations](https://skmtc.net/coinvoyage/apis/coinvoyage-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coinvoyage/coinvoyage-api-v3/revisions/d166bf9d9ca2/schema)