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
country
ZA
id_type
REFUGEE_ID
id_number
Refugee or Asylum NIIS File Number
Response Fields
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:
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.
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
Last updated
Was this helpful?