v1

latestOpenAPI 3.0.02026-07-2640301.0 MB
Contact Verification Endpoints

contact-verification/requests

This endpoint is used to fetch results of the contact verification requests.

get/contact-verification

Query parameters

AccountIDstring required

Your account ID

Keystring required

API key for the account

Signaturestring required

Hashed signature for the request

VerificationRequestIDinteger

Value of the Contact Verification Request ID

ClientAccountIDstring required

The client account ID associated with this email. This is required if client account is enabled. Use ContactID instead if client account is not enabled.

ContactIDstring required

The contact ID associated with this email. This is required if client account is not enabled. Use ClientAccountID instead if client account is enabled.

SearchTextstring

A text string to search for in the email addresses used for Account Verification process.

Limitinteger

Limit the number of records that are returned.

Offsetinteger

Use this parameter to set the starting point in the dataset.

VerificationTypestring

Filter by contact verification type. Can be 'email', 'phone', 'nondoc', 'name'.

VerificationTierstring

filter by tier of the verification request. Options are 'basic' and 'enhanced'.

VerificationStatusstring

filter by Status of the verification request. Options are 'unverified', 'verified', 'failed'.

Timezonestring

Use this parameter to convert the time to the specified timezone. If no timezone is specified, the default is UTC.

StartDateTimestring date-time

Return contact verification requests that occurred on or after this date/time. Can be specified in either YYYY-MM-DD HH:MM:SS or YYYY-MM-DD format.

EndDateTimestring date-time

Return contact verification requests that occurred on or before this date/time. Can be specified in either YYYY-MM-DD HH:MM:SS or YYYY-MM-DD format.

Response

Successboolean

True if the request was successful, false if it failed

ErrorMessagestring

Contains a description of the error if the request failed

Example response

{
  "ContactVerificationRequests": {
    "0": {
      "ClientAccountID": "johndoe",
      "Type": "address",
      "VerificationStatus": "verified",
      "LastModified": "2025-10-30 00:08:27"
    }
  }
}