Everything Location - /address/complete (AutoComplete)

Generate a list of address suggestions based on the supplied query. Use with the /address/capture endpoint to select and return the full address object.

Note: only old everythinglocation keys will work with this service.

Resource URL


Note: we don't support API connections using HTTP - all calls should use HTTPS.

Resource Information

Preferred method POST, GET
Response formats JSON, XML, HTML
Requires authentication? Yes, valid API key
Chargeable? No

Back to top

Request Parameters

Name Descrition
A valid API key.

Example: BFtd2UpC8Gl1jU1pPnDZIVpoz2XnBMyWEfVcAfoI
A freeform partial address query.

Example: "999 bak" or "bs328ga
A recognizable country name or ISO code.

Example: "USA", "DE" or "New Zealand"
The object containing address filters. Available filters are: "PostalBox", "SubBuilding", "Premise", "Thoroughfare", "Locality", "AdministrativeArea", and "PostalCode". Filters will only function on the following countries: USA, CAN, GBR, and AUS.

Example object with all possible filters is enclosed in "Example Request" below.

Back to top

Response Parameters

Name Descrition
Status The result of your call. "OK" indicates success, any other status indicates an error.

Example: "Status":"OK"
output[] The array containing the suggestions for the given input. The number of results returned is variable. For searches on United States, United Kingdom, Australia and Canada data, the result list length is determined by the ratio of complete and component-matched addresses that the search process compiles. For searches on all other country data, the maximum results are always 10.

Sample JSON output[] is enclosed below.
metadata[] The array containing address metadata for address suggestions. The metadata can be used in the "filters" input object for filtering address components on subsequent requests. If TotalRecordCount = 1, then the metadata object will not return any address fields.

Sample JSON output[] is enclosed below.

Back to top

Example Request

POST https://api.everythinglocation.com/address/complete
Accept: application/json
Content-Type: application/json
   "filters": {
      "Locality": "San Francisco",
      "AdministrativeArea": "CA"

Back to top

Example Response

200 OK
Content-Type:  application/json; charset=utf8
Date:  Thu, 15 Oct 2015 18:28:11 GMT
Server:  Apache
X-Powered-By:  PHP/5.4.16
Content-Length:  367
Connection:  keep-alive
      "San Francisco CA 94102",
      "941 Buchanan St, San Francisco CA 94102",
      "941 22nd St, San Francisco CA 94107",
      "941 7th St, San Francisco CA 94107",
      "941 Michigan St, San Francisco CA 94107",
      "941 Pine St, San Francisco CA 94108",
      "941 Esmeralda Ave, San Francisco CA 94110",
      "941 Treat Ave, San Francisco CA 94110",
      "941 Buena Vista Ave W, San Francisco CA 94117",
      "941 Cesar Chavez, San Francisco CA 94124"
         "Locality":"San Francisco",

Back to top

Get started for free today

  • No credit card required
  • Cancel any time
  • 24/7 support
Get started