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
beneficiaryBankDetails.accountNumber✅9-17Account number of the beneficiary.
beneficiaryBankDetails.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.
beneficiaryBankDetails.swiftBicConditional8 or 11The SWIFT BIC is the Bank Identification Code of the beneficiary bank. Must be used only for JPM Bank.
beneficiaryBankDetails.bankName✅Max 30Name of the beneficiary bank.
parties.partyType✅N/AType of the party.
Must be:
  • beneficiary
parties.accountType✅N/AType of the account.
Available values:
  • checking
  • savings
  • moneyMarket
  • certificateOfDeposit
  • vista
  • other
parties.accountHolderNameConditionalMax 50Beneficiary full name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.type is person and parties.personalDetails.firstName and/or parties.personalDetails.lastName are not provided.

Or if parties.personalDetails.type is Company and the parties.personalDetails.companyName is not provided.
parties.personalDetails.type✅N/AEntity description code for the party.
Available values:
  • company
  • person
  • soleTrader
  • institution
  • government
  • other
parties.personalDetails.titleConditionalN/ATitle code for the Individual.
Available values:
  • ms
  • mrs
  • mr
  • dr
  • mx
  • misc
Condition
Mandatory if parties.personalDetails.type is:
  • person
parties.personalDetails.firstNameConditionalMax 50Beneficiary first name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.type is:
  • person
parties.personalDetails.middleName❌Max 50Beneficiary middle name.
parties.personalDetails.lastNameConditionalMax 50Beneficiary last name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.type is:
  • person
parties.personalDetails.companyNameConditionalMax 140Full name of the organization.
Warning
Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager.
Condition
Mandatory if parties.personalDetails.type is:
  • company
  • institution
  • government
  • other
parties.personalDetails.dateOfBirth❌10Beneficiary's date of birth in YYYY-MM-DD format.
parties.personalDetails.dateOfIncorporation❌10A companys date of incorporation in YYYY-MM-DD format.
parties.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.
parties.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.
parties.address.city❌Max 35Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.state❌2Beneficiary's state code of residential address (if payee is an individual) or registered address (if payee is a company).
Important
Beginning of July 25, 2022 the inclusion of the State information is required as part of the Beneficiary address.
parties.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.
parties.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.