Datafinder's Hygiene and Lead Validation API service allows you to properly clean, format and validate your consumer contact data through a simple-to-use RESTful API. This documentation explains what are the expected inputs and outputs for the API service.

For a full feature list, please see the product page.

Request URL

https://api.datafinder.com/v2/qhv.php?k2={your-key}&service=clean

Parameters

Config Parameters

Use the config parameters to adjust elements like the output language.

Input Contact Parameters

Any parameter that begins with a "d_" is a input contact parameter that cleaning and validation will be performed on. For this API product, d_last and d_first or d_fullname are required. If a contact parameter requires another, it will be noted in the table below.

NOTE: d_first and d_last are required for the Hygiene and Lead Validation API.

Output Fields

Api results will follow the schema shown below and will include:

• version - api version
• query-id - id unique to each query
• results - list of append results
• input-query - list of input search parameters and their values
• page-time - how long the lookup took
• errors - any error messages

Fields returned for each records in the "results":

Output schema in JSON:

{
  "datafinder": {
    "version": "2.0",
    "query-id": "xxxxxx",
    "results": 
    {
      "key": "value"
    },
    "input-query": {
      "key": "value"
    },    
    "page-time": "0.000"
  }
}