Trestle’s Phone Lookup APIs (Reverse Phone API and Caller Identification API) return different address types for current and historical addresses. This is flagged with the location_type attribute in the current_addresses or historical_addresses array objects.
The potential values include:
- Address: This means the specific address provided for the subscriber (current or historical) is the full address including house/apartment number, zip4, postal, city, state and country. This is our most precise response.
- Zip+4: This means the specific address provided for the subscriber (current or historical) is only at the Zip+4 level without the street or the house number.
- Postal Code: This means the specific address provided for the subscriber (current or historical) is only at the postal code level without the street or the house number. Street Line 1, Street Line 2, and Zip+4 fields would return null in this case.
- City: This means the specific address provided for the subscriber (current or historical) is only the postal code level. Street Line 1, Street Line 2, Postal Code, and Zip+4 fields would return null in this case.
- State: This means the specific address provided for the subscriber (current or historical) is only at the state level. Street Line 1, Street Line 2, Zip4, Postal Code, Zip+4, and City fields would return null in this case.
- Country: This means the specific address provided for the subscriber (current or historical) is only at the country level.
Please note that if the location type is address, then the data is associated with the subscriber. For other location types, though, the location can be derived from the NPA NXX, which might have changed as the number is ported or the subscriber has moved.
Hence, it is important that businesses consider the location types to make appropriate decisions on how to use the address data provided. For example, if the business is looking for the full address of the subscriber or has to make call routing or other decisions based on the subscriber’s address, filtering out any addresses where location_type != “Address” is recommended.
If you have any questions, feel free to contact us at support@trestleiq.com.