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, Name Match Status
United Kingdom (UK)	GBP	Account Name, Account Number, Sort 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.
India (IN)	INR	Account Name, Account Number, IFSC Code	Account Status, Account Holder Name
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, SWIFT Code	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:

Field	API Field	Example	Request/Response
Account Name	accountHolderName	John Smith	Request
Account Number	bank.accountNumber	11111111	Request
Account Number (IBAN)	bank.iban	FR7630004028379876543210943	Request
SWIFT Code	bank.routing.swift	VTCBVNVX	Request
ACH Number	bank.routing.achCode	101000019	Request
Sort Code	bank.account.sortCode	123456	Request
IFSC Code	bank.account.ifsc	HDFC0000522	Request
VAT Number	bank.identification.registrationId	FR12949982110	Request
Account Status	status	valid	Response
Account Holder Name	derivedAccountDetails.name	John Smith	Response
Name Match Status	derivedAccountDetails.nameMatch	match	Response
Account Number Name (Local Language)	derivedAccountDetails.nameLocal	ジョン・スミス	Response