- Bank Accounts
- Create a bank account
Bank Accounts
Create a bank account
Create an ACH or EFT bank account for a taxpayer.
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"
}'
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.
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"
}'
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"
}'