Refugee and Asylum ID

The South African Refugee and Asylum Service enables the retrieval of key identity attributes, where available, to support accurate verification for individuals holding refugee or asylum documentation

Required Inputs

Input	Value
country	ZA
id_type	REFUGEE_ID
id_number	Refugee or Asylum NIIS File Number

Response Fields

Response Field	Value Returned
Country	YES
IDType	YES
IDNumber	YES
IssuanceDate	NO
ExpirationDate	YES
FirstName	YES
LastName	YES
OtherNames	NO
FullName	YES
DOB	YES
Photo	YES
PhoneNumber	NO
PhoneNumber2	NO
Document	NO
Nationality	YES
Gender	YES
Address	NO
Secondary_ID_Number	YES

ID Number Regular Expression (Regex)

To limit the probability of your user mistyping the id number, we advice that you enforce the format of the id number field in your app. You can use the regexes below:

• /^[A-Za-z]{3,6}\d{9,12}$/

Supported Products

The South African Refugee and Asylum id can be used on any of the following products:

• Basic KYC
• Enhanced KYC

For the supported integration options, you can check the integration options supported by each product here.

For Enhanced KYC, the FullData field is deprecated and will now be returned as an empty object "FullData": {}. Instead, use the top-level keys directly.

Sample ID Numbers

To test the South African Refugee and Asylum id in our Sandbox, we provide you with 5 different id numbers to mirror various scenarios you can experience with real IDs in production.

ID Number	Result	Result Code
ABCDEF000000000	Success with PII return	1012
ABCDEF000000001	Failure, no record found	1013
ABCDEF000000002	Invalid ID number format	1014
ABCDEF000000003	Database unavailable/unknown network issue	1015
ABCDEF000000004*	Success with custom PII return	1012

* You can read more about customising the PII response in sandbox in our documentation here.