---
title: "Create a Bank Relationship for an Account"
method: POST
path: "/v1/accounts/{account_id}/recipient_banks"
tags: ["Funding", "Accounts"]
---

# Create a Bank Relationship for an Account

`POST /v1/accounts/{account_id}/recipient_banks`

If successful, retrieves Bank Relationships for an account

## Path parameters

- `account_id` string, uuid, required

## Request body

- CreateBankRequest — Represents the possible fields to send when creating a new associated Bank resource for an account
  - `account_number` string, required
  - `bank_code` string, required — 9-Digit ABA RTN (Routing Number) or BIC
  - `bank_code_type` 'ABA' | 'BIC', required — ABA (Domestic) or BIC (International)
  - `city` string — Only for international banks, ie if bank_code_type = BIC
  - `country` string — Only for international banks, ie if bank_code_type = BIC
  - `extra_fields` BankAdditionalFields — Additional wire instructions used to explicitly specify intermediary (correspondent) banks for international wire transfers. If omitted, intermediary banks may be automatically selected by downstream institutions, which can result in delays or additional charges.
    - `intermediary_bank1_bic` string — The primary intermediary (correspondent) bank to be used when routing the international wire transfer to the beneficiary bank.
    - `intermediary_bank2_bic` string — An additional intermediary bank to be used if the wire transfer requires multiple correspondent banks before reaching the beneficiary bank.
    - `intermediary_bank3_bic` string — A tertiary intermediary bank used in complex international wire routes that require three correspondent banks prior to reaching the beneficiary bank.
  - `name` string, required — Name of recipient bank
  - `postal_code` string — Only for international banks, ie if bank_code_type = BIC. Minimum of 3 characters
  - `state_province` string — Only for international banks, ie if bank_code_type = BIC
  - `street_address` string — Only for international banks, ie if bank_code_type = BIC

## Response `200`

The created Bank relationship

- Bank
  - `account_id` string, uuid
  - `account_number` string, required
  - `bank_code` string, required — 9-Digit ABA RTN (Routing Number) or BIC
  - `bank_code_type` 'ABA' | 'BIC', required — ABA (Domestic) or BIC (International)
  - `city` string — Only for international banks
  - `country` string — Only for international banks
  - `created_at` string, date-time, required — Format: 2020-01-01T01:01:01Z
  - `extra_fields` BankAdditionalFields — Additional wire instructions used to explicitly specify intermediary (correspondent) banks for international wire transfers. If omitted, intermediary banks may be automatically selected by downstream institutions, which can result in delays or additional charges.
    - `intermediary_bank1_bic` string — The primary intermediary (correspondent) bank to be used when routing the international wire transfer to the beneficiary bank.
    - `intermediary_bank2_bic` string — An additional intermediary bank to be used if the wire transfer requires multiple correspondent banks before reaching the beneficiary bank.
    - `intermediary_bank3_bic` string — A tertiary intermediary bank used in complex international wire routes that require three correspondent banks prior to reaching the beneficiary bank.
  - `id` string, uuid, required
  - `name` string, required — Name of recipient bank
  - `postal_code` string — Only for international banks
  - `state_province` string — Only for international banks
  - `status` 'QUEUED' | 'SENT_TO_CLEARING' | 'APPROVED' | 'REJECTED' | 'CANCELED' — QUEUED, SENT_TO_CLEARING, APPROVED, REJECTED, CANCELED
  - `street_address` string — Only for international banks
  - `updated_at` string, date-time, required — Format: 2020-01-01T01:01:01Z

## Other responses

- `400` — Bad Request
- `409` — A Bank relationship already exists for this account

---

[API](https://skmtc.net/alpacahq/apis/gift-city-extensions-api.md) · [All operations](https://skmtc.net/alpacahq/apis/gift-city-extensions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alpacahq/gift-city-extensions-api/revisions/62e3378bb273/schema)