{ "info": { "_postman_id": "2b758fb9-62ea-4834-9caf-0b0e887f328a", "name": "TDG API", "description": "A collection of all the endpoints provided by THE DATA GROUP to interact with the TDG database via API and get the needed information by hitting the respective endpoints.\n\n# **TDG API documentation**\n\nSee the full API documentation [here](https://google.com).", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id": "43934400" }, "item": [ { "name": "Quickstart Guide for TDG API Usage", "item": [], "description": "## Introduction\n\nThis guide provides a step-by-step overview for using APIs, including how to set up Postman, authenticate, make various types of requests, responses codes, and use cURL commands.\n\n## Prerequisites\n\nBefore you start, ensure you have:\n\n- A working internet connection\n \n- Postman installed (available at [Postman](https://www.postman.com/downloads/))\n \n- Basic knowledge of HTTP method (POST)\n \n- Access to the API documentation for the specific API you are using\n \n\n## Setting Up Postman\n\n1. **Download and Install Postman**: Follow the installation instructions for your operating system from the [Postman website](https://www.postman.com/downloads/).\n \n2. **Open Postman**: Launch the application once installed.\n \n3. **Create a Postman Account** (optional but recommended): Sign up or log in to sync your work and collaborate.\n \n\n## Setup TDG Collection\n\n1. Fork the collection into your workspace.\n \n2. Select the TDG environment.\n \n3. **API Key**: Obtain the API key from the service provider.\n \n - In Postman, go to the Environments tab.\n \n - Enter the api key corresponding to **x-api-key.**\n \n4. Make a request by clicking on the endpoint folder -> endpoint request.\n \n\n## **API Response Codes**\n\n**The following is a table of potential output response codes and messages to indicate if the search was successful or returned an error.**\n\n| **Output Field** | **Description** |\n| --- | --- |\n| **200**
**204**
**400**
**440**

**429**

**401**
**500** | **Successful.**
**No Records found.**
**Missing required parameter(s).**
**Too many results. Please refine your search criteria.**
**You have reached the maximum number of transactions allowed.**
**The user is invalid (verify your credentials).**
**System error. Retry search, if failure continues, contact support.** |\n\n## Best Practices\n\n- **Read the Documentation**: Always refer to the API documentation for details on endpoints, parameters, and authentication.\n \n- **Use Environment Variables**: In Postman, use environment variables for API keys and tokens to avoid hardcoding them in requests.\n \n- **Error Handling**: Implement proper error handling to manage API failures gracefully.\n \n\n## Troubleshooting\n\n- **Check Connectivity**: Ensure you have an active internet connection.\n \n- **Verify Credentials**: Double-check your API keys, tokens, and other credentials.\n \n- **Consult Documentation**: Look for troubleshooting tips and common issues in the API documentation." }, { "name": "Phone Lookup", "item": [ { "name": "phone_lookup", "request": { "auth": { "type": "apikey", "apikey": [ { "key": "value", "value": "{{x-api-key}}", "type": "string" }, { "key": "key", "value": "x-api-key", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\r\n \"Phone\":\"Required <10 digit numeric phone number (without spaces, dashes, or parentheses)>\"\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "https://testapi.tdg1.io/v3/lookup/phone", "protocol": "https", "host": [ "testapi", "tdg1", "io" ], "path": [ "v3", "lookup", "phone" ] }, "description": "**The Phone Lookup accepts Phone as input and performs a reverse phone search against The Data Group’s phones identity data sources and returns the matched record along with verification scores.**" }, "response": [ { "name": "phone_lookup", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\r\n \"Phone\":\"Required <10 digit numeric phone number (without spaces, dashes, or parentheses)>\"\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{newlookupbaseUrl}}/phone", "host": [ "{{newlookupbaseUrl}}" ], "path": [ "phone" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sat, 07 Jun 2025 06:49:01 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Length", "value": "326" }, { "key": "Connection", "value": "keep-alive" }, { "key": "x-amzn-RequestId", "value": "03dfe7d3-728e-4b16-8ff3-f2f7e848ae79" }, { "key": "Access-Control-Allow-Origin", "value": "*" }, { "key": "x-amz-apigw-id", "value": "LyASOF_JIAMEOpA=" }, { "key": "X-Amzn-Trace-Id", "value": "Root=1-6843e0da-249619e900c5fa3318972b8a;Parent=460814f0abcb2665;Sampled=0;Lineage=1:a84661b4:0" } ], "cookie": [], "body": "{\n \"Name\": {\n \"LName\": \"Sreenivasan\",\n \"FName\": \"Ramji\",\n \"MName\": \"\"\n },\n \"Address\": {\n \"House\": \"13055\",\n \"PreDir\": \"\",\n \"Street\": \"Garridan\",\n \"StrType\": \"Ave\",\n \"PostDir\": \"\",\n \"AptType\": null,\n \"City\": \"Windermere\",\n \"State\": \"FL\",\n \"Zip\": \"34786\",\n \"Z4\": \"6430\",\n \"CNTY\": \"Orange\",\n \"Deliverable\": true,\n \"ValDate\": \"5/1/2025\"\n },\n \"trace\": \"c31c2d88-2d57-4dcf-ac12-f5d4e139a8871\"\n}" } ] } ], "description": "**The Phone Lookup API accepts Phone as an input and performs a reverse phone search against The Data Group’s phones identity data sources and returns the matched record along with verification scores.**\n\n## **Input**\n\n**The following table is a list of input fields accepted by the API.**\n\n| **Input Field** | **Description** |\n| --- | --- |\n| **Phone (Required)** | 10 digit numeric phone number (without spaces, dashes, or parentheses) |" }, { "name": "Email Lookup", "item": [ { "name": "email_lookup", "request": { "auth": { "type": "apikey", "apikey": [ { "key": "value", "value": "{{x-api-key}}", "type": "string" }, { "key": "key", "value": "x-api-key", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\r\n \"Email\": \"Required \"\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "https://testapi.tdg1.io/v3/lookup/email", "protocol": "https", "host": [ "testapi", "tdg1", "io" ], "path": [ "v3", "lookup", "email" ] }, "description": "**The Email Lookup accepts Email address as input, searches against The Data Group’s Email Identity database, and returns Name, Address, and Email flag information.**" }, "response": [ { "name": "email_lookup", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\r\n \"Email\": \"Required \"\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{newlookupbaseUrl}}/email", "host": [ "{{newlookupbaseUrl}}" ], "path": [ "email" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sat, 31 May 2025 07:52:28 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Length", "value": "313" }, { "key": "Connection", "value": "keep-alive" }, { "key": "x-amzn-RequestId", "value": "89b11697-aa3f-434a-8479-a712895fd700" }, { "key": "Access-Control-Allow-Origin", "value": "*" }, { "key": "x-amz-apigw-id", "value": "LbFBWHNioAMEV5w=" }, { "key": "X-Amzn-Trace-Id", "value": "Root=1-683ab53b-7bd726aa6a8afbf371bd531d;Parent=5d63bcd8594dba01;Sampled=0;Lineage=1:a84661b4:0" } ], "cookie": [ { "expires": "Invalid Date", "domain": "", "path": "" } ], "body": "{\n \"Name\": {\n \"LName\": \"JOHN\",\n \"FName\": \"SMITH\",\n \"MName\": \"\"\n },\n \"Address\": {\n \"House\": \"1021\",\n \"PreDir\": \"\",\n \"Street\": \"Street\",\n \"StrType\": \"\",\n \"PostDir\": \"\",\n \"AptType\": \"\",\n \"AptNbr\": \"\",\n \"City\": \"LAKES\",\n \"State\": \"FL\",\n \"Zip\": \"91546\",\n \"CNTY\": \"053\",\n \"Deliverable\": \"Y\",\n \"ValDate\": \"20190601\"\n },\n \"trace\": \"924c3bde-c3c4-4a27-8253-e3b0109ae67b2\"\n}" } ] } ], "description": "**The Email Lookup API accepts Email address as input, searches against The Data Group’s Email Identity database, and returns Name, Address, and Email flag information.**\n\n## **Input**\n\n**The following table is a list of input fields accepted by the API.**\n\n| **Input Field** | **Description** |\n| --- | --- |\n| **Email** (**Required**) | Email address. 100 Characters max. |" }, { "name": "Phone Append", "item": [ { "name": "phone_append", "request": { "auth": { "type": "apikey", "apikey": [ { "key": "value", "value": "{{x-api-key}}", "type": "string" }, { "key": "key", "value": "x-api-key", "type": "string" } ] }, "method": "POST", "header": [], "url": { "raw": "https://testapi.tdg1.io/v3/append/phone", "protocol": "https", "host": [ "testapi", "tdg1", "io" ], "path": [ "v3", "append", "phone" ] }, "description": "**Append Phone Numbers matches names and addresses to your input.**\n\n### **Following parameters are required to make the request.**\n\n- **FName + LName + Address1 + Zip**" }, "response": [ { "name": "phone_append", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\r\n \"FName\": \"Required combination of Last Name, Address1 and Zip is required. \" ,\r\n \"LName\": \"Required combination of First Name, Address1 and Zip is required. \",\r\n \"Address1\": \"Required combination of First Name, Last Name and Zip is required.

\",\r\n \"Zip\": \"Required combination of First Name, Last Name and Address is required. <5 digit numeric USPS zip code. * Either City/State or Zip is required.>\"\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{newappendbaseUrl}}/phone", "host": [ "{{newappendbaseUrl}}" ], "path": [ "phone" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sun, 08 Jun 2025 16:57:08 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Length", "value": "191" }, { "key": "Connection", "value": "keep-alive" }, { "key": "x-amzn-RequestId", "value": "7e838780-bdb0-4931-8d4b-ae376df10cc5" }, { "key": "x-amz-apigw-id", "value": "L2sTVF4foAMEf5g=" }, { "key": "X-Amzn-Trace-Id", "value": "Root=1-6845c0e1-0da1c017544b251978d7504e;Parent=291b9424c23bcc09;Sampled=0;Lineage=1:a84661b4:0" } ], "cookie": [ { "expires": "Invalid Date", "domain": "", "path": "" } ], "body": "{\n \"Phone\": \"(555) 555-5555\",\n \"PhoneType\": \"Wireless\",\n \"FirstSeen\": \"12/1/2010\",\n \"LastSeen\": \"5/1/2025\",\n \"TelcoName\": \"Telconame\",\n \"PHV\": 1,\n \"trace\": \"30e4cd15-fbea-4849-a198-8a55189deaba1\"\n}" } ] } ], "description": "**Append Phone Numbers matches names and addresses to your input.**\n\n## **Input**\n\n**The following table displays variables that can be sent to the Phone ID Append endpoint to query for phone numbers matching names and addresses.**\n\n| **Input Field** | **Description** |\n| --- | --- |\n| **FName (Required)**
**LName (Required**)
**Address1 (Required)**

**Zip** (**Required**) | First name, 15 characters max.
Last name, 15 characters max.
Address line 1 (example: 123 Main Street), 60 characters max.
5 digit numeric USPS zip code. \\* Either City/State or Zip is required. |\n\n### **Following parameters are required to make the request.**\n\n- **FName + LName + Address1 + Zip**" }, { "name": "Email Verify", "item": [ { "name": "email_verify", "request": { "auth": { "type": "apikey", "apikey": [ { "key": "value", "value": "{{x-api-key}}", "type": "string" }, { "key": "key", "value": "x-api-key", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\r\n \"Email\":\"<(Required) \"\r\n}\r\n", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{verifybaseUrl}}/email", "host": [ "{{verifybaseUrl}}" ], "path": [ "email" ] }, "description": "**The Email Verify accepts Email as input and performs a validation against The Data Group’s email data sources and returns the verification status.**" }, "response": [ { "name": "email_verify", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\r\n \"Email\":\"<(Required) \"\r\n}\r\n", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{verifybaseUrl}}/email", "host": [ "{{verifybaseUrl}}" ], "path": [ "email" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Thu, 25 Jul 2024 11:58:08 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Length", "value": "63" }, { "key": "Connection", "value": "keep-alive" }, { "key": "x-amzn-RequestId", "value": "bd3834a6-08bf-48b1-a318-b1c338e5c608" }, { "key": "x-amz-apigw-id", "value": "bd6YbGBxIAMEVcg=" }, { "key": "X-Amzn-Trace-Id", "value": "Root=1-66a23dcf-4ee496ce388488524ed4364d;Parent=595691cd04b16efd;Sampled=0;lineage=df36e4d3:0" } ], "cookie": [], "body": "{\n \"Email\": \"Tom.Smith@Sample.com\",\n \"Result\": \"Complainer\"\n}" } ] } ], "description": "**The Email Verify API accepts Email as input and performs a validation against The Data Group’s email data sources and returns the verification status.**\n\n## **Input**\n\n**The following table is a list of input fields accepted by the API.**\n\n| **Input Field** | **Description** |\n| --- | --- |\n| **Email (Required)** | Email address to be validated |" }, { "name": "Email Append", "item": [ { "name": "email_append", "request": { "auth": { "type": "apikey", "apikey": [ { "key": "value", "value": "{{x-api-key}}", "type": "string" }, { "key": "key", "value": "x-api-key", "type": "string" } ] }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\r\n \"FName\": \"(Required if LName, Address1, Zip is included) \",\r\n \"LName\": \"(Required if FName, Address1, Zip is included) \",\r\n \"Address1\": \"(Required if FName, LName and Zip is included)

\",\r\n \"Zip\": \"(Required if FName, LName and Address is included) <5 digit numeric USPS zip code. * Either City/State or Zip is required>\"\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "https://testapi.tdg1.io/v3/append/email", "protocol": "https", "host": [ "testapi", "tdg1", "io" ], "path": [ "v3", "append", "email" ] }, "description": "**Update new email to names and addresses. If the first pass does not result in a match, the system can automatically search based on the phone number if available on the record. The Phone match can be turned on or off using the “IncludeTNR” parameter.**\n\n### **Following parameters are required to make the request.**\n\n- **FName + LName + Address1 + Zip**" }, "response": [ { "name": "email_append", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\r\n \"FName\": \"(Required if LName, Address1, Zip is included) \",\r\n \"LName\": \"(Required if FName, Address1, Zip is included) \",\r\n \"Address1\": \"(Required if FName, LName and Zip is included)

\",\r\n \"Zip\": \"(Required if FName, LName and Address is included) <5 digit numeric USPS zip code. * Either City/State or Zip is required>\"\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{newappendbaseUrl}}/email", "host": [ "{{newappendbaseUrl}}" ], "path": [ "email" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sun, 08 Jun 2025 16:42:51 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Length", "value": "83" }, { "key": "Connection", "value": "keep-alive" }, { "key": "x-amzn-RequestId", "value": "a4b7765a-4201-4625-b478-f366033721c7" }, { "key": "x-amz-apigw-id", "value": "L2qNfEWvIAMEGjw=" }, { "key": "X-Amzn-Trace-Id", "value": "Root=1-6845bd89-405a93261dc6524966abe253;Parent=43facf5fcd460dab;Sampled=0;Lineage=1:a84661b4:0" } ], "cookie": [ { "expires": "Invalid Date", "domain": "", "path": "" } ], "body": "{\n \"email\": \"Tom.smith@gmail.com\",\n \"trace\": \"a79835d0-506a-4c1a-a6f3-6c4b94f96a7e1\"\n}" } ] } ], "description": "**Email Append API update new email to names and addresses. If the first pass does not result in a match, the system can automatically search based on the phone number if available on the record. The Phone match can be turned on or off using the “IncludeTNR” parameter.**\n\n## **Input**\n\n**Input for the Email Append endpoint requires city, state, and zip to return a successful response. The following table lists the variables that can be sent as input to the API.**\n\n| **Input Field** | **Description** |\n| --- | --- |\n| **FName** (**Required)**
**LName** (**Required)**
**Address1** (**Required)**
**Zip** (**Required**) | First name, 15 characters max.
Last name, 20 characters max.
Address line 1, 64 characters max.
5 digit numeric USPS zip code. \\* Either City/State or Zip is required. |\n\n### **Following parameters are required to make the request.**\n\n- **FName + LName + Address1 + Zip**" }, { "name": "ID Verify", "item": [ { "name": "id_verify", "request": { "auth": { "type": "apikey", "apikey": [ { "key": "value", "value": "{{x-api-key}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" }, { "key": "key", "value": "x-api-key", "type": "string" } ] }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\r\n \"FName\": \"(Required if want to verify FName, Phone and Email is required when x accuracy is needed with FName) \",\r\n \"LName\": \"(Required if want to verify LName) \",\r\n \"Address1\": \"(Required if want to verify Address, Phone and Email is required when relative accuracy is needed with Address)

\",\r\n \"Zip\": \"(Required if want to verify Zip, Phone and Email is required when relative accuracy is needed with Zip) <5 digit numeric USPS zip code. * Either City/State or Zip is required.>\",\r\n \"Phone\": \"(Required if want to verify Phone, other parameters are needed if relative accuracy with other params are required) <10 digit numeric phone number (without spaces, dashes, or parentheses>)\",\r\n \"Email\": \"(Required if want to verify Email, other parameters are needed if relative accuracy with other params are required) \"\r\n}\r\n", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{verifybaseUrl}}/id", "host": [ "{{verifybaseUrl}}" ], "path": [ "id" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Thu, 25 Jul 2024 12:10:04 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Length", "value": "576" }, { "key": "Connection", "value": "keep-alive" }, { "key": "x-amzn-RequestId", "value": "1f5f98cb-d76d-41a4-95ea-21392ffce7a5" }, { "key": "x-amz-apigw-id", "value": "bd8ITE25IAMEctA=" }, { "key": "X-Amzn-Trace-Id", "value": "Root=1-66a2409b-6347ee40139767973f47aacc;Parent=5b3d99ba5a0c24e2;Sampled=0;lineage=a14e4a50:0" } ], "cookie": [], "body": "{\n \"IDScores\": {\n \"ValidAddress\": \"85\",\n \"ValidPhone\": \"0\",\n \"ValidEmail\": \"\",\n \"ValidName\": \"100\",\n \"ValidZip\": \"0\",\n \"Deceased\": \"100\",\n \"NameToPhone\": \"0\",\n \"NameToEmail\": \"\",\n \"NameToAddress\": \"0\",\n \"AddressToPhone\": \"0\",\n \"AddressToEmail\": \"\",\n \"PhoneToEmail\": \"\",\n \"ZipToPhone\": \"\",\n \"USLocation\": \"\",\n \"ValidPhone2\": \"\",\n \"NameToPhone2\": \"\",\n \"AddressToPhone2\": \"\",\n \"Phone2ToEmail\": \"\",\n \"PhoneConfidenceScore\": \"0\",\n \"Phone2ConfidenceScore\": \"\",\n \"AddressConfidenceScore\": \"0\",\n \"ValidCount\": \"1.8\",\n \"LinkageCount\": \"0\",\n \"RiskFlagCount\": \"0\",\n \"ValidationSummary\": \"FAIL\",\n \"LinkageSummary\": \"FAIL\",\n \"RiskFlagSummary\": \"PASS\",\n \"IDVerifyScore\": \"76\"\n }\n}" } ] } ], "description": "**ID Verify service verifies consumer contact information for purposes of scoring individuals and for identifying and reducing potential fraud and risk. The product receives consumer contact information as input and returns scores to reflect the level of verification. The base version of ID Ver returns an IDVerifyScore of 0 - 100, which reflects the overall validity of input identity markers. The IDVerifyScore can be used to make pass/fail decisions about the veracity of a given individual.**\n\n| **Input Field** | **Description** |\n| --- | --- |\n| **FName**

**LName**

**Address1**

**Zip**

**Phone

Email** | (Required if want to verify FName, Phone and Email is required when relative accuracy is needed with FName). First name, 15 characters max.

(Required if want to verify LName), Last name, 20 characters max. Phone and Email is required when relative accuracy is needed with LName.

(Required if want to verify Address, Phone and Email is required when relative accuracy is needed with Address), Address line 1, 64 characters max.

(Required if want to verify Zip, Phone and Email is required when relative accuracy is needed with Zip) 5 digit numeric USPS zip code. \\* Either City/State or Zip is required.

(Required if want to verify Phone, other parameters are needed if relative accuracy with other params are required), 10 digit numeric phone number (without spaces, dashes, or parentheses.

(Required if want to verify Email, other parameters are needed if relative accuracy with other params are required) Email address, 100 characters max. |\n\n### **One of the following parameter is required to make the request.**\n\n- **Phone**\n \n- **Email**\n \n- **FName + LName + Address1 + Zip**" }, { "name": "Demographic append", "item": [ { "name": "demographic_append", "request": { "auth": { "type": "apikey", "apikey": [ { "key": "value", "value": "{{x-api-key}}", "type": "string" }, { "key": "key", "value": "x-api-key", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\r\n \"FName\": \"(Should be a combination of FName, LName, Zip and Address parameters; Phone or Email is Required) \",\r\n \"LName\": \"(Should be a combination of FName,LName,Zip and Address parameters; Phone or Email is Required) \",\r\n \"Address1\": \"(Should be a combination of FName,LName,Zip and Address parameters; Phone or Email is Required)

\",\r\n \"Zip\": \"(Should be a combination of FName,LName,Zip and Address parameters; Phone or Email is Required) <5 digit numeric USPS zip code. * Either City/State or Zip is required.>\",\r\n \"Phone\": \"(Required if Email is not included and other parameters are included) <10 digit numeric phone number (without spaces, dashes, or parentheses)>\",\r\n \"Email\": \"(Required if phone is not included and other parameters are included) \",\r\n \"City\":\"Optional \",\r\n \"State\": \"Optional \"\r\n\r\n}\r\n\r\n\r\n \r\n \r\n\r\n\r\n", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{appendbaseUrl}}/demographic", "host": [ "{{appendbaseUrl}}" ], "path": [ "demographic" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Thu, 25 Jul 2024 12:18:29 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Length", "value": "633" }, { "key": "Connection", "value": "keep-alive" }, { "key": "x-amzn-RequestId", "value": "4218ed96-a0d1-44da-a9ff-c1c5c969d974" }, { "key": "x-amz-apigw-id", "value": "bd9XYGhSoAMEPaQ=" }, { "key": "X-Amzn-Trace-Id", "value": "Root=1-66a24295-6b91f7e67853f19d1d0e57a5;Parent=4f6f486e09d8cf31;Sampled=0;lineage=a14e4a50:0" } ], "cookie": [], "body": "{\n \"Demographics\": {\n \"Gender\": \"\",\n \"Age\": \"\",\n \"DOB\": \"\",\n \"LOR\": \"13\",\n \"Homeowner\": \"H\",\n \"EHI\": \"F\",\n \"DwellType\": \"S\",\n \"Married\": \"M\",\n \"MedYrBld\": \"1972\",\n \"MobHome\": \"\",\n \"Pool\": \"\",\n \"FirePl\": \"Y\",\n \"SglParent\": \"\",\n \"HHNBRSR\": \"Y\",\n \"CreditCard\": \"Y\",\n \"WealthScr\": \"E\",\n \"CharityDnr\": \"Y\",\n \"MrktHomeVal\": \"C\",\n \"Education\": \"B\",\n \"Ethnicity\": \"\",\n \"ChildCd\": \"\",\n \"ChildAgeCd\": \"\",\n \"ChildNbrCd\": \"A\",\n \"VehLux\": \"Y\",\n \"VehSuv\": \"\",\n \"VehTrk\": \"Y\",\n \"PctBlk\": \"R\",\n \"PctWht\": \"F\",\n \"PctHsp\": \"N\",\n \"PctAsi\": \"T\",\n \"PctEngSpeak\": \"G\",\n \"PctSpnSpeak\": \"O\",\n \"PctAsiaSpeak\": \"\",\n \"PctSFDU\": \"A\",\n \"PctMFDU\": \"\",\n \"MHV\": \"D\",\n \"MOR\": \"A\",\n \"PctAuto\": \"A\",\n \"MedSchl\": \"136\",\n \"PctWhiteCollar\": \"P\",\n \"PctBlueCollar\": \"R\",\n \"PctOccO\": \"H\",\n \"DemoLvl\": \"1\"\n }\n}" } ] } ], "description": "**Demographic Profile Append uses input identity markers such as name, address, phone or email to generate an identity and searches against The Datagroup’s Demographic Profile database, and returns the single best matching record with Demographic attributes, Life style attributes and Geo credit elements.**\n\n## **Input**\n\n**For Identity Resolution, Demographic Profile Append requires phone, email or name and address inputs.**\n\n| **Input Field** | **Description** |\n| --- | --- |\n| **FName**

**LName**

**Address1**

**Zip**

**Phone

Email

City

State** | Should be a combination of FName, LName, Zip and Address parameters; Phone or Email is Required) First name, 15 characters max.

Should be a combination of FName, LName, Zip and Address parameters; Phone or Email is Required) Last name, 20 characters max.

Should be a combination of FName, LName, Zip and Address parameters; Phone or Email is Required), Address line 1, 64 characters max.

Should be a combination of FName, LName, Zip and Address parameters; Phone or Email is Required), 5 digit numeric USPS zip code. \\* Either City/State or Zip is required.

Required if Email is not included and other parameters are included), 10 digit numeric phone number (without spaces, dashes, or parentheses.

Required if phone is not included and other parameters are included), Email address, 100 characters max.

Optional, City name, 28 characters max. \\* Either City/State or Zip is required.

Optional |" }, { "name": "Auto Append", "item": [ { "name": "auto_append", "request": { "auth": { "type": "apikey", "apikey": [ { "key": "value", "value": "{{x-api-key}}", "type": "string" }, { "key": "key", "value": "x-api-key", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\r\n \"Phone\": \"(Required if Email and other parameters are not included) <10 digit numeric phone number (without spaces, dashes, or parentheses>)\",\r\n \"Email\": \"(Required if Phone and other parameters are not included) \",\r\n \"FullName\": \"(FullName, Address1 and Zip parameter are required altogether) \",\r\n \"Address1\": \"(FullName, Address1 and Zip parameter are required altogether)

\",\r\n \"Zip\": \"(FullName, Address1 and Zip parameter are required altogether) <5 digit numeric USPS zip code. * Either City/State or Zip is required>\"\r\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{appendbaseUrl}}/auto", "host": [ "{{appendbaseUrl}}" ], "path": [ "auto" ] }, "description": "**The Auto Append API uses input identity markers such as name, address, phone or email to generate an identity and searches against The Data Group’s vehicle profile database to return up to four vehicle records and includes vehicle attribute IDs.**\n\n### **One of the following parameter is required to make the request.**\n\n- **Phone**\n \n- **Email**\n \n- **FullName + Address1 + Zip**" }, "response": [ { "name": "auto_append", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\r\n \"Phone\": \"(Required if Email and other parameters are not included) <10 digit numeric phone number (without spaces, dashes, or parentheses>)\",\r\n \"Email\": \"(Required if Phone and other parameters are not included) \",\r\n \"FullName\": \"(FullName, Address1 and Zip parameter are required altogether) \",\r\n \"Address1\": \"(FullName, Address1 and Zip parameter are required altogether)

\",\r\n \"Zip\": \"(FullName, Address1 and Zip parameter are required altogether) <5 digit numeric USPS zip code. * Either City/State or Zip is required>\"\r\n}\r\n\r\n\r\n \r\n", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{appendbaseUrl}}/auto", "host": [ "{{appendbaseUrl}}" ], "path": [ "auto" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Thu, 25 Jul 2024 12:30:54 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Length", "value": "1062" }, { "key": "Connection", "value": "keep-alive" }, { "key": "x-amzn-RequestId", "value": "7cff6a51-e6cd-4c93-8bec-5673941c40c1" }, { "key": "x-amz-apigw-id", "value": "bd_LwF4koAMERTQ=" }, { "key": "X-Amzn-Trace-Id", "value": "Root=1-66a2457e-7c906ab4552e069a69ccb505;Parent=669c99c6365d4021;Sampled=0;lineage=c1547a1c:0" } ], "cookie": [], "body": "{\n \"Name\": {\n \"FName\": \"Tom\",\n \"LName\": \"Smith\",\n \"MName\": \"A\",\n \"Suffix\": \"\"\n },\n \"Address\": {\n \"House\": \"123\",\n \"PreDir\": \"\",\n \"Street\": \"LONG LAKE\",\n \"StrType\": \"\",\n \"PostDir\": \"\",\n \"AptType\": \"\",\n \"AptNbr\": \"\",\n \"City\": \"Orlando\",\n \"State\": \"FL\",\n \"Zip\": \"12345\",\n \"Z4\": \"9111\",\n \"DPC\": \"564\",\n \"CRTE\": \"R019\",\n \"CNTY\": \"SEM\",\n \"Z4Type\": \"S\",\n \"DPV\": \"Y\",\n \"Vacant\": \"N\",\n \"MSA\": \"5960\",\n \"CBSA\": \"36740\"\n },\n \"IDS\": {\n \"PID\": \"Y67511710678784\",\n \"AID\": \"Y00000676763\",\n \"HHID\": \"Y0000007676\"\n },\n \"Vehicle\": {\n \"Make\": \"Hyundai\",\n \"Model\": \"Creta\",\n \"Year\": \"2020\",\n \"ClassCD\": \"Sedan\",\n \"FuelTypeCD\": \"G\",\n \"MFGCD\": \"\",\n \"StyleCD\": \"UTIL\",\n \"Mileages\": \"A\",\n \"ODate\": \"20001025\"\n },\n \"Vehicle2\": {\n \"Make\": \"Porsche\",\n \"Model\": \"camrea\",\n \"Year\": \"2019\",\n \"ClassCD\": \"Sedan\",\n \"FuelTypeCD\": \"G\",\n \"MFGCD\": \"\",\n \"StyleCD\": \"UTIL\",\n \"Mileages\": \"A\",\n \"ODate\": \"20101103\"\n },\n \"Vehicle3\": {\n \"Make\": \"TOYOTA\",\n \"Model\": \"Corolla Altis\",\n \"Year\": \"2019\",\n \"ClassCD\": \"Sedan\",\n \"FuelTypeCD\": \"G\",\n \"MFGCD\": \"\",\n \"StyleCD\": \"PICKUP\",\n \"Mileages\": \"A\",\n \"ODate\": \"20090809\"\n },\n \"Vehicle4\": {\n \"Make\": \"\",\n \"Model\": \"\",\n \"Year\": \"\",\n \"ClassCD\": \"\",\n \"FuelTypeCD\": \"\",\n \"MFGCD\": \"\",\n \"StyleCD\": \"\",\n \"Mileages\": \"\",\n \"ODate\": \"\"\n }\n}" } ] } ], "description": "**The Auto Append API uses input identity markers such as fullname, address, phone or email to generate an identity and searches against The Data Group’s vehicle profile database to return up to four vehicle records and includes vehicle attribute IDs.**\n\n## **Input**\n\n**The Auto Append API accepts identity data elements including fullname, address, phone, and email as input. The following table describes the API input variables.**\n\n| **Input Field** | **Description** |\n| --- | --- |\n| Phone

Email

FullName

Address1

Zip | (Required if Email and other parameters are not included), 10 digit numeric phone number (without spaces, dashes, or parentheses.

(Required if Phone and other parameters are not included), Email address, 100 characters max.

(FullName, Address1 and Zip parameter are required altogether), Individual FullName.

(FullName, Address1 and Zip parameter are required altogether).

(FullName, Address1 and Zip parameter are required altogether), 5 digit numeric USPS zip code. \\* Either City/State or Zip is required. |\n\n### **One of the following parameters are required to make the request.**\n\n- **Phone**\n \n- **Email**\n \n- **FullName + Address1 + Zip**" }, { "name": "TCPA Verify", "item": [ { "name": "tcpa_verify", "request": { "auth": { "type": "apikey", "apikey": [ { "key": "value", "value": "{{x-api-key}}", "type": "string" }, { "key": "key", "value": "x-api-key", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\r\n \"phone\": \"(Required) <10 digit numeric phone number (without spaces, dashes, or parentheses)>\",\r\n \"last_name\": \"(Required) \"\r\n}\r\n\r\n\r\n\r\n", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{verifybaseUrl}}/tcpa", "host": [ "{{verifybaseUrl}}" ], "path": [ "tcpa" ] }, "description": "**TCPA Verify is designed to help clients mitigate TCPA risk, both by identifying wireless numbers, and by offering identity verification (to verify called party consent).**" }, "response": [ { "name": "tcpa_verify", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\r\n \"phone\": \"(Required) <10 digit numeric phone number (without spaces, dashes, or parentheses)>\",\r\n \"last_name\": \"(Required) \"\r\n}\r\n\r\n", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{verifybaseUrl}}/tcpa", "host": [ "{{verifybaseUrl}}" ], "path": [ "tcpa" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Thu, 25 Jul 2024 12:28:42 GMT" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Length", "value": "42" }, { "key": "Connection", "value": "keep-alive" }, { "key": "x-amzn-RequestId", "value": "2caa7694-12ac-46a7-9166-2211df6c138f" }, { "key": "x-amz-apigw-id", "value": "bd-3JHqloAMEa5w=" }, { "key": "X-Amzn-Trace-Id", "value": "Root=1-66a244fa-7d6dc31225a1e635790ca284;Parent=29eaa806a2a05fb7;Sampled=0;lineage=0c5721b6:0" } ], "cookie": [], "body": "{\n \"verification_code\": \"U\",\n \"phone_type\": \"W\"\n}" } ] } ], "description": "**TCPA Verify is designed to help clients mitigate TCPA risk, both by identifying wireless numbers, and by offering identity verification (to verify called party consent).**\n\n## **Input**\n\n**The following table is a list of input fields accepted by the API.**\n\n| **Input Field** | **Description** |\n| --- | --- |\n| **phone (Required)**

**last_name (Required)** | 10 digit numeric phone number (without spaces, dashes, or parentheses)
Last name |" } ], "variable": [ { "key": "lookupbaseUrl", "value": "https://api.tdg1.io/v2/lookup/" }, { "key": "https://api.tdg1.io/v2/append/phone", "value": "appendbaseUrl" }, { "key": "appendbaseUrl", "value": "https://api.tdg1.io/v2/append" }, { "key": "x-api-key", "value": "0bmPQVEmHa2LC4u4Sv77EBuFlmHsU8Y6n55ls1Fi" }, { "key": "verifybaseUrl", "value": "https://api.tdg1.io/v2/verify/" } ] }