Skip to main content
curl --request GET \
  --url "https://api.trestleiq.com/3.0/location_intel?street_line_1=800%20Bellevue%20Way%20NE&city=Bellevue&state_code=WA&postal_code=98004" \
  --header "x-api-key: YOUR_API_KEY"

{
  "id": "Location.6a3b1c11-76fd-4b25-86bc-5cfb588b4f6b",
  "is_valid": true,
  "street_line_1": "800 Bellevue Way NE",
  "street_line_2": null,
  "city": "Bellevue",
  "postal_code": "98004",
  "zip4": "4286",
  "state_code": "WA",
  "country_code": "US",
  "lat_long": {
    "latitude": 47.6175,
    "longitude": -122.2017,
    "accuracy": "RoofTop"
  },
  "error": null,
  "warnings": []
}

curl --request GET \
  --url "https://api.trestleiq.com/3.0/location_intel?street_line_1=800%20Bellevue%20Way%20NE&city=Bellevue&state_code=WA&postal_code=98004" \
  --header "x-api-key: YOUR_API_KEY"

{
  "id": "Location.6a3b1c11-76fd-4b25-86bc-5cfb588b4f6b",
  "is_valid": true,
  "street_line_1": "800 Bellevue Way NE",
  "street_line_2": null,
  "city": "Bellevue",
  "postal_code": "98004",
  "zip4": "4286",
  "state_code": "WA",
  "country_code": "US",
  "lat_long": {
    "latitude": 47.6175,
    "longitude": -122.2017,
    "accuracy": "RoofTop"
  },
  "error": null,
  "warnings": []
}

​
Address Validation API 3.0

GET https://api.trestleiq.com/3.0/location_intel?street_line_1=[insert_street_line_1]&city=[insert_city]&state_code=[insert_state_code]&postal_code=[insert_postal_code]
Note: This API supports US addresses only. Requests for non-US addresses will return a warning and no address data.

​
Query Parameters

​
street_line_1
string
required
The first line of the street part in the structured address. Example: street_line_1=800 Bellevue Way NE
​
street_line_2
string
The second line of the street part in the structured address (e.g. apartment or suite number). Example: street_line_2=Ste 100
​
city
string
The name of the city in the structured address. Example: city=Bellevue
​
state_code
string
The state code of the structured address. Example: state_code=WA
​
postal_code
string
The postal code of the structured address. Example: postal_code=98004

​
Headers

​
x-api-key
string
required
Your API key for authentication. Example: {{ apiKey }}

​
Response

​
id
string or null <Location.<uuid>>
The persistent ID of the validated address. Format: Location.<uuid>. Only present when the address is valid.
​
is_valid
boolean or null
True if the address is valid.
​
street_line_1
string or null
The first line of the street part in the structured address, normalized by USPS CASS standards.
​
street_line_2
string or null
The second line of the street part in the structured address. Returns null for this API — unit information is incorporated into street_line_1 during normalization.
​
city
string or null
The name of the city in the structured address.
​
postal_code
string or null
The 5-digit postal code of the structured address.
​
zip4
string or null
The 4-digit ZIP+4 extension of the structured address (USA).
​
state_code
string or null
The state code of the structured address.
​
country_code
string or null (ISO-3166-2)
The ISO-3166 alpha-2 country code of the address. Always US for valid responses from this API.
​
lat_long
object or null
The coordinates of the geographical location of the address. Only present when CASS returns coordinate data.
​
error
string or null
An error message string if a partial error occurred during processing, otherwise null.
​
warnings
string[]
Warnings returned as part of the response, if applicable.Enum: Missing Input Invalid address Invalid house/building number Missing unit/apt/suite number Invalid unit/apt/suite number Non-US country address validation is not supported. Address validation could not be completed at this time. Please try again later

​
Error Responses

​
400 Bad Request

The server cannot process the request due to client-side errors.Check for: Syntax errors in the request script, malformed JSON, or invalid parameters.

​
403 Forbidden

The request is understood, but the server is refusing to fulfill it.
  • Invalid API Key: The key is incorrect or deactivated. Check for: Trailing spaces, syntax errors, or incorrect character counts.
  • API Key Missing: The request header did not include an API key.
  • API Key Disabled (Portal Issue): The key is inactive. Check for: Insufficient funds in your self-serve wallet or if a Trestle Admin manually deactivated your API key.
  • API Key does not have Product Access (Portal Issue): The API key is active, but it is not enabled for this product or API version. Check for: Incorrect endpoint, incorrect API version, or missing product access on the key.
  • API Key Expired: The key has reached its end-of-life (primarily affects Trial users).

​
429 Too Many Requests

You have sent too many requests in a given amount of time.
  • Rate Limit Exceeded: You have surpassed the queries-per-second (QPS) threshold for your tier.
  • Quota Exceeded (Portal Issue): You have reached the total volume allowed for your current billing cycle. Upgrade your plan in the portal to resume service.

​
500 Internal Server Error

An unexpected error occurred on the server side. Please contact support if this persists.