Supported Regions & NumberTypes

RegionCountryGenerate URL numberTypeGet Result numberTypeInfo.numberTypeNotes
NGANigeriaBVNNG_BVNNon-Doc
NGANigeriaNINNG_NINNon-Doc
IDNIndonesiaNIKID_NIKNon-Doc
BRABrazilCPFBR_CPFNon-Doc
ARGArgentinaDNIAR_DNINon-Doc
ZAFSouth AfricaSAIDZA_SAIDNon-Doc

Non-Doc field rules and response examples: DocDatabaseDetail, Get Result API.

Input fields by numberType

Which Generate URL API input fields are required, per numberType.

numberTypenumberValuefullNamegender
BVNOptionalOptional
NINOptionalOptional
NIKOptionalRequired
CPFOptionalOptional
DNIOptionalRequired when numberValue is provided¹
SAIDRequired

not applicable for that type. Optional = if omitted, the user fills it in on the H5 frontend.

¹ DNI: gender must be sent together with numberValue. If numberValue is omitted, the user provides both numberValue and gender on the H5 frontend.

numberValue length by numberType

numberValue length is validated per numberType. A number whose length does not match returns Number is invalid format on Generate URL API (or INVALID_FORMAT on Get Result API).

numberTypenumberValue length (digits)
BVN11
NIN11
NIK16
CPF11
DNI7 or 8
SAID13

Health Status API numberType mapping

Health Status API uses different numberType query values than Generate URL.

Health Status API numberTypeGenerate URL numberTypeRegion
NG_BVNBVNNGA
NG_NINNINNGA
ID_NIKNIKIDN
BR_CPFCPFBRA
AR_DNIDNIARG
ZA_SAIDSAIDZAF