Fetch is a real-time search processing and augmentation platform that transforms your dataset with fresh and additional data attributes. Developers should review below to gain further information on what Fetch is and how to start processing against our 300,000,000-record database.

FETCH API

Our APIs work great for real-time enrichment when you are looking for a single record or a medium sized array of records to be enriched and speed of return is important. Fetch uses a RESTful API that provides multiple methods for enhancement in real-time.

Getting Started

  1. Click here to request an API key.
  2. In your request please provide one or more static IP addresses from which your Fetch requests originate.
  3. We will get back with your key and provide the testing endpoint.
  4. Review below, which API you want to use and download the documentation.
  5. Build a test request using custom code or use a tool like Postman to send Fetch your requests.
Note: All requests must come from the whitelisted IP address(s) you provided. The request must also contain your API key.

Available FETCH API Methods

Fetch Apis

Address
Augment Data Based Address Only (Name Optional)

Submit an address (name is optional) and receive augmented address, phone, email, household name data, property data, and vehicle data when available.

Request
{
	"HouseNumber": "111",
	"StreetDirection": "NW",
	"StreetName": "Main St",
	"ApartmentNumber": "1B",
	"City": "Anytown",
	"State": "NE",
	"Zip": "68000",
	"FirstName": "John",
	"LastName": "Smith",
	"PrimaryPhone": "4020000000",
	"SecondaryPhone": "2070000000"
}
Response
{
	"FirstName": "John",
	"MiddleInitial": "A",
	"LastName": "Smith",
	"Gender": "M",
	"EstimatedAge": "1/1/2001",
	"HouseHoldMembers": [
		{
			"FirstName": "SUZIE",
			"MiddleInitial": "Q",
			"Gender": "F",
			"EstimatedAge": “1/1/2000”
		},
		{
			"FirstName": "Larry"
			"MiddleInitial": "E",
			"Gender": "M"
			"EstimatedAge": "2/2/2002"
		}
	],
	"HouseNumber": "100",
	"StreetDirection": "NE",
	"StreetName": "Main St",
	"ApartmentNumber": "1B",
	"ApartmentBuildingType": "Suite",
	"City": "Anytown",
	"State": "NE",
	"ZipCode": "68000",
	"ZipCode4": "1111",
	"PhoneNumbers": [
 		{
			"PhoneNumber": "4020000000",
			"DoNotCall": "Y"
		},
		{
			"PhoneNumber": "2070000000",
			"DoNotCall": "Y"

		}
			],
	"CellPhones": [
		{
			"PhoneNumber": "4020000001",
			"DoNotCall": "Y"

		},
		{
			"PhoneNumber": "2070000001",
			"DoNotCall": "Y"

		}
	],
	"CensusTract": "123456",
	"NumberOfUnits": "20-49",
	"HomeownerConfirmed": "Y",
	"LengthOfResidence": 10,
	"CrossStreet": "Mayne St",
	"CountyCode": "000",
	"MortgageDate": "1/1/2000",
	"PurchaseAmount":  "180K",
	"EstimateHomeValue": "200K",
	"BuildingSquareFootage": "3700",
	"AutoRenewalMonth": 6,
	"Autos": [
		{
			"VIN": "WFGR404H0614788",
			"Make": "BMW",
			"Model": "6 SERIES",
			"Year": "1987"
		},
		{
			"VIN": "1FAFP5FECA189070",
			"Make": "Ford",
			"Model": "Taurus",
			"Year": "2006"
		}
	],
	"HasBoat": "Y",
	"HasMotorcycle": "N",
	"HasRV”: "Y",
	"EmailAddress": "john.smith@gmail.com",
	"EmailAddresses":[
		"john.smith@gmail.com"
	],
	"AddressType": "",
	"Income": "F",
	"Language": "E",
	"BuildingSquareFeet": "3005",
	"SubdivisionName": "CHARLESTON HEIGHTS ADD",
	"YearBuilt": "2007",
	"Heating": "WA0",
	"Fuel": "",
	"HomeHeatIndicator": "",
	"Acres": ".1800",
	"LandSquareFootage": "7841",
	"Utilities": "",
	"HeadHousehold": ""	
}
Address with Name
Augment Data Based Address and Name

Submit an address and name, email or phone number and receive augmented address, phone, email, household name data, property data, and vehicle data when available.

Request
{
	"HouseNumber": "111",
	"StreetDirection": "NW",
	"StreetName": "Main St",
	"ApartmentNumber": "1B",
	"City": "Anytown",
	"State": "NE",
	"Zip": "68000",
	"FirstName": "John",
	"LastName": "Smith",
	"PrimaryPhone": "4020000000",
	"SecondaryPhone": "2070000000",
	"EmailAddress": "john.smith@gmail.com"
}
Response
{
	"FirstName": "John",
	"MiddleInitial": "A",
	"LastName": "Smith",
	"Gender": "M",
	"EstimatedAge": "1/1/2001",
	"HouseHoldMembers": [
		{
			"FirstName": "SUZIE",
			"MiddleInitial": "Q",
			"Gender": "F",
			"EstimatedAge": “1/1/2000”
		},
		{
			"FirstName": "Larry"
			"MiddleInitial": "E",
			"Gender": "M"
			"EstimatedAge": "2/2/2002"
		}
	],
	"HouseNumber": "100",
	"StreetDirection": "NE",
	"StreetName": "Main St",
	"ApartmentNumber": "1B",
	"ApartmentBuildingType": "Suite",
	"City": "Anytown",
	"State": "NE",
	"ZipCode": "68000",
	"ZipCode4": "1111",
	"PhoneNumbers": [
 		{
			"PhoneNumber": "4020000000",
			"DoNotCall": "Y"
		},
		{
			"PhoneNumber": "2070000000",
			"DoNotCall": "Y"

		}
			],
	"CellPhones": [
		{
			"PhoneNumber": "4020000001",
			"DoNotCall": "Y"

		},
		{
			"PhoneNumber": "2070000001",
			"DoNotCall": "Y"

		}
	],
	"CensusTract": "123456",
	"NumberOfUnits": "20-49",
	"HomeownerConfirmed": "Y",
	"LengthOfResidence": 10,
	"CrossStreet": "Mayne St",
	"CountyCode": "000",
	"MortgageDate": "1/1/2000",
	"PurchaseAmount":  "180K",
	"EstimateHomeValue": "200K",
	"BuildingSquareFootage": "3700",
	"AutoRenewalMonth": 6,
	"Autos": [
		{
			"VIN": "WFGR404H0614788",
			"Make": "BMW",
			"Model": "6 SERIES",
			"Year": "1987"
		},
		{
			"VIN": "1FAFP5FECA189070",
			"Make": "Ford",
			"Model": "Taurus",
			"Year": "2006"
		}
	],
	"HasBoat": "Y",
	"HasMotorcycle": "N",
	"HasRV”: "Y",
	"EmailAddress": "john.smith@gmail.com",
	"EmailAddresses":[
		"john.smith@gmail.com"
	],
	"AddressType": "",
	"Income": "F",
	"Language": "E",
	"BuildingSquareFeet": "3005",
	"SubdivisionName": "CHARLESTON HEIGHTS ADD",
	"YearBuilt": "2007",
	"Heating": "WA0",
	"Fuel": "",
	"HomeHeatIndicator": "",
	"Acres": ".1800",
	"LandSquareFootage": "7841",
	"Utilities": "",
	"HeadHousehold": ""	
}
Household Count Within Polygon
Get a count of households within a polygon

Total household count within a given polygon is returned.

Request
[{
	"Latitude": 41.28729282521632,
	"Longitude": -95.99274158477783
}, {
	"Latitude": 41.286486644238195,
	"Longitude": -95.99681854248047
}, {
	"Latitude": 41.284906500626846,
	"Longitude": -95.999436378479
}]
Response
633
Household Data Within Polygon
Get household data within a polygon
Household data within a given polygon is returned.
Request
[  
   {  
      "Latitude":41.2814210804748,
      "Longitude":-95.99265575408936
   },
   {  
      "Latitude":41.27955055705004,
      "Longitude":-95.99267721176147
   },
   {  
      "Latitude":41.27956668248107,
      "Longitude":-95.99023103713989
   }
]
Response
[
    {
        "FirstName": "JIM",
        "LastName": "SMITH",
        "Gender": "Male",
        "Address": "1234 N 50TH AVE",
        "City": "OMAHA",
        "State": "NE",
        "ZipCode": "68106",
        "PhoneNumber": "",
        "MobileNumber": "",
        "HomeownerConfirmed": "",
        "HomeValue": "$175,000 - $199,999",
        "LengthOfResidence": 3,
        "EmailAddress": "SMITH@EMAIL.COM",
        "Latitude": 41.279715,
        "Longitude": -95.991431,
        "DNC": false,
        "Cell_DNC": false,
        "Vehicles": []
    },
    {
        "FirstName": "STEVE",
        "LastName": "JONES",
        "Gender": "Unknown",
        "Address": "4567 N 50TH AVE",
        "City": "OMAHA",
        "State": "NE",
        "ZipCode": "68104",
        "PhoneNumber": "",
        "MobileNumber": "4025551212",
        "HomeownerConfirmed": "",
        "HomeValue": "",
        "LengthOfResidence": null,
        "EmailAddress": "JONES@EMAIL.COM",
        "Latitude": 41.279802,
        "Longitude": -95.991431,
        "DNC": false,
        "Cell_DNC": false,
        "Vehicles": []
    },
    {
        "FirstName": "GREGORY",
        "LastName": "SMITHE",
        "Gender": "Male",
        "Address": "4567 N 50TH AVE",
        "City": "OMAHA",
        "State": "NE",
        "ZipCode": "68106",
        "PhoneNumber": "",
        "MobileNumber": "",
        "HomeownerConfirmed": "",
        "HomeValue": "",
        "LengthOfResidence": null,
        "EmailAddress": null,
        "Latitude": 41.279802,
        "Longitude": -95.991431,
        "DNC": false,
        "Cell_DNC": false,
        "Vehicles": [
           {
              "TransDate": "2016-09-19T00:00:00",
              "Year": "2010",
              "Make": "FORD",
              "Model": "FUSION",
              "VIN": "6FAHP0HA5AR243021"
           },
           {
              "TransDate": "2015-01-22T00:00:00",
              "Year": "2004",
              "Make": "FORD",
              "Model": "F-150",
              "VIN": "1DTPX92551NA21672"
           }
        ]
    }
]
Get Contact
Augment Data Based on Phone or Email

Submit phone number or email address and receive augmented address, phone, email, household name data, property data, and vehicle data when available.

Request
{
	"Phone":"4025550199",
   	"EmailAddress":"",
   	"FirstName":"",
   	"LastName":"",
   	"City":"",
   	"State":"",
   	"Zip":""
}
Response
{
	"FirstName": "John",
	"MiddleInitial": "A",
	"LastName": "Smith",
	"Gender": "M",
	"EstimatedAge": "1/1/2001",
	"HouseHoldMembers": [
		{
			"FirstName”: "SUZIE",
			"MiddleInitial": "Q",
			"Gender": "F",
			"EstimatedAge": “1/1/2000”
		},
		{
			"FirstName": "Larry"
			"MiddleInitial": "E",
			"Gender": "M"
			"EstimatedAge": "2/2/2002"
		}
	],
	"HouseNumber": "100",
	"StreetDirection": "NE",
	"StreetName": "Main St",
	"ApartmentNumber": "1B",
	"ApartmentBuildingType": "Suite",
	"City": "Anytown",
	"State": "NE",
	"ZipCode": "68000",
	"ZipCode4": "1111",
	"PhoneNumbers": [
 		{
			"PhoneNumber": "4020000000",
			"DoNotCall": "Y"
		},
		{
			"PhoneNumber": "2070000000",
			"DoNotCall": "Y"

		}
			],
	"CellPhones": [
		{
			"PhoneNumber": "4020000001",
			"DoNotCall": "Y"

		},
		{
			"PhoneNumber": "2070000001",
			"DoNotCall": "Y"

		}
	],
	"CensusTract": "123456",
	"NumberOfUnits": "20-49",
	"HomeownerConfirmed": "Y",
	"LengthOfResidence": 10,
	"CrossStreet": "Mayne St",
	"CountyCode": "000",
	"MortgageDate": "1/1/2000",
	"PurchaseAmount":  "180K",
	"EstimateHomeValue": "200K",
	"BuildingSquareFootage": "3700",
	"AutoRenewalMonth": 6,
	"Autos": [
		{
			"VIN": "WFGR404H0614788",
			"Make": "BMW",
			"Model": "6 SERIES",
			"Year": "1987"
		},
		{
			"VIN": "1FAFP5FECA189070",
			"Make": "Ford",
			"Model": "Taurus",
			"Year": "2006"
		}
	],
	"HasBoat": "Y",
	"HasMotorcycle": "N",
	"HasRV”: "Y",
	"EmailAddress": "john.smith@gmail.com",
	"EmailAddresses":[
		"john.smith@gmail.com"
	],
	"AddressType": "",
	"Income": "F",
	"Language": "E",
	"BuildingSquareFeet": "3005",
	"SubdivisionName": "CHARLESTON HEIGHTS ADD",
	"YearBuilt": "2007",
	"Heating": "WA0",
	"Fuel": "",
	"HomeHeatIndicator": "",
	"Acres": ".1800",
	"LandSquareFootage": "7841",
	"Utilities": "",
	"HeadHousehold": ""	
}
Get Neighbors
Get nearest neighbors from specified coordinates
All households from a specified radius of specified coordinates will be returned.
Request
{
	"Latitude": 41.28729282521632,
	"Longitude": -95.99274158477783,
	"MaxCount": 10,
	"MaxDistance": 0.5
}
Response
[
    {
        "FirstName": "JOHN",
        "MiddleInitial": null,
        "LastName": "DOE",
        "NameSuffix": null,
        "DateOfBirth": null,
        "Gender": "Male",
        "HouseNumber": "1234",
        "StreetDirection": null,
        "StreetName": "MAIN ST",
        "ApartmentNum": null,
        "AddressType": null,
        "City": "OMAHA",
        "State": "NE",
        "ZipCode": "68104",
        "ZipCode4": "1234",
        "PhoneNumber": "",
        "MobileNumber": "",
        "HomeownerConfirmed": "",
        "HomeValue": "",
        "LengthOfResidence": null,
        "EmailAddress": null,
        "DNC": false,
        "Cell_DNC": false
    },
    {
        "FirstName": "JIM",
        "MiddleInitial": null,
        "LastName": "SMITH",
        "NameSuffix": null,
        "DateOfBirth": null,
        "Gender": "Male",
        "HouseNumber": "1235",
        "StreetDirection": null,
        "StreetName": "MAIN ST",
        "ApartmentNum": null,
        "AddressType": null,
        "City": "OMAHA",
        "State": "NE",
        "ZipCode": "68104",
        "ZipCode4": "1235",
        "PhoneNumber": "4025551212",
        "MobileNumber": "",
        "HomeownerConfirmed": "",
        "HomeValue": "",
        "LengthOfResidence": null,
        "EmailAddress": null,
        "DNC": true,
        "Cell_DNC": false
    },
    {
        "FirstName": "SUSAN",
        "MiddleInitial": null,
        "LastName": "SMITH",
        "NameSuffix": null,
        "DateOfBirth": null,
        "Gender": "Female",
        "HouseNumber": "4567",
        "StreetDirection": null,
        "StreetName": "BIRCH ST",
        "ApartmentNum": null,
        "AddressType": null,
        "City": "OMAHA",
        "State": "NE",
        "ZipCode": "68104",
        "ZipCode4": "6789",
        "PhoneNumber": "",
        "MobileNumber": "4025550199",
        "HomeownerConfirmed": "",
        "HomeValue": "",
        "LengthOfResidence": null,
        "EmailAddress": "SSMITH@EMAIL.NET",
        "DNC": false,
        "Cell_DNC": true,
        "Vehicles": [
           {
              "TransDate": "2016-09-19T00:00:00",
              "Year": "2010",
              "Make": "FORD",
              "Model": "FUSION",
              "VIN": "6FAHP0HA5AR243021"
           },
           {
              "TransDate": "2015-01-22T00:00:00",
              "Year": "2004",
              "Make": "FORD",
              "Model": "F-150",
              "VIN": "1DTPX92551NA21672"
           }
        ]
    }
]

FETCH FILE APP

If you are not looking for a full API integration into your systems or have hundreds of thousands of records that you want to enrich. We offer a file batch process where you simply drop a formatted file to us and we will run it and post it back to you.

Learn More