Address Bounding Box API (NZ)

Build
Send
Response
Errors

This API call returns addresses within a defined geographic area or postcode. Because of the potential large result set, the data returned is kept to a minimum. You should supplement this query with the Address Metadata API to populate your full result set.

Build the request URL

Use the form below to build your request URL from the available parameters. The URL string will be generated and can be sent to the API in order to provide insight into how the API works and the response it returns. Or, if you are using Postman for your investigation, development and testing, include the desired parameters and copy and paste the request URL below into Postman's GET request URL field.

Field Name	Value	Type	Description
key *		String	Your unique licence key (find on Portal credentials)
secret *		String	Your unique secret key (find on Portal credentials). Alternatively, you can pass your secret key into the Authorization header of the request as such: `Authorization: your-secret`
format *		String	The format of the response.
	Options json `json` for a response in json format. xml `xml` for a response in xml format.
points *		String	A series of comma-separated GPS coordinates (in WGS84 format) of a bounding polygon. Format example: `long1, lat1, long2, lat2, long3, lat3`
	Options Devonport, Auckland Chatham Islands Karori, Wellington Wilton, Wellington 184 Willis St, Wellington
postcode		String	Restrict results returned to those that match the supplied postcode.
domain		String	Used to identify which of your services is calling the API for activity monitoring purposes. This domain needs to be registered in the portal. FAQ: learn more about the domain parameter
max		Integer	The maximum number of results to return. A number between 1 and 20,000. The default is 10 results.

* Parameters marked with an asterisk are mandatory for this API call.

Request URL

https://api.addressfinder.io/api/nz/address/bounding_box/

      
        /* Click the button above to see a real API response here */
        {
          "success": true
        }

Response Specification

The API response will contain a hash with an element named completions, which is an array of hashes containing the following fields.

Field Name	Type	Description	Example
`pxid`	String	The unique address identifier.	2-.3.1q.2.4G.4c
`x`	String	Longitude coordinate (in WGS84 format).	174.643199
`y`	String	Latitude coordinate (in WGS84 format).	-36.426956
`success`	Boolean	Indicates if the request was successful or not.	true

Errors

Below are the possible errors that can be returned by the API.