There are different ways you can implement this API, depending on how you want to capture your addresses. Select the best option below, and we'll point you in the right direction.
Our Autocomplete search type is designed to provide accurate suggestions in real-time, that continually update as the user types. The user should provide the address elements in the order that they would appear on an envelope.
Our Typedown search type is designed to allow the user to enter the most general address elements first and, once that has been found, move on to more specific parts of the address. The suggestion list is updated a short period after the user stops typing (this period is currently 300 milliseconds). The user can drill down through a series of results to select the required address. Suggestions can be refined as the user types.
Our Validate search type is designed to verify complete addresses. The user supplies a complete address, as it would appear on an envelope, in single or multiple address fields and our solution returns a fully formatted address and a level of confidence.
Our Singleline search type is designed to find an exact or close matching address based on two or three key address elements, entered by the user in the order as they would appear on an envelope. The suggestions can refined with additional input from the user before they select an address from the list.
Our Singleline search type is designed to find an exact or close matching address based on two or three key address elements, entered by the user in the order as they would appear on an envelope. The suggestions can refined with additional input from the user before they select an address from the list.
Our Typedown search type is designed to allow the user to enter the most general address elements first and, once that has been found, move on to more specific parts of the address. The suggestion list is updated a short period after the user stops typing (this period is currently 300 milliseconds). The user can drill down through a series of results to select the required address. Suggestions can be refined as the user types.
Our Lookup v1 search type is designed to use a search key to find the corresponding address. For example, the user enters a gas or electricity meter number, a Unique Property Reference Number (UPRN) or a Unique Delivery Point Reference Number (UDPRN) and our service will respond with the corresponding addresses.
Our Lookup v2 search type designed to retrieve all available combinations of locality information like region, state, province, city and/or postal code for a given city or postal code.
Our Lookup v2 search type is designed to retrieve up to 1000 full addresses that reside within the provided city or postal code.
Our Autocomplete search type is designed to provide accurate suggestions in real-time, that continually update as the user types. The user should provide the address elements in the order that they would appear on an envelope.
Our Validate search type is designed to verify complete addresses. The user supplies a complete address, as it would appear on an envelope, in single or multiple address fields and our solution returns a fully formatted address and a level of confidence.
Our Singleline search type is designed to find an exact or close matching address based on two or three key address elements, entered by the user in the order as they would appear on an envelope. The suggestions can refined with additional input from the user before they select an address from the list.
Our Typedown search type is designed to allow the user to enter the most general address elements first and, once that has been found, move on to more specific parts of the address. The suggestion list is updated a short period after the user stops typing (this period is currently 300 milliseconds). The user can drill down through a series of results to select the required address. Suggestions can be refined as the user types.
Our Lookup search type is designed to use a search key to find the corresponding locality information as well as full addresses.
The user can retrieve all available combinations of locality information like region, state, province, city and/or postal code for a given city or postal code. Additionally, up to 1000 full addresses can be returned that reside within the provided city or postal code.
Other search keys for the UK market include utility meter numbers, Unique Property Reference Numbers (UPRN) or Unique Delivery Point Reference Numbers (UDPRN).
Still unsure? Please contact us to discuss your requirements and see how we can help.
| Search type | Partial addresses supported | Address Enrichment* | Customizable address formats | Trans- literation | Fuzzy matching | Location biasing | Realtime Utility data |
|---|---|---|---|---|---|---|---|
| Autocomplete |  |
|
 |
|
|
|
|
| Validate | |
|
|
|
|
|
|
| Singleline | |
|
|
|
|
|
|
| Typedown | |
|
|
|
|
|
|
| Lookup v1 | |
|
|
|
|
|
|
| Lookup v2 | |
|
|
|
|
|
|
* For Autocomplete, use the enrichment endpoint to gain additional enrichment data. For all other search types use the relevant layout in the /format endpoint.
