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

# South Korea

### Overview

Available
Yes
targetCurrency
Korean Won (KRW)
countryCode
KR
### Submission data

| API field name | Required? | Field length | Description |
|  --- | --- | --- | --- |
| `instructions.party.payoutInstrument.accountNumber` | ✅ | Max 20 | Account number of the beneficiary. |
| `instructions.party.payoutInstrument.bankCode` | ❌ | Max 35 | Bank code of the beneficiary (bank). |
| `instructions.party.payoutInstrument.branchCode` | ❌ | Max 35 | Branch code of the beneficiary (bank). |
| `instructions.party.payoutInstrument.swiftBic` | ✅ | 8 or 11 | The SWIFT BIC is the Bank Identification Code of the beneficiary bank. |
| `instructions.party.payoutInstrument.bankName` | ✅ | Max 35 | Name of the beneficiary bank. |
| `instructions.party.type` | ✅ | N/A | Type of the party.**Must be**:`beneficiary` |
| `instructions.party.payoutInstrument.accountType` | ✅ | N/A | Type of the account.**Available values:**`checking``savings``moneyMarket``certificateOfDeposit``vista``other` |
| `instructions.party.payoutInstrument.accountHolderName` | Conditional | Min 2 and Max 70 | Beneficiary 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".   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/A | Entity description code for the party.**Available values:**`company``person``soleTrader``institution``government` |
| `instructions.party.personalDetails.title` | Conditional | N/A | Title code for the Individual.**Available values**:`ms``mrs` `mr``miss``dr``mx``misc` Mandatory if `instructions.party.personalDetails.type` is:`person`  |
| `instructions.party.personalDetails.firstName` | Conditional | Max 35 | Beneficiary first name. Full name should be provided (no initials).  Mandatory if `instructions.party.personalDetails.type` is:`person`  |
| `instructions.party.personalDetails.middleName` | ❌ | Max 35 | Beneficiary middle name. |
| `instructions.party.personalDetails.lastName` | Conditional | Max 35 | Beneficiary last name. Full name should be provided (no initials).  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.companyName` | Conditional | Max 70 | Full name of the organization.   Mandatory if `instructions.party.personalDetails.type` is:`company``institution``government``other`  |
| `instructions.party.personalDetails.dateOfBirth` | ❌ | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
| `instructions.party.personalDetails.dateOfIncorporation` | ❌ | 10 | A `company`s date of incorporation in YYYY-MM-DD format. |
| `instructions.party.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. |
| `instructions.party.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. |
| `instructions.party.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. |
| `instructions.party.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. |
| `instructions.party.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.  |