The Address Autocomplete API provides intelligent address suggestions for U.S. addresses based on partial input submitted in the searchText query parameter. It returns a structured list of up to 15 suggested addresses, including unit-level details (e.g., apartments or suites) and geographic coordinates when available.
Use Address Validate API to validate the address.
Key Capabilities:
searchText
Note: This API only suggests addresses matches. It does not validate them. To verify address accuracy, use the Address Validation API.
A list of address suggestions has been retrived.
Invalid request.
The request could not be authorized.
The request could not be completed due to an internal error.
{- "location": [
- {
- "totalUnitCount": 3,
- "address": {
- "formattedAddress": "27 Water St, Hallowell, ME 04347",
- "suggestedFormattedAddress": "ME 04347, 27 Water St, Hallowell",
- "mainAddressLine": "27 Water St",
- "addressLastLine": "Hallowell, ME 04347",
- "areaName1": "ME",
- "areaName3": "Hallowell",
- "postCode": "04347",
- "country": "US",
- "addressNumber": "27",
- "streetName": "Water St"
}, - "geometry": {
- "type": "Point",
- "coordinates": [
- 44.29344,
- -69.786861
]
}, - "ranges": [
- {
- "units": [
- {
- "unitInfo": "Apt 1",
- "formattedUnitAddress": "27 Water St, Apt 1, Hallowell, ME 04347",
- "suggestedAddress": {
- "addressLine1": null,
- "addressLine2": null,
- "city": null,
- "state": null,
- "postalCode": null,
- "suggestedFormattedAddress": null
}
}
]
}
]
}
]
}