1. Bank Accounts
  2. Create a bank account
POST
/v1/taxpayers/{taxpayerId}/bank-accounts
curl --request POST \
     --url https://public-api.sandbox.remitian.com/v1/taxpayers/{taxpayerId}/bank-accounts \
     --header 'Authorization: Bearer <token>' \
     --header 'x-api-key: <x_api_key>' \
     --header 'Content-Type: application/json' \
     --data '{
  "paymentNetwork": "Ach",
  "bankAccountName": "string",
  "accountNumber": "string",
  "externalId": "string",
  "routingNumber": "string",
  "institutionNumber": "string",
  "transitNumber": "string"
}'

​
Authorizations

bearerAuth
required
string
Access token from POST /v1/auth/token, sent as `Authorization: Bearer {accessToken}`.

​
Query Parameters

taxpayerId
required
string

Unique identifier of the taxpayer.

x-api-key
required
string

API key of your Client Application.

​
Body

application/json
paymentNetwork
required
string

The payment network. Determines required fields: Ach -> routingNumber; Eft -> institutionNumber + transitNumber.

bankAccountName
required
string

A display name for the bank account.

accountNumber
required
string

The bank account number.

externalId
string

Optional external identifier provided by the client.

routingNumber
string

The 9-digit ACH routing number (required when paymentNetwork is Ach).

institutionNumber
string

The 3-digit EFT institution number (required when paymentNetwork is Eft).

transitNumber
string

The 5-digit EFT transit number (required when paymentNetwork is Eft).

​
Response

application/json
  • 201

  • 400

  • 401

  • 403

  • 404

  • 409

Created

id
string

The unique identifier of the resource.

externalId
string

The external identifier provided by the client.