Response Definitions
Return Length
All return string types are a max of 128 bytes unless otherwise stated.
| NAME | TYPE | DESCRIPTION |
|---|---|---|
verification_results |
array | An array containing verification result objects for each matched lead. |
verification_summary |
object | Summary information about the verification result. |
dd_code |
string | The DD Code used for verification. |
request_id |
string | Unique request identifier generated by TDS for tracking purposes. |
signature |
string | Unique signature hash for this verification result, used for recall operations. |
message |
string | Human-readable message describing the verification status. |
status |
string | Verification status (e.g., "Verified", "Not Verified"). |
user_details |
object | Technical details about the user's session when the lead was created. |
ip_address |
string | IP address from which the lead was submitted. |
user_agent |
string | User agent string from the browser/device used to submit the lead. |
data_source |
object | Information about the source of the data submission. |
signup_url |
string | URL where the lead signed up or was captured. |
privacy_policy_url |
string | URL of the privacy policy page associated with the data source. |
referrer_url |
string | Referrer URL that directed the user to the signup page. |
signup_ip |
string | IP address used during the signup process. |
consent_metadata |
object | Details about the consent given by the lead. |
legal_basis |
string | Legal basis for processing (e.g., "Consent", "Legitimate Interest"). |
consent_method |
string | Method through which consent was obtained (e.g., "Web form opt-in"). |
consent_text |
string | Exact text of the consent statement shown to the user. |
consent_timestamp |
string | ISO 8601 timestamp when consent was given. |
consent_categories |
array | Array of consent categories (e.g., "Third-party marketing", "Third-party profiling"). |
consent_timestamps_by_channel |
object | Consent timestamps broken down by communication channel. |
email_consent |
string|boolean | ISO 8601 timestamp for email consent, or false if no consent. |
phone_consent |
string|boolean | ISO 8601 timestamp for phone consent, or false if no consent. |
landline_consent |
string|boolean | ISO 8601 timestamp for landline consent, or false if no consent. |
postal_consent |
string|boolean | ISO 8601 timestamp for postal consent, or false if no consent. |
sms_consent |
string|boolean | ISO 8601 timestamp for SMS consent, or false if no consent. |
ai_sms_consent |
string|boolean | ISO 8601 timestamp for AI SMS consent, or false if no consent. |
recency |
object | Information about when the lead data was most recently updated. |
recency_timestamp |
string | ISO 8601 timestamp of the most recent update to the lead data. |
email_recency_timestamp |
string|boolean | ISO 8601 timestamp of the most recent email update, or false if not available. |
phone_recency_timestamp |
string|boolean | ISO 8601 timestamp of the most recent phone update, or false if not available. |
landline_recency_timestamp |
string|boolean | ISO 8601 timestamp of the most recent landline update, or false if not available. |
mail_recency_timestamp |
string|boolean | ISO 8601 timestamp of the most recent mail update, or false if not available. |
restricted_use |
object | Restrictions and limitations on how the data can be used. |
usage_region |
string | Geographic region where the data can be used (e.g., "UK Only"). |
campaign_or_industry_restrictions |
string | Industry or campaign type restrictions (e.g., "No Debt Management"). |
approved_contact_channels |
array | Array of approved communication channels (e.g., ["Email", "Phone", "Mail"]). |
prohibited_contact_channels |
array | Array of prohibited communication channels (e.g., ["SMS"]). |
licence_expiry |
object | Information about licence and TPS expiry dates. |
licence_expiry_date |
string | Date when the data licence expires (YYYY-MM-DD format). |
tps_expiry_date |
string | Date when the TPS (Telephone Preference Service) check expires (YYYY-MM-DD format). |
privacy_policy_scan |
object | Results of automated privacy policy analysis. |
mentions_consent |
boolean | Indicates if the privacy policy mentions consent as a legal basis. |
mentions_legitimate_interest |
boolean | Indicates if the privacy policy mentions legitimate interest as a legal basis. |
opt_out_clause_found |
boolean | Indicates if an opt-out clause was found in the privacy policy. |
third_party_data_sharing |
boolean | Indicates if third-party data sharing is mentioned in the privacy policy. |
purpose_of_use_declared |
boolean | Indicates if the purpose of data use is clearly declared in the privacy policy. |
last_updated |
string | Date when the privacy policy was last updated (YYYY-MM-DD format). |
processing_disclosure |
string | Full text disclosure statement about how the data may be processed and shared. |