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
PHLPhilippinesPCNPH_PCNNon-Doc
THAThailandTHAIEIDTH_THAIEIDThaID app authorization

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

These flows use the Non-Document Verification product (NON_DOCUMENT_VERIFICATION, solution code 07). Thailand ThaID uses app authorization and does not require ADVANCE.AI liveness capture.

Input fields by numberType

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

numberTypenumberValuefullNamegender
BVNOptional——
NINOptional——
NIKOptionalRequired—
CPFOptionalOptional—
DNIOptional—Required when numberValue is provided¹
SAIDRequired——
PCNOptional²——
THAIEID———

— 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.

² PCN: accepts either numberValue or prefilled personal information. For personal information, firstName, lastName, and birthday are required together; middleName and suffix are optional. If both numberValue and personal information are sent, numberValue is used. See Philippines PCN prefill.

For THAIEID, the user authorizes access in the ThaID app. No number or personal information prefill is required. Use the optional scope parameter in Generate URL API to select the requested attributes.

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). For PCN, Generate URL returns the same message with code = PARAMETER_ERROR.

numberTypenumberValue length
BVN11
NIN11
NIK16
CPF11
DNI7 or 8
SAID13
PCN16 digits, or 6–7 characters³
THAIEIDNot applicable

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
PH_PCNPCNPHL

Did this page help you?