Find Person API

Find Person API provides detailed individual information like demographics, current and historical addresses, email addresses, and phone numbers.

Find Person 3.1

URL Structure: https://api.trestleiq.com/3.1/person?name=[insert_name]&address.city=[insert_city]&address.state_code=[insert_state_code]

Request

query Parameters

name	string The name of the person to search. Example: name=Jon Snow
address.street_line_1	string The first line of the street part in the structured address. (Cannot be longer than 1000 characters.) Example: address.street_line_1=100 Syrws St
address.street_line_2	string The second line of the street part in the structured address. (Cannot be longer than 1000 characters.) Example: address.street_line_2=Ste 1
address.city	string The name of the city in the structured address. (Cannot be longer than 500 characters.) Example: address.city=Lynden
address.postal_code	string The postal code of the structured address. (Cannot be longer than 100 characters.) Example: address.postal_code=98264
address.state_code	string The state code of the structured address. (Cannot be longer than 100 characters.) Example: address.state_code=WA
address.country_code	string <ISO-3166-2> The ISO-3166 alpha-2 country code of the address. See: ISO-3166. (Cannot be longer than 100 characters.) Example: address.country_code=US

header Parameters

x-api-key

required

string

The API Key.

Example: {{apiKey}}

Responses

200

Successful find person response.

Response Schema: application/json

count_person	integer The number of people returned.
	Array of objects (Person) An array of people associate with the address provided.
	object (PartialError)
warnings	Array of strings Warnings returned as part of the response, if applicable. The possible values include - `Missing Input`, `Invalid Input Address`, `Invalid house/building number`, `Missing unit/apt/suite number`, or `Invalid unit/apt/suite number`.

400

Bad Request: Indicates that the server cannot process the request due to client-side errors.

403

Invalid API Key: Indicates that the API key is either incorrect or has been deactivated.
API Key Missing: Indicates that your request did not include an API key.
API Key Expired: Indicates that the API key has expired.

429

Too Many Requests: API Key has exceeded its rate limit.

500

Internal Server Error: Indicates that the server encountered an unexpected error.
Validation From Address Service Failed: Indicates an internal error while validating the address.

get/3.1/person

Request samples

curl --location --request GET 'https://api.trestleiq.com/3.1/person?address.city=Lynden&address.country_code=US&address.postal_code=98264&address.state_code=WA&address.street_line_1=100+Syrws+St&name=Waidong+L+Syrws'   
 --header 'x-api-key: [insert_api_key]'  
  --header 'Accept: application/json'

Response samples

application/json

{"count_person": 1,
"person": [{"id": "Person.3dbb6fef-a2df-4b08-cfe3-bc7128b6f5b4",
"name": "Waidong L Syrws",
"firstname": "Waidong",
"middlename": "L",
"lastname": "Syrws",
"alternate_names": ["Sryws W L"
],
"age_range": "25-29",
"gender": null,
"found_at_address": {"id": "Location.d1a40ed5-a70a-46f8-80a9-bb4ac27e3a01",
"location_type": "Address",
"street_line_1": "100 Syrws St",
"street_line_2": "Ste 1",
"city": "Lynden",
"postal_code": "98264",
"zip4": "98264-9999",
"state_code": "WA",
"country_code": "US",
"lat_long": {"latitude": 0,
"longitude": 0,
"accuracy": "Neighborhood"
},
"is_active": true,
"delivery_point": "SingleUnit",
"link_to_person_start_date": "2011-10-05"
},
"current_addresses": [{"id": "Location.d1a40ed5-a70a-46f8-80a9-bb4ac27e3a01",
"location_type": "Address",
"street_line_1": "100 Syrws St",
"street_line_2": "Ste 1",
"city": "Lynden",
"postal_code": "98264",
"zip4": "98264-9999",
"state_code": "WA",
"country_code": "US",
"lat_long": {"latitude": 0,
"longitude": 0,
"accuracy": "Neighborhood"
},
"is_active": true,
"delivery_point": "SingleUnit",
"link_to_person_start_date": "2011-10-05"
}
],
"historical_addresses": [{"id": "Location.d1a40ed5-a70a-46f8-80a9-bb4ac27e3a01",
"location_type": "Address",
"street_line_1": "10 Main St",
"street_line_2": "Ste 1",
"city": "Lynden",
"postal_code": "98264",
"zip4": "98264-9999",
"state_code": "WA",
"country_code": "US",
"lat_long": {"latitude": 0,
"longitude": 0,
"accuracy": "Neighborhood"
},
"is_active": true,
"delivery_point": "SingleUnit",
"link_to_person_start_date": "2011-10-05",
"link_to_person_end_date": null
}
],
"phones": [{"id": "Phone.3dbb6fef-a2df-4b08-cfe3-bc7128b6f5b4",
"phone_number": "2069735100",
"line_type": "NonFixedVOIP"
}
],
"emails": "waidong.syrws@email.com",
"associated_people": [{"id": "Person.fffdcf06-0929-4b5a-9921-ee49b101ca84",
"name": "Waidong L Syrws",
"firstname": "Waidong",
"middlename": "L",
"lastname": "Syrws",
"relation": "Household"
}
]
}
],
"error": {"name": "InternalError",
"message": "Could not retrieve entire response"
},
"warnings": "Missing Input"
}

➔ Next to Real Contact API