Skip to content
APIs/
/
North America
/
United States

← Back to BAV docs

United States

Overview

AvailableYes
targetCurrencyUnited States Dollar (USD)
countryCodeUS

Submission data

API field nameRequired?Field lengthDescription
instructions.party.payoutInstrument.accountNumber✅9-17Account number of the beneficiary.
instructions.party.payoutInstrument.bankCode✅9The ABA Routing Code is a 9-digit number used to identify the beneficiary bank in the United States.
Important
Ensure that you use a valid ABA Routing Code and not a Fedwire code, otherwise your payment will be rejected.
instructions.party.payoutInstrument.swiftBicConditional8 or 11The SWIFT BIC is the Bank Identification Code of the beneficiary bank. Must be used only for JPM Bank.
instructions.party.payoutInstrument.bankName✅Max 30Name of the beneficiary bank.
instructions.party.type✅N/AType of the party.
Must be:
  • beneficiary
instructions.party.payoutInstrument.accountType✅N/AType of the account.
Available values:
  • checking
  • savings
  • moneyMarket
  • certificateOfDeposit
  • vista
  • other
instructions.party.payoutInstrument.accountHolderNameConditionalMin 2 and Max 70Beneficiary full name. You must provide the full name (not initials). Name must be between 2 and 70 characters, including spaces and any other characters. Additionally, both the first name and last name must not individually exceed 35 characters, including spaces and any other characters. We treat any character or word after the first space in the name as part of the last name. For example, in the name "John Michael Doe", the first name is "John" and the last name is "Michael Doe".
Condition
Mandatory if instructions.party.personalDetails.type is person and instructions.party.personalDetails.firstName and/or instructions.party.personalDetails.lastName are not provided.

Or if instructions.party.personalDetails.type is company and the instructions.party.personalDetails.companyName is not provided.
instructions.party.personalDetails.type✅N/AEntity description code for the party.
Available values:
  • company
  • person
  • soleTrader
  • institution
  • government
  • other
instructions.party.personalDetails.titleConditionalN/ATitle code for the Individual.
Available values:
  • ms
  • mrs
  • mr
  • miss
  • dr
  • mx
  • misc
Condition
Mandatory if instructions.party.personalDetails.type is:
  • person
instructions.party.personalDetails.firstNameConditionalMax 35Beneficiary first name. Full name should be provided (no initials).
Condition
Mandatory if instructions.party.personalDetails.type is:
  • person
instructions.party.personalDetails.middleName❌Max 35Beneficiary middle name.
instructions.party.personalDetails.lastNameConditionalMax 35Beneficiary last name. Full name should be provided (no initials).
Condition
Full Name (First + Middle + Last name) must be between 2 and 70 characters, including spaces and any other characters.

Mandatory if instructions.party.personalDetails.type is:
  • person
instructions.party.personalDetails.companyNameConditionalMax 70Full name of the organization.
Condition
Mandatory if instructions.party.personalDetails.type is:
  • company
  • institution
  • government
  • other
instructions.party.personalDetails.dateOfBirth❌10Beneficiary's date of birth in YYYY-MM-DD format.
instructions.party.personalDetails.dateOfIncorporation❌10A company`s date of incorporation in YYYY-MM-DD format.
instructions.party.address.address1❌Max 35Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street.
instructions.party.address.address2❌Max 35Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
instructions.party.address.city❌Max 35Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
instructions.party.address.state❌2Beneficiary's state code of residential address (if payee is an individual) or registered address (if payee is a company).
instructions.party.address.postalCode❌5-9Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
instructions.party.address.countryCode✅2Beneficiary's country of their residential (if payee is an individual) or registered (if payee is a company) address.
Condition
Mandatory if any of the optional Beneficiary address details are provided. Enter the 2 character ISO 3166-1 standard country code in your API request.