Skip to main content

​
Overview

The South African Fraud Prevention Service (SAFPS) is a shared database used by financial institutions and businesses to flag and look up fraud incidents. DIDx:Verify provides two SAFPS lookup endpoints:
  • Detailed Search — search by ID number, contact number, email, or bank account
  • Detailed Object Search — search using a structured object with multiple identifiers

​
Listing Types

Identifier FormatTypeDescription
PR00000000Protective RegistrationThe individual has voluntarily registered with SAFPS for protection. Requires their PR number to proceed with onboarding.
VICTIM00000000VictimThe individual has been a victim of fraud (e.g. impersonation)
SH00000000SAFPS HitThe individual has been flagged for conducting fraudulent activity
POST /Citizen/SAFPSDetailedSearch
Search the SAFPS database by one or more identifiers. 
curl -X POST "https://citizen.uat.securecitizen.cloud/Citizen/SAFPSDetailedSearch" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "ConsentReceived": true,
    "IdNumber": "8001014800080",
    "ContactNumber": "0821234567",
    "EmailAddress": "[email protected]",
    "BankAccount": "1234567890",
    "CRef": "REF00001"
  }'

​
Request Fields

FieldTypeRequiredDescription
ConsentReceivedbooleanYesMust be true
IdNumberstringNoSA ID number to search
ContactNumberstringNoContact number to search
EmailAddressstringNoEmail address to search
BankAccountstringNoBank account number to search
CRefstringNoYour transaction reference
At least one search identifier (IdNumber, ContactNumber, EmailAddress, or BankAccount) must be provided.

​
Response

{
  "data": [
    {
      "FirstName": "John",
      "Surname": "Doe",
      "BirthDate": "1980-01-01T00:00:00Z",
      "Filings": [
        {
          "ReferenceNo": "SH00000001",
          "Category": "Impersonation"
        },
        {
          "ReferenceNo": "VICTIM00000001",
          "Category": "Victim of impersonation"
        }
      ]
    }
  ],
  "Status": "Success",
  "CRef": "REF00001"
}

POST /Citizen/SAFPSDetailedObjectSearch
A structured variant of the SAFPS search that accepts a more detailed search object. 
curl -X POST "https://citizen.uat.securecitizen.cloud/Citizen/SAFPSDetailedObjectSearch" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "ConsentReceived": true,
    "SearchObject": {
      "IdNumber": "8001014800080",
      "FirstName": "John",
      "LastName": "Doe",
      "DateOfBirth": "1980-01-01"
    },
    "CRef": "REF00001"
  }'
The response format is the same as the Detailed Search endpoint.

​
Handling Protective Registrations

When a PR (Protective Registration) listing is returned, the individual has proactively registered with SAFPS to protect their identity. You must request their PR reference number and validate it before proceeding with their application. 
{
  "Filings": [
    {
      "ReferenceNo": "PR00088118",
      "Category": ""
    }
  ]
}
Ask the customer to provide their PR number and verify it matches PR00088118 before continuing.