API Overview

This API returns the original snapshot of a previously run Trust Score or Mobile KYC check. The original requestId and signature are used to locate and verify the record; the recall itself is issued a new requestId. If the signature cannot be verified, no original data is returned.

Sandbox You are viewing Sandbox mode docs. Switch using the toggle on the dashboard.
Required Headers
http
Copy 
{
    "Authorization": "Bearer YOUR_SANDBOX_API_KEY",
    "Content-Type": "application/json"
}
Sample Request Body
json
Copy 
{
    "requestId": "TDS68ba778a51ccb",
    "signature": "b5ed745afd02bd32a70f82dafc6fb2a41394e579206f39efa5"
}
Full Curl Request
bash
Copy 
curl -X POST "https://eloquent-shirley.77-68-26-98.plesk.page/api/sandbox/risk-recall" \
-H "Authorization: Bearer YOUR_SANDBOX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "requestId": "TDS68ba778a51ccb",
    "signature": "b5ed745afd02bd32a70f82dafc6fb2a41394e579206f39efa5"
}'
Trust Score Recall
200 Sample Response
200 
{
    "status": 0,
    "ipMatch": true,
    "requestId": "TDS7f2a9c1b3e4d5f6a",
    "customerReference": "12345abc-67d8-910ef11-gh1213ijk",
    "Risk_recall": {
        "original_check_type": "trust_score",
        "original_timestamp": "2026-02-20T12:41:00Z",
        "recall_timestamp": "2026-07-02T17:45:00Z",
        "latency_ms": 42,
        "frozen": true,
        "signature_verified": true,
        "original_response": {
            "status": 0,
            "ipMatch": true,
            "customerReference": "12345abc-67d8-910ef11-gh1213ijk",
            "requestId": "TDS68ba778a51ccb",
            "response": {
                "trustScore": 1000,
                "indicators": [
                    "NO",
                    "NO"
                ],
                "callInSession": "true",
                "details": {
                    "riskLevel": "0",
                    "simTimestamp": "2023-05-22T03:48:21Z",
                    "callDirection": "IN",
                    "callDuration": "347"
                },
                "troubleshootingId": "7c179940-d14b-477f-8a5e-123456789abc",
                "numberInfo": {
                    "carrier": "EE",
                    "lineType": "mobile",
                    "countryCode": "GB"
                }
            },
            "audit_url": "https://risk.tds.com/policy/{id}",
            "policy_version": "1.1",
            "policy_hash": "abc123"
        }
    }
}
Mobile KYC Recall
200 Sample Response
200 
{
    "status": 0,
    "ipMatch": true,
    "requestId": "TDS9c1b3e4d5f6a7f2a",
    "customerReference": "123456789",
    "Risk_recall": {
        "original_check_type": "mobile_kyc",
        "original_timestamp": "2026-02-18T09:12:00Z",
        "recall_timestamp": "2026-07-02T17:45:00Z",
        "latency_ms": 38,
        "frozen": true,
        "signature_verified": true,
        "original_response": {
            "status": 0,
            "ipMatch": true,
            "customerReference": "123456789",
            "requestId": "TDS7c179940d14b477f",
            "response": {
                "troubleshootingId": "b48c6082-2d18-4b4f-8aa1-4a891bb134d5",
                "numberInfo": {
                    "carrier": "Three",
                    "countryCode": "GB",
                    "lineType": "mobile",
                    "isLostStolen": false,
                    "accountType": "postpay"
                },
                "verified": true,
                "name": {
                    "firstName": 100,
                    "lastName": 100,
                    "nameScore": 100
                },
                "address": {
                    "addressScore": 100
                },
                "dob": true,
                "indicators": [
                    "OU",
                    "UV"
                ],
                "identifiers": []
            },
            "audit_url": "https://risk.tds.com/policy/{id}",
            "policy_version": "1.1",
            "policy_hash": "abc123"
        }
    }
}
Response Definitions