# 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.

## September 2026[​](#september-2026 "Direct link to September 2026")

* **\[Dashboard]** Clearer label and validation on the GDPR retention period setting *(2026-09-08)*
  * The redaction period control on your key dashboard now shows its unit and caps input at 1095 days, matching the API limit (previousl

* **\[API]** Autocomplete's non-UK filters are now documented, and US filters match multi-word and hyphenated values *(2026-09-07)*

  * `city`, `state` and `postal_code` filters and biases now match values like `San Francisco`, `New York` and `94102-1234` (previously only single-word, unhyphenated values matched)
  * `postal_code_2`, `postal_code_3`, `state_code`, `is_pobox`, `is_business` and their `bias_` equivalents are now part of the documented autocomplete contract

* **\[Billing]** Default AddressBase Premium lookup cost rises from 4 to 6 credits *(2026-09-07)*
  * Applies to new keys and any existing key without a custom AddressBase Premium rate already set; keys with a custom rate already configured are unaffected

## August 2026[​](#august-2026 "Direct link to August 2026")

* **\[Dashboard]** Fixed confirmation emails occasionally being sent to a stale address *(2026-08-28)*

  * Email confirmations now always reach your current account address, even after an abandoned email change
  * You can also cancel a pending email change from your account page

* **\[Security]** Stronger password and lockout rules on your dashboard account *(2026-08-27)*

  * New or changed passwords must now be at least 12 characters (previously 6); existing passwords are unaffected until you change them
  * Accounts lock for an hour after 10 failed sign-in attempts, and a locked account no longer prompts for a two-factor code

* **\[Address Lookup]** Accessibility fixes released *(2026-08-20, v2.4.2)*

  * The country toggle is fully keyboard operable (Tab to reach, Enter or Space to activate, Escape to dismiss) and no longer closes the suggestion list when focused
  * Screen readers no longer receive invalid listbox semantics while a notice such as `"No matches found"` is on display, announcements are no longer at risk of being spoken twice, and the first results announcement names the active search country and how to change it
  * Every widget state passes axe-core's WCAG 2.1/2.2 A and AA rulesets, which gate each release

* **\[Integration]** AddressZen agent skills: new accessibility reference for Address Lookup *(2026-08-20, v0.2.8)*
  * Documents the WCAG 2.1 AA statement, keyboard support map, and testing regime; the `msgCountryToggle` default is now recorded as `"Change Country"`

* **\[API]** Premier support enrollment visible on key details *(2026-08-20, v3.8.0)*
  * The read-only `premier_support` flag reports whether a key is enrolled in the premier support program

* **\[Logging]** Usage log CSV now labels cleanse, verify and phone validation lookups *(2026-08-12)*
  * The search type column in your key's usage log CSV previously exported blank for these three request types

* **\[Security]** Account security hardening across sign-in, tokens and subscriptions *(2026-08-21)*
  * Changing your account email or disabling two-factor authentication, now always require your current password

* **\[Authentication]** A successful password reset now clears an account lockout *(2026-08-21)*
  * You no longer need a manual unlock after resetting your password following a lockout

* **\[Integration]** AddressZen agent skills: documented accessibility support and the new country toggle label *(2026-08-20, v0.2.8)*
  * The Address Lookup reference now covers WCAG 2.1 AA conformance, keyboard behavior, and the `msgCountryToggle` default of `"Change Country"`

* **\[Data]** New Swisstopo dataset for Switzerland and Liechtenstein addresses *(2026-08-20)*
  * Enable the `swt` flag on your API key to search, autocomplete, resolve and cleanse Swiss (CHE) and Liechtenstein (LIE) addresses, with German, French, Italian and Romansh language indexes

* **\[Authentication]** Clearer error when a passkey sign-in or registration loses its network connection *(2026-08-12)*
  * Previously showed a generic "try again" message; now tells you to check your connection

## July 2026[​](#july-2026 "Direct link to July 2026")

* **\[API]** Usage log CSV now records the forwarded source IP *(2026-07-29)*

  * The address forwarded in the `AZ-Source-IP` header is written to the final column of your key's usage log CSV, so backend integrations can trace a lookup back to the end user who triggered it
  * Only recorded for keys with IP address forwarding enabled, and only when the header holds a valid IP address; it is redacted on the same schedule as the other personal data in the log

* **\[Address Lookup]** Accessibility improvements for keyboard and screen reader users *(2026-07-27)*

  * The country toggle is now fully keyboard operable: Tab to reach it, Enter or Space to open the country list, Escape to dismiss
  * The first results announcement identifies the active search country and how to change it; screen reader announcements are no longer at risk of being spoken twice
  * Every release is now gated by automated axe-core WCAG A/AA scans, and a new [Accessibility guide](/docs/address-lookup/accessibility.md) documents the widget's keyboard support and screen reader behavior

* **\[Address Lookup]** New fallback action when a search returns no matches *(2026-07-21, v2.4.0)*
  * Set `msgNoMatchAction` (e.g. `"Enter address manually"`) to show an actionable prompt beneath the no-match message, and handle its selection with the `onNoMatchAction` callback — useful for revealing a manual address entry form

* **\[Integration]** AddressZen agent skills: documented the Address Lookup no-match action *(2026-07-21, v0.2.7)*

* **\[Dashboard]** Dashboard visual refresh *(2026-07-15)*

* **\[Address Lookup]** New `shouldAddressPopulate` hook to gate address population *(2026-07-13, v2.3.5)*
  * Return `false` from the hook — run after an address is retrieved, before it's written to the form — to cancel population, for example for delivery-area checks or custom confirmation flows

* **\[Integration]** AddressZen agent skills: guidance for gating address population by delivery area *(2026-07-13, v0.2.6)*
  * New "Gate Population by Delivery Area" guide covers synchronous and asynchronous checks and fail-open error handling for the new `shouldAddressPopulate` option

* **\[Authentication]** Member lists show each organization member's MFA and passkey status *(2026-07-07)*
  * Both the backend admin view and your organization's members page now show whether a member has multi-factor authentication or a passkey configured

* **\[Dashboard]** France BAN dataset available as a toggle on API keys *(2026-07-03)*
  * Enable or disable the France national address dataset from your key's dataset settings, with a link to the documentation

* **\[Data]** France BAN dataset now live across address search and lookup endpoints *(2026-07-02)*
  * Enable the `ban` flag on your API key to search and resolve French addresses from the Base Adresse Nationale

* **\[API]** BAN (France) TypeScript types available in the AddressZen OpenAPI package *(2026-07-01, v3.7.0)*
  * New `BanAddress` type exposes the Base Adresse Nationale schema across the address lookup and resolve endpoints

* **\[Integration]** BAN (France) dataset added to the API integration agent skill *(2026-07-01, v0.2.5)*

## June 2026[​](#june-2026 "Direct link to June 2026")

* **\[Integration]** CLI: `keys` subcommands split for context and dataset management *(2026-06-30, v0.3.0)*

  * `azn keys context` reports the current and available geographic contexts; `azn keys datasets` reports dataset availability
  * `azn keys datasets update` enables or disables datasets with repeatable `-e`/`--enable` and `-d`/`--disable` flags (e.g. `azn keys datasets update -e paf -e abp -d mr`)

* **\[Integration]** AddressZen agent skills: CLI reference updated for the new `keys` subcommands *(2026-06-30, v0.2.4)*

* **\[Data]** AddressBase Premium address coverage extended for non-postal records *(2026-06-29)*
  * AddressBase Premium now appears in the dataset list on your API key page, where it can be enabled or disabled

* **\[Integration]** AddressZen agent skills: country select population and expanded plugin listings *(2026-06-24, v0.2.3)*

  * The `azn-address-lookup` skill now documents how to map `country_iso`, `country_iso_2`, and `country` fields to a country `<select>` element
  * `azn-react` skill is now listed in the Cursor and Codex plugin manifests

* **\[API]** AddressBase Premium TypeScript types available in the AddressZen OpenAPI package *(2026-06-23, v3.6.0)*
  * New `AbpAddress` type exposes the full property-level record from Ordnance Survey AddressBase Premium — BLPU, DPA, classification, and ground stability — across the address lookup and resolve endpoints

* **\[API]** New endpoint to regenerate a licensee API key *(2026-06-23)*
  * `POST /v1/keys/:key/licensees/:licensee/regenerate-key` mints a new server-generated key for the licensee and invalidates the old one

* **\[Integration]** AddressBase Premium data model added to the API integration agent skill *(2026-06-23, v0.2.2)*

* **\[Data]** Added the BAN (Base Adresse Nationale) dataset for France, providing open national address coverage *(2026-06-23)*

* **\[Integration]** New `azn` command line interface *(2026-06-19, v0.2.0)*

  * Manage API keys, verify US addresses, validate emails and phone numbers, and find addresses from the terminal or any agent/CI pipeline
  * Emits JSON in non-TTY environments, uses stable exit codes, and never prompts under a pipe; full documentation at [docs.addresszen.com/docs/cli](https://docs.addresszen.com/docs/cli)
  * Agent skill for AI-assisted development: install with `npx skills add addresszen/skills` — look for `azn-cli`

* **\[Data]** AddressBase Premium available for UK address search *(2026-06-22)*
  * AddressBase Premium data now available via the address search and autocomplete endpoints, providing comprehensive Ordnance Survey property-level records across all building classification types

* **\[Integration]** Agent skills for Address Lookup widget and API integration *(2026-06-18, v0.2.0)*

  * New `azn-address-lookup` skill covers the `@addresszen/address-lookup` vanilla JS widget
  * New `azn-api-integration` skill covers direct HTTP integration with the AddressZen API
  * The `addresszen-react` skill has been renamed to `azn-react`; update with `npx skills add addresszen/skills`

* **\[Address Lookup]** React component: forwarded ref stays stable across renders *(2026-06-18, v2.0.1)*
  * When wrapping your own controlled `<input>`, the ref no longer re-attaches on every keystroke

* **\[API]** New `AZ-Source-IP` response header echoes the detected client IP on every API response *(2026-06-14)*

* **\[Address Lookup]** React component for embedding address lookup in React applications *(2026-06-12, v2.0.0)*
  * `@addresszen/react` provides an `<AddressLookup>` component compatible with React 18 and 19, with two integration modes — default input and wrap-around-your-own-input — and the full callback surface exposed as props

* **\[Integration]** Agent skills for Claude Code, Cursor, and Codex *(2026-06-12, v0.1.0)*

  * New `addresszen/skills` plugin ships a quickstart and reference docs for Address Lookup and the React component
  * Install with `npx skills add addresszen/skills`

* **\[Address Lookup]** TypeScript declarations now shipped from compiled output *(2026-06-12, v2.3.3)*

* **\[Dashboard]** Changelog feed in the account dashboard *(2026-06-10)*
  * Recent product updates now appear in the account sidebar, keeping you informed without leaving the dashboard

* **\[Security]** Security update for Address Lookup *(2026-06-06, v2.3.2)*
  * Resolves a regular expression denial of service via cookie names (GHSA-hfxv-24rg-xrqf) and prototype pollution issues in earlier axios versions; update to the latest widget version to pick up the fix

## May 2026[​](#may-2026 "Direct link to May 2026")

* **\[Documentation]** Interactive API reference at [openapi.addresszen.com](https://openapi.addresszen.com) *(2026-05-28)*
  * Rendered OpenAPI reference and raw spec downloads, refreshed automatically with every spec release

* **\[Dashboard]** Reseller dashboard *(2026-05-17)*

  * Reseller organizations now see a dedicated dashboard summarizing their licensees, active client count, and usage costs for any billing period
  * Customer breakdown table shows each licensee's address and API key, with sortable numeric columns and CSV export
  * Period picker and deep-links jump straight to a licensee's keys and dates

## April 2026[​](#april-2026 "Direct link to April 2026")

* **\[Billing]** Credit notes available in your account *(2026-04-28)*
  * View credit notes alongside invoices from the billing section

* **\[Billing]** Statement of account *(2026-04-28)*
  * Download a consolidated statement of invoices, payments, and credit notes for any period

* **\[Dashboard]** Organization deletion *(2026-04-27)*
  * Permanently remove an organization and its data from your account when it is no longer needed

* **\[Dashboard]** Multi-organization accounts *(2026-04-24)*

  * Switch between organizations from a single login
  * Single-organization users are routed straight to their organization page on sign-in

* **\[Billing]** Reduced 3D Secure (SCA) prompts on automated top-ups *(2026-04-23)*

* **\[Data]** Corrected ISO 3166-1 alpha-3 country code for Kosovo *(2026-04-23)*

* **\[Dashboard]** New URL checker tool for Allowed URLs *(2026-04-16)*
  * Test whether a given domain matches your account's allowed URL configuration before going live

* **\[Dashboard]** Documentation search integrated into the dashboard *(2026-04-14)*
  * Search the documentation directly from your account using DocSearch

* **\[Data]** Fixed Republic of Ireland address line formatting on HERE datasets *(2026-04-08)*

* **\[Logging]** CSV transaction usage export now includes a licensee name column *(2026-04-02)*

* **\[Authentication]** Passkey (WebAuthn) sign-in *(2026-04-01)*
  * Sign in using Touch ID, Windows Hello, or hardware security keys instead of a password

## March 2026[​](#march-2026 "Direct link to March 2026")

* **\[Dashboard]** Dashboard UI refresh *(2026-03-27)*

  * Redesign with dark mode, smooth theme transitions, and modernized screens
  * Improved pagination and notification UX

* **\[Dashboard]** Account notifications *(2026-03-26)*
  * In-dashboard notification bell surfacing recent account events, with email recipients managed per organization

* **\[Dashboard]** Per-dataset toggles on the API key dashboard *(2026-03-26)*
  * Enable or disable individual datasets on a key directly from the keys page

* **\[API]** `GET /keys/:key/details` returns expanded key metadata *(2026-03-25)*
  * Response now includes `name`, `contexts`, `datasets`, and notification settings

* **\[Dashboard]** Self-serve organization creation *(2026-03-11)*
  * Create new organizations from your account without contacting support

## February 2026[​](#february-2026 "Direct link to February 2026")

* **\[Dashboard]** Organization member invitations *(2026-02-25)*
  * Invite teammates to your organization by email and review pending invitations from the organization page
* **\[Dashboard]** Organization accounts *(2026-02-20)*
  * Accounts are now organization-based - invite teammates, share API keys, and assign roles within a single billable entity
* **\[Dashboard]** Account roles: admin, developer, and finance *(2026-02-20)*
  * Assign each organization member a role to scope access to keys, billing, and developer settings
* **\[API]** Monthly lookup limits now configurable on API keys *(2026-02-04)*
  * Set a per-calendar-month cap independently of the daily limit, with usage rolling over at the start of each month

## December 2025[​](#december-2025 "Direct link to December 2025")

* **\[Data]** Added the BEV (Bundesamt für Eich- und Vermessungswesen) dataset for Austria, providing comprehensive and authoritative address coverage

## November 2025[​](#november-2025 "Direct link to November 2025")

* **\[API]** New dataset filter parameter allows you to restrict address searches to specific datasets within a country. E.g. `datasets=nyb` for latest new builds only.
* **\[API]** US Address Validation API now supports fuzzy matching on the state parameter, improving match rates for addresses with minor state name variations

## October 2025[​](#october-2025 "Direct link to October 2025")

* **\[Data]** Northern Ireland dataset update frequency increased from quarterly to weekly
* **\[API]** Non-US address data now parsed into individual structured fields (building number, street name, unit) rather than just address lines
* **\[Data]** Fixed an issue affecting Republic of Ireland addresses where administrative data may be missing for some premises

## September 2025[​](#september-2025 "Direct link to September 2025")

* **\[API]** Streamlined OpenAPI specification designed to reduce context length for LLM-assisted development
* **\[Documentation]** LLM-optimized documentation with llms.txt context file and universal markdown export (add `.md` to any documentation URL)
* **\[API]** Enhanced geospatial accuracy and intelligent country detection for improved search precision

## August 2025[​](#august-2025 "Direct link to August 2025")

* **\[API]** Fixed an issue with the Email Validation API to handle queries without proper encoding

## July 2025[​](#july-2025 "Direct link to 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](/docs/api/key-logs.md) for details.
* **\[Performance]** JavaScript libraries now served directly from the API for improved caching, reduced latency, and simplified integration

## June 2025[​](#june-2025 "Direct link to 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[​](#may-2025 "Direct link to May 2025")

* **\[Data]** Improved and extended UPRN matching for Royal Mail Multiple Residence and Not Yet Built addresses
* **\[Data]** Additional HERE datasets included
* **\[Data]** Localized and improved South Korea coverage with MOIS dataset

## April 2025[​](#april-2025 "Direct link to April 2025")

* **\[Data]** Localized and improved Belgium coverage with FODBOSA
* **\[Data]** Localized and improved Japan coverage

## March 2025[​](#march-2025 "Direct link to March 2025")

* **\[Address Lookup]** Security update for a third-party dependency *(2025-03-26, v2.3.1)*

## February 2025[​](#february-2025 "Direct link to February 2025")

* **\[Data]** Expanded Canada coverage with Canada National Address Register dataset

## January 2025[​](#january-2025 "Direct link to January 2025")

* **\[Integration]** WooCommerce plugin for WordPress stores *(2025-01-21, v1.0.0)*
  * Address autocomplete and postcode-based address selection at checkout, with admin configuration
* **\[Data]** Expanded Denmark coverage with SDFI dataset

## May 2024[​](#may-2024 "Direct link to May 2024")

* **\[Integration]** Zapier app for address verification *(2024-05-22)*
  * Verify and standardize addresses in automated workflows
* **\[API]** Released `/addresses/verify` API for USA CASS Verification

## April 2024[​](#april-2024 "Direct link to April 2024")

* **\[Data]** Netherlands (Kadaster) address dataset incorporated
* **\[Data]** Norway (Kartverket) address dataset incorporated
* **\[Performance]** Improved P95 and P99 latency

## February 2024[​](#february-2024 "Direct link to February 2024")

* **\[Data]** Search improvements for Iberian languages: Spanish, Catalan, Galician and Basque
* **\[Address Lookup]** Country selection is synced if `country:` is defined in `outputFields`

## January 2024[​](#january-2024 "Direct link to January 2024")

* **\[Data]** Australia GNAF address dataset added
* **\[API]** CASS Certified USA address verification generally available

## November 2023[​](#november-2023 "Direct link to November 2023")

* **\[Data]** Improvements to geospatial biasing for USA addresses

## October 2023[​](#october-2023 "Direct link to October 2023")

* **\[API]** Key settings can be updated via `POST /keys/:key` API
* **\[API]** Available datasets accessible through `GET /keys/:key/details` API
* **\[Address Lookup]** Added the ability to `fix` Address Lookup

## September 2023[​](#september-2023 "Direct link to September 2023")

* **\[Address Lookup]** Added new callback for changes in country or context
* **\[Address Lookup]** Country is automatically detected by IP address

## August 2023[​](#august-2023 "Direct link to August 2023")

* **\[Data]** Hong Kong dataset included
* **\[Data]** Macau dataset included
* **\[Data]** Taiwan dataset included
* **\[Data]** India dataset included

## July 2023[​](#july-2023 "Direct link to July 2023")

* **\[Data]** Asia Pacific data now available
* **\[Data]** Oceania dataset included

## June 2023[​](#june-2023 "Direct link to June 2023")

* **\[Data]** South America data now available
* **\[Data]** Middle East & Africa dataset included

## May 2023[​](#may-2023 "Direct link to May 2023")

* **\[Data]** Eastern Europe data now available

## April 2023[​](#april-2023 "Direct link to April 2023")

* **\[Data]** Western Europe data now available for Address Lookup

## March 2023[​](#march-2023 "Direct link to March 2023")

* **\[Data]** Improved Zip and ZIP+4 searching on USA datasets
* **\[Data]** Improved apartment searches for GBR datasets

## January 2023[​](#january-2023 "Direct link to January 2023")

* **\[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[​](#december-2022 "Direct link to December 2022")

* **\[API]** Phone Validation API now generally available
* **\[Data]** UK post towns are now titlecased (instead of all caps)

## November 2022[​](#november-2022 "Direct link to November 2022")

* **\[API]** Email Validation API now available
* **\[Security]** Wildcard subdomain allowed URLs available. Add `*.domain.com` to allow requests from `domain.com` and all related subdomains
* **\[Address Lookup]** Search improvements: Better search for numeric property numbers with preceding zeros. Improved search for address ranges

## October 2022[​](#october-2022 "Direct link to October 2022")

* **\[Security]** Allowed URLs now permit subdomain wildcards. E.g. `*.example.com` will match `example.com` as well as all subdomains

## June 2022[​](#june-2022 "Direct link to June 2022")

* **\[Data]** Irish Addresses (Eircode) now supported by address autocomplete. Contact our support team to have this enabled on your account
* **\[API]** `/addresses` API now provides reverse geocoding if `lon=` and `lat=` query arguments are supplied. Results are ordered by proximity to the supplied geospatial points

## May 2022[​](#may-2022 "Direct link to May 2022")

* **\[Data]** UK Alias addresses now generally available
* **\[API]** `/keys/:key` API now returns a `contexts` value which correlates with the user's locality

## April 2022[​](#april-2022 "Direct link to April 2022")

* **\[Data]** Welsh PAF addresses now generally available
