---
title: "Add a bank account to an account"
method: POST
path: "/v2/accounts/{account_id}/bank-account"
tags: ["Bank account management"]
---

# Add a bank account to an account

`POST /v2/accounts/{account_id}/bank-account`

## Request

- Base URL: `https://marketplace-api.dlocal.com`
- URL: `https://marketplace-api.dlocal.com/v2/accounts/{account_id}/bank-account`
- Auth: API key in header `X-Date` and API key in header `X-Login` and API key in header `X-Trans-Key` and API key in header `X-Version` and API key in header `User-Agent` and API key in header `Authorization`

Adds a new bank account to an existing account.

## Path parameters

- `account_id` string, required

## Request body

- union
  - LocalBankAccount
    - `bank` object
      - `code` string, required: See `bank_codes` details from Payouts in the [Country requirements](doc:country-requirements-payouts) article.
      - `country` string, required: Bank account's country. ISO 3166-1 alpha-2 code.
      - `currency` string, required: Bank account currency. Three-letter ISO-4217 currency code, in uppercase.
      - `account_number` string, required: Bank account’s number.
      - `type` string, required: Type of account. <br><br>Possible values: `INTERNATIONAL` or `LOCAL`.
      - `branch` string: Bank account branch.
      - `account_type` string, required: Bank account’s type. <br><br>Possible values: `CHECKING`, `SAVING`, `PIX_PHONE`, `PIX_EMAIL`, `PIX_BANK_ACCOUNT`, or `PIX_DOCUMENT_ID`.
      - `swift` string: Bank account swift number.
      - `beneficiary` object
        - `name` string, required: Bank account beneficiary's first name or company name.
        - `last_name` string: Bank account beneficiary’s last name. Requested if the account’s profile is individual.
        - `document_id` string, required: Beneficiary's document ID.
        - `document_type` string, required: Beneficiary's document type.
        - `address` string, required: Beneficiary's address.
        - `phone` string, required: Beneficiary's phone number. <br><br>Length: 20.
        - `email` string: Beneficiary's email address.
  - InternationalBankAccount
    - `bank` object
      - `code` string: See `bank_codes` details from Payouts in the [Country requirements](doc:country-requirements-payouts) article.
      - `country` string, required: Bank account's country. ISO 3166-1 alpha-2 code.
      - `currency` string, required: Bank account currency. Three-letter ISO-4217 currency code, in uppercase.
      - `account_number` string, required: Bank account’s number.
      - `type` string, required: Type of account. <br><br>Possible values: `INTERNATIONAL` or `LOCAL`.
      - `branch` string: Bank account branch.
      - `account_type` string, required: Bank account’s type. <br><br>Possible values: `CHECKING`, `SAVING`, `PIX_PHONE`, `PIX_EMAIL`, `PIX_BANK_ACCOUNT`, or `PIX_DOCUMENT_ID`.
      - `swift` string, required: Bank account swift number.
      - `beneficiary` object
        - `name` string, required: Bank account beneficiary's first name or company name.
        - `last_name` string: Bank account beneficiary’s last name. Requested if the account’s profile is individual.
        - `document_id` string: Beneficiary's document ID.
        - `document_type` string: Beneficiary's document type.
        - `address` string: Beneficiary's address.
        - `phone` string: Beneficiary's phone number. <br><br>Length: 20.
        - `email` string: Beneficiary's email address.

## Response `201`

OK

- ResponseBankAccount
  - `account_id` string: User’s dLocal account ID.
  - `status` string: Bank account status. <br><br> [See details](ref:bank-status-v2-platforms).
  - `status_code` number: Bank account status code. <br><br> It could be 200 (active) or 300 (inactive)
  - `status_detail` string: Bank account status detail.
  - `creation_date` string, date: Bank account creation's timestamp. ISO-8601 - Notification’s timestamp (YYYY-MM-DDTHH:mm:ss.SSSSZ)
  - `bank_account_id` string: Bank account ID assigned by dLocal.

## Other responses

- `400`: Bad request

---

[API](https://skmtc.dev/dlocal/apis/platforms.md) - [All operations](https://skmtc.dev/dlocal/apis/platforms/llms.txt) - [OpenAPI document](https://skmtc.dev/dlocal/apis/platforms/revisions/4be9adbbfce5?raw)