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

# South Korea

### Overview

table
tr
td
Available
td
Yes
tr
td
code
targetCurrency
td
Korean Won (KRW)
tr
td
code
countryCode
td
KR
### Submission data

| API field name | Required? | Field length | Description |
|  --- | --- | --- | --- |
| `beneficiaryBankDetails.accountNumber` | ✅ | Max 20 | Account number of the beneficiary. |
| `beneficiaryBankDetails.bankCode` | ❌ | Max 35 | Bank code of the beneficiary (bank). |
| `beneficiaryBankDetails.branchCode` | ❌ | Max 35 | Branch code of the beneficiary (bank). |
| `beneficiaryBankDetails.swiftBic` | ✅ | 8 or 11 | The SWIFT BIC is the Bank Identification Code of the beneficiary bank. |
| `beneficiaryBankDetails.bankName` | ✅ | Max 35 | 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` |
| `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.postalCode` | ❌ | Max 10 | 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](/access/products/reference/supported-countries-currencies#iso-country-codes) in your API request.  |