Skip to content

SAID name match

Request

The South African name match service provides automated, remote identity verification for individuals within South Africa. It uses a person's South African ID number (SAID) together with their first name and last name to check against official records. The service returns a match score along with a detailed description of the verification outcome, enabling quick and reliable identity checks

Security
API-Key
Bodyapplication/json
said_numberstring, = 13 charactersrequired

South African 13-digit national identity number in the format YYMMDDSSSSCAZ: YYMMDD is the date of birth, SSSS is a gender code (0000-4999 female, 5000-9999 male), C is the citizenship indicator (0 citizen, 1 permanent resident), A is a historical digit, and Z is a Luhn checksum digit.

Example:"8001015009031"
first_namestring, (name), [ 2 .. 64 ] characters^[a-zA-Z ,.''-]{2,64}$required

The first name of a person

Example:"Josh"
last_namestring, (name), [ 2 .. 64 ] characters^[a-zA-Z ,.''-]{2,64}$required

The last name of a person

Example:"Coffey"
name_match_thresholdnumber, (float), decimal places <= 2, [ 0 .. 1 ]required

The minimum similarity score required to include a name in the search results. A higher value returns fewer, more exact matches, and a lower value returns more results with less similarity

Example:0.75
{
  "said_number": "8001015009031",
  "first_name": "Josh",
  "last_name": "Coffey",
  "name_match_threshold": 0.75
}

Responses

OK

The request was successful, and our system returned an expected response.

Bodyapplication/json
validationobject
dataobject
Response
{
  "validation": {
    "valid": true
  },
  "data": {
    "first_name": "Josh",
    "last_name": "Coffey",
    "service_first_name": "Josh",
    "service_last_name": "Cofey",
    "dob": "1976-02-21",
    "gender": "M",
    "is_citizen": true,
    "name_match_threshold": 0.75,
    "name_match_score": 0.8
  }
}