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 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
• [API] Premier support enrolment visible on key details (2026-07-29, v3.8.0)
  • The read-only premier_support flag reports whether a key is enrolled in the premier support program
• [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