Verify

The verify operation uses data from lead events and the source from which they originated to verify that a consumer gave their express written consent to be contacted as defined by the requirements configured in your account.

Important

  • Verify requires a Self-Service plan or higher.
  • For Facebook certificates, consent language is detected only if it is included in the custom disclaimer section.

VerifyParameters

The advertiser_name parameter is optional but is required to populate the one_to_one property.

The advertiser_name parameter only applies to the One to One Consent value (returned as one_to_one). It has no effect on any other values returned by the Verify call.

advertiser_name
string

The name of the legal entity for an advertiser that will be used to determine if they were given consent in a one to one manner. This value will be normalized to be case insensitive, ignore redundant white space and omit non-alphanumeric characters. Both 'Acme Inc.' and 'acme inc' would result in the same processed value.

{
  • "advertiser_name": "Acme Inc."
}

VerifyResult

advertiser_name
string

The legal name of the advertiser passed in to the request and used to perform the 1:1 consent language check. This field will only appear in the response if it was provided in the request.

Array of objects

A list of the consent languages detected within the certificate

object

An object containing properties that detail the result of the verify operation.

{
  • "advertiser_name": "Acme Inc.",
  • "languages": [
    • {
      • "text": "By clicking on the 'Get Rates' button below, I consent to be contacted"
      }
    ],
  • "result": {
    • "language_approved": true,
    • "one_to_one": true,
    • "success": true
    }
}