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.

Autocomplete

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.

Typedown

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.

Validate

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.

Singleline

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.

Singleline

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.

Typedown

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.

Lookup v1

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.

Lookup v2

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.

Lookup v2

Our Lookup v2 search type is designed to retrieve up to 1000 full addresses that reside within the provided city or postal code.

Autocomplete

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.

Validate

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.

Singleline

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.

Typedown

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.

Lookup

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.

Other things to consider

Search type Partial addresses supported Address Enrichment* Customizable address formats Trans- literation Fuzzy matching Location biasing Realtime Utility data
Autocomplete Yes Yes Yes No Yes Yes Yes
Validate No Yes Yes Yes Yes No No
Singleline Yes Yes Yes Yes Yes No Yes
Typedown Yes Yes Yes No No No Yes
Lookup v1 No Yes Yes No No No No
Lookup v2 Yes Yes Yes No No No Yes

* Address Enrichment can be retrieved by using the Add-Enrichment header or the relevant layout in the /format endpoint.