API Overview

This endpoint queries the consumer's phone number to return a TDS Trust Score and, potentially, other attributes to indicate the trustworthiness of a phone number and its identity.

Required Headers
http
Copy 
{
    "Authorization": "Bearer {your-api-key}",
    "pf-subclientid": "abc_sub_client",
    "Content-Type": "application/json"
}
Sample Request Body
json
Copy 
{
    "requestId": "12345abc-67d8-910ef11-gh1213ijk",
    "phoneNumber": "447911123456",
    "country": "GB",
    "details": false
}
Full Curl Request
bash
Copy 
curl -X POST "https://api.thedatasupermarket.com/trust/v1" \
-H "Authorization: Bearer {your-api-key}" \
-H "pf-subclientid: abc_sub_client" \
-H "Content-Type: application/json" \
-d '{
    "requestId": "12345abc-67d8-910ef11-gh1213ijk",
    "phoneNumber": "447911123456",
    "country": "GB",
    "details": false
}'
200 Sample Response with Details
200 
{
    "status": 0,
    "requestId": "12345abc-67d8-928e11-gh12131",
    "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"
        }
    },
    "policy_snapshot_url": "https://risk.tds.com/policy/{id}",
    "policy_version": "1.1",
    "policy_approved_at": "2026-01-22T18:41:00Z",
    "last_policy_scan": "2026-01-23T00:01:00Z",
    "next_policy_scan": "2026-01-24",
    "policy_changed": false,
    "policy_hash": "abc123",
    "policy_character_count": 4876
}
200 Sample Response without Details
200 
{
    "status": 0,
    "requestId": "12345abc-67d8-910ef11-gh1213ijk",
    "response": {
        "trustScore": 1000,
        "indicators": [
            "WS",
            "ND"
        ]
    },
    "policy_snapshot_url": "https://risk.tds.com/policy/{id}",
    "policy_version": "1.1",
    "policy_approved_at": "2026-01-22T18:41:00Z",
    "last_policy_scan": "2026-01-23T00:01:00Z",
    "next_policy_scan": "2026-01-24",
    "policy_changed": false,
    "policy_hash": "abc123",
    "policy_character_count": 4876
}
Response Definitions