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:

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

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.

Last updated

Was this helpful?