DD Verification

This API allows buyers to verify a lead's Due Diligence (DD) compliance using the DD Code (Order ID) and Phone Number (or Email, if applicable). The API returns verification status and compliance details.

Required Headers
http
Copy 
{
    "Authorization": "Bearer {your-api-key}",
    "Content-Type": "application/json"
}
Sample Request Body
json
Copy 
{
    "dd_id": "0617970987965860",
    "lead_id": "TMP4670024",
    "lead_source_id": "WEB_FORM_001",
    "identifiers": [
        {
            "phone": "+447911123456"
        },
        {
            "email": "lead1@example.com"
        }
    ],
    "check_type": "DD"
}
Full Curl Request
bash
Copy 
curl -X POST "https://api.thedatasupermarket.com/dd-verify" \
-H "Authorization: Bearer {your-api-key}" \
-H "Content-Type: application/json" \
-d '{
    "dd_id": "0617970987965860",
    "lead_id": "TMP4670024",
    "lead_source_id": "WEB_FORM_001",
    "identifiers":  [
        { "phone": "+447911123456" },
        { "email":  "lead1@example.com" },
    ]
    "check_type": "DD" 
}'
Response
200 403 500 
{
    "dd_id": "DD1234567890",
    "verification_results": [
        {
            "verification_summary": {
                "dd_id": "DD123456",
                "message": "Lead verified successfully",
                "status": "Verified"
            },
            "user_details": {
                "ip_address": "81.102.54.121",
                "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)"
            },
            "data_source": {
                "signup_url": "https://insuranceform.co.uk/signup",
                "privacy_policy_url": "https://sellerdomain.com/privacy-policy",
                "referrer_url": "https://insuranceform.co.uk",
                "signup_ip": "81.102.54.121"
            },
            "consent_metadata": {
                "legal_basis": "Consent",
                "consent_method": "Web form opt-in (checkbox ticked)",
                "consent_text": "I agree to be contacted by phone, email and SMS for insurance quotes",
                "consent_timestamp": "2024-08-10T14:23:51Z",
                "consent_categories": [
                    "Third-party marketing",
                    "Third-party profiling",
                    "Third-party resale / redistribution"
                ]
            },
            "consent_timestamps_by_channel": {
                "email_consent": "2024-08-10T14:23:51Z",
                "phone_consent": "2024-08-10T14:23:51Z",
                "landline_consent": false,
                "postal_consent": false,
                "sms_consent": "2024-08-10T14:23:51Z",
                "ai_sms_consent": false
            },
            "recency": {
                "recency_timestamp": "2024-08-10T14:23:51Z",
                "email_recency_timestamp": "2024-08-10T14:23:51Z",
                "phone_recency_timestamp": "2024-08-10T14:23:51Z",
                "landline_recency_timestamp": false,
                "mail_recency_timestamp": false
            },
            "restricted_use": {
                "usage_region": "UK Only",
                "campaign_or_industry_restrictions": "No Debt Management",
                "approved_contact_channels": [
                    "Email",
                    "Phone",
                    "Mail"
                ],
                "prohibited_contact_channels": [
                    "SMS"
                ]
            },
            "licence_expiry": {
                "licence_expiry_date": "2025-07-21",
                "tps_expiry_date": "2025-07-21"
            },
            "privacy_policy_scan": {
                "mentions_consent": true,
                "mentions_legitimate_interest": false,
                "opt_out_clause_found": true,
                "third_party_data_sharing": true,
                "purpose_of_use_declared": true,
                "last_updated": "2024-06-01"
            },
            "processing_disclosure": "We may license or share selected data with verified buyers through The Data Supermarket Ltd (TDS), a secure, compliance-led data marketplace. TDS acts as our authorised data processor, facilitating the licensing of our data to approved third parties. TDS enforces strict due diligence procedures on all buyers and ensures all data usage aligns with lawful purposes and applicable regulations. You can view a list of TDS-approved data licensees in Section 10 of their Privacy Policy."
        }
    ]
}