Required Fields
Use this guide to see which fields are required when verifying bank account or proxy details using Nium Verify. You'll also find what data is returned for each request and how the fields map to our API.
For an overview of Nium Verify, see Nium Verify.
Country
The table below lists required fields and expected response fields for each supported corridor.
| Corridor | Currency | Required Fields | Response Fields | Notes |
|---|---|---|---|---|
| United States (US) | USD | Account Name, Account Number, ACH Code | Account Status | |
| United Kingdom (UK) | GBP | Account Name, Account Number, Sort Code | Account Status, Account Holder Name | |
| India (IN) | INR | Account Name, Account Number, IFSC Code | Account Status, Account Holder Name | Account holder’s name is returned only for strong or partial matches. Not returned for weak matches. Applies across all UK providers. |
| Malaysia (MY) | MYR | Account Name, Account Number, SWIFT Code | Account Status, Account Holder Name | |
| Thailand (TH) | THB | Account Name, Account Number, SWIFT Code | Account Status | |
| Vietnam (VN) | VND | Account Name, Account Number, SWIFT Code | Account Status, Account Holder Name | |
| Indonesia (ID) | IDR | Account Name, Account Number, SWIFT Code | Account Status, Account Holder Name | |
| Nigeria (NG) | NGN | Account Name, Account Number, SWIFT Code | Account Status, Account Holder Name | |
| Tanzania (TZ) | TZS | Account Name, Account Number, SWIFT Code | Account Status, Account Holder Name | |
| France (FR) | EUR | Account Name, Account Number (IBAN), VAT Number | Account Status, Account Holder Name | |
| Belgium (BE) | EUR | Account Name, Account Number (IBAN), VAT Number | Account Status, Account Holder Name | |
| Italy (IT) | EUR | Account Name, Account Number (IBAN), VAT Number | Account Status, Account Holder Name | |
| Netherlands (NL) | EUR | Account Name, Account Number (IBAN), VAT Number | Account Status, Account Holder Name | |
| Poland (PL) | EUR | Account Name, Account Number (IBAN), VAT Number | Account Status, Account Holder Name | |
| Pakistan (PK) | PKR | Account Name, Account Number (IBAN) | Account Status, Account Holder Name | |
| South Korea (KR) | KRW | Account Name, Account Number, SWIFT Code | Account Status, Account Holder Name, Account Holder Name (Local Language) |
Country (proxy)
When using proxy-based identifiers (such as mobile number, VPA, or email), include the identifier type in proxy.type and the value in proxy.value.
| Corridor | Currency | Required Fields | Response Fields |
|---|---|---|---|
| Australia (AU) | AUD | Mobile, Email, ABN, Organisation ID | Account Status, Account Holder Name |
| Hong Kong (HK) | HKD | Mobile, Email, FPS ID | Account Status, Account Holder Name |
| India (IN) | INR | VPA | Account Status, Account Holder Name |
| Malaysia (MY) | MYR | Mobile, Passport, NRIC, Corporate Registration Number, Army ID | Account Status, Account Holder Name |
| Singapore (SG) | SGD | Mobile, UEN, NRIC, VPA | Account Status, Account Holder Name |
For proxy values, include the request parameter in proxy.type and the corresponding value in proxy.value. |
Field Definitions
- Verification Type:
- Bank: Verifies traditional bank account details.
- Proxy: Verifies alternative identifiers such as mobile number or VPA.
- Mandatory Fields: Fields you must provide for a successful verification.
- Notes: Additional details or conditions that apply per country.
Required Fields and API Fields
This table shows how each required field maps to your API request or response:
| Required Field | API Field | Example |
|---|---|---|
| Account Holder Name | derivedAccountDetails.name | Harry Potter |
| Account Name | accountHolderName | Harry Potter |
| Account Number | bank.accountNumber | 11111111 |
| Account Number (IBAN) | bank.iban | FR7630004028379876543210943 |
| Account Number Name (Local Language) | derivedAccountDetails.nameLocal | ジョン・スミス |
| Account Status | status | valid |
| SWIFT Code | bank.routing.swift | VTCBVNVX |
| ACH Number | bank.routing.achCode | 101000019 |
| Sort Code | bank.account.sortCode | 123456 |
| IFSC Code | bank.account.ifsc | HDFC0000522 |
| VAT Number | bank.identification.registrationId | FR12949982110 |