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
lookupscolumn 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
.mdfiles 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/verifyAPI 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/:keyAPI - [API] Available datasets accessible through
GET /keys/:key/detailsAPI - [Address Finder] Added the ability to
fixAddress 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/:postcodeAPI 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/cleanseGBR 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/:postcodeAPI if Eircode is enabled
November 2022
- [API] Email Validation API now available
- [Security] Wildcard subdomain allowed URLs available. Add
*.domain.comto allow requests fromdomain.comand 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.comwill matchexample.comas 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/:idto resolve details for a place given a suggestion
July 2022
- [API]
/autocomplete/addresses/:id/gbrnow returns the local format of an address if not located in GBR inside thenativeattribute - [API]
/autocomplete/addresses/:id/usanow returns the local format of an address if not located in USA inside thenativeattribute
June 2022
- [Data] Irish Addresses (Eircode) now supported by the autocomplete API. Contact our support team to have this enabled on your account
- [API]
/addressesAPI 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/:keyAPI 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/usaAPI which resolves address suggestions to the USA address format
February 2022
- [Data] Addressing data for USA available
- [API]
/autocomplete/addressesnow accepts acontext=argument which allows additional countries to be searched. This currently defaults toGBRbut also acceptsUSA - [API] New
autocomplete/addresses/:id/gbrAPI which resolves address suggestions to the GBR address format (regardless of country)
January 2022
- [API] The standard GBR address objects now also return an
idattribute - [API] The standard GBR address object now also returns a
datasetattribute which identifies the provenance of a result (e.g.pafmeans Postcode Address File,mrmeans Multiple Residence andnybmeansNot Yet Built) - [API] The standard GBR address object now also returns a
country_isowhich returns the 3 letter ISO country code
December 2021
- [API]
/addressesand/autocomplete/addressesnow 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]
/addressesand/autocomplete/addressesnow 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]
/addressesand/autocomplete/addressesnow 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]
/addressesand/autocomplete/addressesnow 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]
/addressesand/autocomplete/addressesnow accept query arguments to bias results by locality or postcode elements likepost_townorpostcode_sectorwithbias_post_town=andbias_postcode_sector=
May 2021
- [API]
/postcodes/:postcodenow returns up to 5 suggested postcodes if there is no exact postcode match. It will check for common errors first (i.e. mixing up0andOor1andI)
April 2021
- [API]
/postcodes/:postcodenow returnstotal,limitandpageattributes for all responses (not just Multiple Residence)
March 2021
- [API]
/keys/:keyAPI 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
Originheader in the URL column if theRefereris not available
December 2020
- [API] Checking key details with the
/keys/:keywill now return adatasetsattribute. 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 bothlicenseeandapi_keywill continue to be supported
October 2020
- [API]
/addressesnow accepts no terms query. This means addresses can be searched using just filters likepostcode - [API] New filters available for
/addressesincludingpostcode_area,postcode_sector,uprnand more - [API] Search
/addresseswith UPRNs using theuprn=filter
September 2020
- [Data] Address responses now return a
uprnattribute for GB addresses - [Data] GB address geolocations are now rooftop accurate if they have a
uprnassigned