---
title: "SAID name match"
method: POST
path: "/services/za/said/name-match"
tags: ["🇿🇦 South Africa"]
---

# SAID name match

`POST /services/za/said/name-match`

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

## Request body

- object
  - `said_number` string, required — 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.
  - `name_match_threshold` number, float, 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

## Response `200`

**OK**

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

- object
  - `validation` object
    - `valid` boolean
  - `data` object
    - `first_name` string, name, nullable — The first name of a person
    - `last_name` string, name, nullable — The last name of a person
    - `service_first_name` string — The first name returned by an external service for comparison with the submitted value
    - `service_last_name` string, name — The last name returned by an external service for comparison with the submitted value
    - `dob` string, date, nullable — The date of birth of a person, formatted as “YYYY-MM-DD” according to ISO 8601
    - `gender` 'M' | 'F', nullable — The gender of a person. `M` indicates male; `F` indicates female
    - `is_citizen` boolean — Indicates whether the person is a South African citizen. True for a citizen, false for a permanent resident. Derived from the eleventh digit of the South African ID number (0 for citizen, 1 for permanent resident)
    - `name_match_threshold` number, float — 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
    - `name_match_score` number, float — Relevance of a name match in a fuzzy search

## Other responses

- `400` — **Bad Request** Our system could not process the request due to invalid syntax, missing parameters, or incorrect data format. Check the request structure and try again.
- `402` — **Payment Required** Access to the requested resource is restricted until a payment is successfully processed. Ensure your account has a valid payment method or sufficient funds to complete this action.
- `404` — **Not Found** The requested resource does not exist or can’t be found in our system.
- `500` — **Internal Server Error** This response indicates that our system encountered an unexpected condition that prevented it from fulfilling the request.
- `502` — **Bad Gateway** This response indicates that our system is unable to reach or communicate properly with an upstream server it relies on, the URL provided is incorrect, or a required token is missing from the request.

---

[API](https://skmtc.net/kycaid/apis/overview.md) · [All operations](https://skmtc.net/kycaid/apis/overview/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kycaid/overview/versions/971fdaeccced/schema)