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

# SAID with photo

`POST /services/za/said-photo`

Confirm a person’s identity in South Africa from their 13-digit South African ID number (SAID) and put a face to the record. Alongside the core identity details – first name, last name, date of birth, gender, citizenship status, and deceased status – this service also returns the individual's official photograph, making it well suited to flows where visual confirmation matters

## 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.

## Response `200`

**OK**

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

- object
  - `data` object
    - `first_name` string, name, nullable — The first name of a person
    - `last_name` string, name, nullable — The last name of a person
    - `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)
    - `is_deceased` boolean — Indicates whether the person is recorded as deceased. True if a death has been registered, false otherwise
    - `photo_base64` string — Person’s photograph encoded as a base64 string

## 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)
