Skip to main content

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

  • [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
  • [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

  • [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

  • [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 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

  • [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
    • 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

  • [Documentation] Interactive API reference at 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

  • [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

  • [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

  • [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

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

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

  • [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

  • [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

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

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.
  • [Performance] JavaScript libraries now served directly from the API for improved caching, reduced latency, and simplified integration

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] Localized and improved South Korea coverage with MOIS dataset

April 2025

  • [Data] Localized and improved Belgium coverage with FODBOSA
  • [Data] Localized and improved Japan coverage

March 2025

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

February 2025

  • [Data] Expanded Canada coverage with Canada National Address Register dataset

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

  • [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

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

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

  • [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 Lookup] Added the ability to fix Address Lookup

September 2023

  • [Address Lookup] Added new callback for changes in country or context
  • [Address Lookup] 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 Lookup

March 2023

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

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

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

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

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

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

  • [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

  • [Data] Welsh PAF addresses now generally available