Skip Tracing Tutorial
Overview
Skip Tracing is a real-time solution for retrieving the current and former addresses, the birth date, the death date, and the aliases for a given person.
Skip Tracing URI
The Skip Tracing URI accepts a person’s name and address and returns their current and former addresses, their known aliases, their birth date, and their death date.
Required Information
The Skip Tracing URI requires you to have an Authorization Token. If you have not retrieved an Authorization Token yet, follow the Authorization Tutorial before continuing.
The Skip Tracing URI, like all of the solution URIs, also requires you to have an API Key. If you do not know your API Key, contact support to retrieve it. The API Key should be provided in the request header with the header attribute: x-api-key
The Skip Tracing URI must be used with a POST request, where the request payload contains the person’s name and address.
Example
Request URL
The URL for the Skip Tracing URI is: https://api.thedatagroup.com/{version}/sync/lookup/skip-tracing, where {version} is the API Version you wish to use.
Request Headers
Header Attribute | Header Value |
---|---|
x-api-key | {your api key} |
AuthorizationToken | {your authorization token} |
Content-Type | application/json |
Request Payload
The request payload for the Skip Tracing URI must contain the first_name, last_name and the address_1 attributes. It must also contain either the zipcode attribute or both the city and state attributes.
{ “first_name”: “John”, "last_name”: “Smith”, “address_1”: “425 S. Avalon Park BLVD”, “zipcode”: “32828” }
cURL Example
To query the Skip Tracing URI, you can use one of the provided SDKs, a REST Client, or a simple cURL command. Below is an example of the cURL command for the example input information.
curl -X POST -H "AuthorizationToken: {your token here}" -H "x-api-key: {your key here}" -H "Content-Type: application/json" -d '{ "first_name": "John", "last_name": "Smith", "address_1": "425 S. Avalon Park BLVD", "zipcode": "32828" }' " https://api.thedatagroup.com/v3/sync/lookup/skip-tracing"
Response Payload
The response payload for the Skip Tracing URI will contain the information on the person that you are trying to search for, including previous addresses, their name aliases, their birth date, and their death date.
{ "addresses” : { primary_address: { zipcode: “32828”, unit_number: “425”, city: “ORLANDO”, street_number: “1234”, pre_direction: “S”, street_type: “BLVD”, state: “FL”, street_name: “AVALON PARK” }, previous_addresses: [ { zipcode: “32828”, unit_number: “425”, city: “ORLANDO”, street_number: “1234”, pre_direction: “S”, street_type: “BLVD”, state: “FL”, street_name: “AVALON PARK” } ] }, names: { aliases: [ { last_name: “Smith”, first_name: “John”, middle_name: “Appleseed” } ], primary_name: { last_name: “Smith”, first_name: “John”, middle_name: “Appleseed”