ID parser

Interactive reference for the id parser endpoints. Fill in parameters, run live requests with your own token, and copy ready-to-paste code.

POST/v1/id/parseid_parser:use

Extract date of birth, gender, citizenship, and Luhn validity from a 13-digit South African ID number.

Request body

A 13-digit South African ID number to parse.

{
  "id_number": "9001045800082"
}

POST /v1/id/parse

Code

curl -X POST "https://api.labs.org.za/v1/id/parse" \
  -H "Authorization: Bearer labs_sandbox_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
  "id_number": "9001045800082"
}'

Response

Run the request to see a live response.

Example response shape

{
  "data": {
    "id_number": "9001045800082",
    "valid": true,
    "date_of_birth": "1990-01-04",
    "gender": "male",
    "citizenship": "citizen",
    "luhn_valid": true
  }
}