[← Back to BAV docs](/products/account-verifications/openapi)

# United States

### Overview

table
tr
td
Available
td
Yes
tr
td
code
targetCurrency
td
United States Dollar (USD)
tr
td
code
countryCode
td
US
### Submission data

| API field name | Required? | Field length | Description |
|  --- | --- | --- | --- |
| `beneficiaryBankDetails.accountNumber` | ✅ | 9-17 | Account number of the beneficiary. |
| `beneficiaryBankDetails.bankCode` | ✅ | 9 | The ABA Routing Code is a 9-digit number used to identify the beneficiary bank in the United States. Ensure that you use a valid ABA Routing Code and not a Fedwire code, otherwise your payment will be rejected.  |
| `beneficiaryBankDetails.swiftBic` | Conditional | 8 or 11 | The SWIFT BIC is the Bank Identification Code of the beneficiary bank. Must be used only for JPM Bank. |
| `beneficiaryBankDetails.bankName` | ✅ | Max 30 | Name of the beneficiary bank. |
| `parties.partyType` | ✅ | N/A | Type of the party.**Must be**:`beneficiary` |
| `parties.accountType` | ✅ | N/A | Type of the account.**Available values:**`checking``savings``moneyMarket``certificateOfDeposit``vista``other` |
| `parties.accountHolderName` | Conditional | Max 50 | Beneficiary full  name. Full name should be provided (no initials).  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/A | Entity description code for the party.**Available values**:`company``person``soleTrader``institution``government``other` |
| `parties.personalDetails.title` | Conditional | N/A | Title code for the Individual.**Available values**:`ms``mrs` `mr``dr``mx``misc` Mandatory if `parties.personalDetails.type` is:`person`  |
| `parties.personalDetails.firstName` | Conditional | Max 50 | Beneficiary first name. Full name should be provided (no initials). Mandatory if `parties.personalDetails.type` is:`person`  |
| `parties.personalDetails.middleName` | ❌ | Max 50 | Beneficiary middle name. |
| `parties.personalDetails.lastName` | Conditional | Max 50 | Beneficiary last name. Full name should be provided (no initials). Mandatory if `parties.personalDetails.type` is:`person`  |
| `parties.personalDetails.companyName` | Conditional | Max 140 | Full name of the organization. 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.   Mandatory if `parties.personalDetails.type` is:`company``institution``government``other`  |
| `parties.personalDetails.dateOfBirth` | ❌ | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
| `parties.personalDetails.dateOfIncorporation` | ❌ | 10 | A `company`s date of incorporation in YYYY-MM-DD format. |
| `parties.address.address1` | ❌ | Max 35 | Beneficiary'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 35 | Beneficiary'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 35 | Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address. |
| `parties.address.state` | ❌ | 2 | Beneficiary's state code of residential address (if payee is an individual) or registered address (if payee is a company).  Beginning of July 25, 2022 the inclusion of the State information is required as part of the Beneficiary address.  |
| `parties.address.postalCode` | ❌ | 5-9 | Beneficiary'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` | ✅ | 2 | Beneficiary's country of their residential (if payee is an individual) or registered (if payee is a company) address.  Mandatory if any of the optional Beneficiary address details are provided. Enter the [2 character ISO 3166-1 standard country code](/products/reference/supported-countries-currencies#iso-country-codes) in your API request.  |