Skip to main content


July 2021#

  • /addresses and /autocomplete/addresses now accepts query arguments to bias results by a geospatial area defined by an origin (WGS84 coordinate) and radius (in metres) with bias_lonlat=[longitude],[latitude],[radius]
  • /addresses and /autocomplete/addresses now accepts query arguments to filter results by a geospatial box defined by an "top-left" and "bottom-right" WGS84 coordinates. Filter addresses with box=[top left longitude],[top left latitude],[bottom right longitude],[bottom right latitude]

June 2021#

  • /addresses and /autocomplete/addresses now accepts query arguments to bias results by locality or postcode elements like post_town or postcode_sector with bias_post_town= and bias_postcode_sector=

May 2021#

  • /postcodes/:postcode now returns up to 5 suggested postcodes if there is no exact postcode match. It will check for common errors first (i.e. mixing up 0 and O or 1 and I).

April 2021#

  • /postcodes/:postcode now returns total, limit and page attributes for all responses (not just Multiple Residence)

March 2021#

  • /keys/:key API now accepts sublicensee keys that begin sl_

February 2021#

January 2021#

  • Usage log exports now reports the Origin header in the URL column if the Referer is not available.

December 2020#

  • Checking key details with the /keys/:key will now return a datasets attribute. This identifies which datasets (i.e. PAF, Multiple Residence, Not Yet Built) this key has access to.

November 2020#

  • Licensee keys may now be passed in via the API Key argument of the querystring (api_key=) or authorisation header IDEALPOSTCODES api_key="". Our documentation will be updated to reflect this as the primary method of identifying a licensee. However the earlier method of supplying both licensee and api_key will continue to be supported.

October 2020#

  • /addresses no accepts no terms query. This means addresses can be searched using just filters like postcode
  • New filters available for /addresses including postcode_area, postcode_sector, uprn and more
  • Search /addresses with UPRNs using the uprn= filter

September 2020#

  • Address responses now return a uprn attribute for GB addresses
  • GB address geolocations are now rooftop accurate if they have a uprn assigned