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

# Fingerprint Verification

> Validate a fingerprint against the Department of Home Affairs via SAFPS.

## Overview

This endpoint validates a fingerprint against the Department of Home Affairs database via the South African Fraud Prevention Service (SAFPS).

## Endpoint

```
POST /Citizen/ValidateFingerPrint
```

## Request

```bash theme={null}
curl -X POST "https://citizen.uat.securecitizen.cloud/Citizen/ValidateFingerPrint" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "ConsentReceived": true,
    "IdNumber": "8001014800080",
    "FingerPrint": "<base64_fingerprint_image>",
    "CRef": "REF00001"
  }'
```

### Request Fields

| Field             | Type    | Required | Description                      |
| ----------------- | ------- | -------- | -------------------------------- |
| `ConsentReceived` | boolean | **Yes**  | Must be `true`                   |
| `IdNumber`        | string  | **Yes**  | South African 13-digit ID number |
| `FingerPrint`     | string  | **Yes**  | Base64-encoded fingerprint image |
| `CRef`            | string  | No       | Your transaction reference       |

## Response

```json theme={null}
{
  "FingerPrintResult": {
    "isMatch": true,
    "confidence": 0.95
  },
  "Status": "Success",
  "CRef": "REF00001",
  "Message": "Fingerprint verified successfully"
}
```

| Field        | Description                                      |
| ------------ | ------------------------------------------------ |
| `isMatch`    | `true` if the fingerprint matches the DHA record |
| `confidence` | Confidence score of the fingerprint match (0–1)  |