Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.didx.co.za/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

This endpoint verifies South African driver’s licence details via the eNaTIS (Electronic National Traffic Information System). Because eNaTIS lookups are asynchronous, results are delivered via a webhook callback.

​
Workflow

1

Submit verification request

POST to /Citizen/DriversLicenseVerificationService with the licence details
2

Receive result via webhook

The result is delivered to your registered webhook endpoint at /Citizen/DriversVerificationWebHook

​
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",
    "LicenceNumber": "DL123456789",
    "CRef": "REF00001"
  }'

​
Request Fields

FieldTypeRequiredDescription
ConsentReceivedbooleanYesMust be true
IdNumberstringYesSA ID number of the licence holder
LicenceNumberstringYesDriver’s licence number
CRefstringNoYour transaction reference

​
Initial Response (202 Accepted)

{
  "TrackingNumber": "abc123-def456",
  "Status": "Pending",
  "Message": "Verification submitted. Result will be delivered via webhook."
}

​
Webhook Payload

When the eNaTIS lookup completes, the result is POSTed to your registered webhook endpoint: 
{
  "TrackingNumber": "abc123-def456",
  "LicenceNumber": "DL123456789",
  "IdNumber": "8001014800080",
  "LicenceValid": true,
  "LicenceStatus": "Valid",
  "LicenceCategories": ["B", "C"],
  "ExpiryDate": "2028-01-01",
  "IssueDate": "2018-01-01",
  "RestrictionsAndConditions": null,
  "Status": "Success",
  "CRef": "REF00001"
}

​
Webhook Response Fields

FieldDescription
LicenceValidtrue if the licence is valid and current
LicenceStatusValid, Expired, Suspended, Cancelled, etc.
LicenceCategoriesList of vehicle categories the licence holder is authorised to drive
ExpiryDateLicence expiry date
RestrictionsAndConditionsAny restrictions or conditions on the licence
Ensure your webhook endpoint is registered and accessible before submitting verification requests. Contact the DIDx team to register your webhook URL.