Changelog
Stay informed about the latest updates and improvements to our address validation services with our changelog. View release notes and see what's new.
July 2025
- [API] CSV usage log export now includes a
lookups
column showing how many lookups each request consumed. See the CSV usage log API for details.
June 2025
- [Data] Improved Republic of Ireland coverage for the standard dataset. All addresses now include Eircode (Irish postal codes)
- [Documentation] Documentation site now generates an LLM.txt file and
.md
files to better support language model integration - [API] Improved handling of ordinals and directionals for US addresses
May 2025
- [Data] Improved and extended UPRN matching for Royal Mail Multiple Residence and Not Yet Built addresses
- [Data] Additional HERE datasets included
- [Data] Localised and improved South Korea coverage with MOIS dataset
April 2025
- [Data] Localised and improved Belgium coverage with FODBOSA
- [Data] Localised and improved Japan coverage
March 2025
- [API] Maximum allowed configurations increased to 64. Maximum payload size for each configuration object increased to 64kb
February 2025
- [Data] Expanded Canada coverage with Canada National Address Register dataset
January 2025
- [Data] Expanded Denmark coverage with SDFI dataset
May 2024
- [API] Released
/addresses/verify
API for USA CASS Verification
April 2024
- [Data] Netherlands (Kadaster) address dataset incorporated
- [Data] Norway (Kartverket) address dataset incorporated
- [Performance] Improved P95 and P99 latency
March 2024
- [Data] AddressBase searches can now be filtered by property classification type (e.g. Commercial, Residential, Military, etc). See AddressBase data documentation for more information.
February 2024
- [Data] Search improvements for Iberian languages: Spanish, Catalan, Galician and Basque
- [Address Finder] Country selection is synced if
country:
is defined inoutputFields
January 2024
- [Data] Australia GNAF address dataset added
- [API] CASS Certified USA address verification generally available
November 2023
- [Data] Improvements to geospatial biasing for USA addresses
October 2023
- [API] Key settings can be updated via
POST /keys/:key
API - [API] Available datasets accessible through
GET /keys/:key/details
API - [Address Finder] Added the ability to
fix
Address Finder
September 2023
- [Address Finder] Added new callback for changes in country or context
- [Address Finder] Country is automatically detected by IP address
August 2023
- [Data] Hong Kong dataset included
- [Data] Macau dataset included
- [Data] Taiwan dataset included
- [Data] India dataset included
July 2023
- [Data] Asia Pacific data now available
- [Data] Oceania dataset included
June 2023
- [Data] South America data now available
- [Data] Middle East & Africa dataset included
May 2023
- [Data] Eastern Europe data now available
April 2023
- [Data] Western Europe data now available for Address Finder
March 2023
- [Data] Improved Zip and ZIP+4 searching on USA datasets
- [Data] Improved apartment searches for GBR datasets
February 2023
- [Data] AddressBase Core data now available for GBR address search
January 2023
- [API]
/postcodes/:postcode
API now returns Eircode addresses if enabled on your account - [Data] Rooftop geolocations now available for Northern Ireland. Please contact us to have this enabled on your account
- [Data] UPRNs now available for Northern Ireland. Please contact us to have this enabled on your account
- [API]
/addresses/cleanse
GBR Cleanse API now available
December 2022
- [API] Phone Validation API now generally available
- [Data] UK post towns are now titlecased (instead of all caps)
- [API] Republic of Ireland addresses can be retrieved via the
/postcodes/:postcode
API if Eircode is enabled
November 2022
- [API] Email Validation API now available
- [Security] Wildcard subdomain allowed URLs available. Add
*.domain.com
to allow requests fromdomain.com
and all related subdomains - [Address Finder] Search improvements: Better search for numeric property numbers with preceding zeros. Improved search for address ranges
October 2022
- [Security] Allowed URLs now permit subdomain wildcards. E.g.
*.example.com
will matchexample.com
as well as all subdomains
August 2022
- [API] New Places API
- [API]
/places?query=
to query for place suggestions - [API] Allow for IP, geolocation and country filtering and biasing
- [API]
places/:id
to resolve details for a place given a suggestion
July 2022
- [API]
/autocomplete/addresses/:id/gbr
now returns the local format of an address if not located in GBR inside thenative
attribute - [API]
/autocomplete/addresses/:id/usa
now returns the local format of an address if not located in USA inside thenative
attribute
June 2022
- [Data] Irish Addresses (Eircode) now supported by the autocomplete API. Contact our support team to have this enabled on your account
- [API]
/addresses
API now provides reverse geocoding iflon=
andlat=
query arguments are supplied. Results are ordered by proximity to the supplied geospatial points
May 2022
- [Data] UK Alias addresses now generally available
- [API]
/keys/:key
API now returns a contexts which correlates with the user's locality
April 2022
- [Data] Welsh PAF addresses now generally available
March 2022
- [API] New
autocomplete/addresses/:id/usa
API which resolves address suggestions to the USA address format
February 2022
- [Data] Addressing data for USA available
- [API]
/autocomplete/addresses
now accepts acontext=
argument which allows additional countries to be searched. This currently defaults toGBR
but also acceptsUSA
- [API] New
autocomplete/addresses/:id/gbr
API which resolves address suggestions to the GBR address format (regardless of country)
January 2022
- [API] The standard GBR address objects now also return an
id
attribute - [API] The standard GBR address object now also returns a
dataset
attribute which identifies the provenance of a result (e.g.paf
means Postcode Address File,mr
means Multiple Residence andnyb
meansNot Yet Built
) - [API] The standard GBR address object now also returns a
country_iso
which returns the 3 letter ISO country code
December 2021
- [API]
/addresses
and/autocomplete/addresses
now accept query arguments to bias results by a geospatial area defined by an origin (WGS84 coordinate) and radius (in metres) withbias_lonlat=[longitude],[latitude],[radius]
- [API]
/addresses
and/autocomplete/addresses
now accept query arguments to filter results by a geospatial box defined by "top-left" and "bottom-right" WGS84 coordinates. Filter addresses withbox=[top left longitude],[top left latitude],[bottom right longitude],[bottom right latitude]
July 2021
- [API]
/addresses
and/autocomplete/addresses
now accept query arguments to bias results by a geospatial area defined by an origin (WGS84 coordinate) and radius (in metres) withbias_lonlat=[longitude],[latitude],[radius]
- [API]
/addresses
and/autocomplete/addresses
now accept query arguments to filter results by a geospatial box defined by "top-left" and "bottom-right" WGS84 coordinates. Filter addresses withbox=[top left longitude],[top left latitude],[bottom right longitude],[bottom right latitude]
June 2021
- [API]
/addresses
and/autocomplete/addresses
now accept query arguments to bias results by locality or postcode elements likepost_town
orpostcode_sector
withbias_post_town=
andbias_postcode_sector=
May 2021
- [API]
/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 up0
andO
or1
andI
)
April 2021
- [API]
/postcodes/:postcode
now returnstotal
,limit
andpage
attributes for all responses (not just Multiple Residence)
March 2021
- [API]
/keys/:key
API now accepts sublicensee keys that beginsl_
February 2021
- [Monitoring] Incident feeds now available in Atom and RSS feed formats. E.g. meta.ideal-postcodes.co.uk/history.atom. See Status API documentation for more information
January 2021
- [Logging] Usage log exports now report the
Origin
header in the URL column if theReferer
is not available
December 2020
- [API] Checking key details with the
/keys/:key
will now return adatasets
attribute. This identifies which datasets (i.e. PAF, Multiple Residence, Not Yet Built) this key has access to
November 2020
- [Authentication] Licensee keys may now be passed in via the API Key argument of the querystring (
api_key=
) or authorization headerIDEALPOSTCODES api_key=""
. Our documentation will be updated to reflect this as the primary method of identifying a licensee. However the earlier method of supplying bothlicensee
andapi_key
will continue to be supported
October 2020
- [API]
/addresses
now accepts no terms query. This means addresses can be searched using just filters likepostcode
- [API] New filters available for
/addresses
includingpostcode_area
,postcode_sector
,uprn
and more - [API] Search
/addresses
with UPRNs using theuprn=
filter
September 2020
- [Data] Address responses now return a
uprn
attribute for GB addresses - [Data] GB address geolocations are now rooftop accurate if they have a
uprn
assigned