Driver's Licence Verification

Overview

This endpoint verifies South African driver’s licence details via the eNaTIS (Electronic National Traffic Information System). You identify the licence holder by ID number and name. The check runs asynchronously: the response confirms that the request was accepted, and the result is delivered to your webhook later.

Workflow

Contact the DIDx team to register the webhook URL that receives your results.

Submit verification request

POST to /Citizen/DriversLicenseVerificationService with the licence holder’s details. Store the request_key from the response.

Receive result via webhook

The result is POSTed to your registered webhook URL. Match it to your request with the request_key.

Submit Verification Request

POST /Citizen/DriversLicenseVerificationService

curl -X POST "https://citizen.uat.securecitizen.cloud/Citizen/DriversLicenseVerificationService" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "ConsentReceived": true,
    "IdNumber": "8001014800080",
    "FirstNames": "John",
    "LastName": "Doe",
    "CRef": "REF00001"
  }'

Request Fields

Field	Type	Required	Description
`ConsentReceived`	boolean	No	Set to `true` to confirm subject consent was obtained
`IdNumber`	string	Yes	SA ID number of the licence holder
`FirstNames`	string	Yes	First names of the licence holder
`LastName`	string	Yes	Last name of the licence holder
`CRef`	string	No	Your transaction reference

The request schema also lists callback_url. It is read-only: the platform sets it, so you don’t send it.

Response

{
  "response_object": {
    "status": {
      "result_status": "pending",
      "description": "string"
    },
    "request": {
      "request_key": "string"
    }
  },
  "result": true,
  "result_code": {
    "name": "Success",
    "id": 0
  },
  "RequestedBy": "string",
  "AuthorizedBy": "string",
  "CRef": "REF00001",
  "Status": "Success",
  "Message": "string"
}

Field	Description
`response_object.status.result_status`	Status of the verification request
`response_object.status.description`	Description of the status
`response_object.request.request_key`	Key that identifies the request. Use it to match the webhook result

Webhook Payload

When the licence check completes, the result is POSTed to your registered webhook URL:

{
  "ref_number": "string",
  "document_url": "string"
}

Field	Description
`ref_number`	The `request_key` returned when you submitted the request
`document_url`	URL of the licence verification result

TBC: engineering confirming the webhook payload. The webhook isn’t part of the API reference.

Identity Verification

Biometrics

Compliance & Screening

Financial Verification

Enterprise

Overview

Workflow

Submit Verification Request

Request Fields

Response

Webhook Payload

​Overview

​Workflow

​Submit Verification Request

​Request Fields

​Response

​Webhook Payload

Overview

Workflow

Submit Verification Request

Request Fields

Response

Webhook Payload