Skip to main content
GET
/
3.0
/
location
GET https://api.trestleiq.com/3.0/location?address.street_line_1={street}&address.city={city}&address.state_code={state}&address.postal_code={postal_code}

{
  "id": "<string>",
  "is_valid": true,
  "street_line_1": "<string>",
  "city": "<string>",
  "postal_code": "<string>",
  "state_code": "<string>",
  "country_code": "<string>",
  "current_residents": [
    {}
  ],
  "associated_people": [
    {}
  ],
  "associated_phones": [
    {}
  ]
}

​
Overview

Reverse Address API validates and normalizes the input address and provides the current residents at the address with their information, including demographics, historical addresses, relatives and associated people and phone numbers.

​
Endpoint

GET https://api.trestleiq.com/3.0/location?address.street_line_1={street}&address.city={city}&address.state_code={state}&address.postal_code={postal_code}

​
Parameters

​
address.street_line_1
string
The first line of the street part in the structured address. Cannot be longer than 1000 characters. Example: 100 Main St
​
address.street_line_2
string
The second line of the street part in the structured address. Cannot be longer than 1000 characters. Example: Ste 1
​
address.city
string
The name of the city in the structured address. Cannot be longer than 500 characters. Example: Seattle
​
address.state_code
string
The state code of the structured address. Cannot be longer than 100 characters. Example: WA
​
address.postal_code
string
The postal code of the structured address. Cannot be longer than 100 characters. Example: 98101
​
address.country_code
string
The ISO-3166 alpha-2 country code of the address. Cannot be longer than 100 characters. Example: US

​
Headers

​
x-api-key
string
required
Your API key for authentication.

​
Code Examples

curl --request GET \
  --url "https://api.trestleiq.com/3.0/location?address.street_line_1=100%20Main%20St&address.city=Seattle&address.state_code=WA&address.postal_code=98101" \
  --header "x-api-key: YOUR_API_KEY"
Postman payload 
{
  "method": "GET",
  "url": "https://api.trestleiq.com/3.0/location",
  "query": {
    "address.street_line_1": "100 Main St",
    "address.city": "Seattle",
    "address.state_code": "WA",
    "address.postal_code": "98101"
  },
  "headers": { "x-api-key": "YOUR_API_KEY" }
}

​
Response

​
id
string
The persistent ID of the address. Format: Location.<uuid>
​
is_valid
boolean
True if the address is valid.
​
street_line_1
string
The first line of the street part in the structured address.
​
city
string
The name of the city in the structured address.
​
postal_code
string
The postal code of the structured address.
​
state_code
string
The state code of the structured address.
​
country_code
string
The ISO-3166 alpha-2 country code of the address.
​
current_residents
array
A list of current residents at the address with their information.
​
associated_people
array
People associated with the address.
​
associated_phones
array
Phone numbers associated with the address.