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,stateandpostal_codefilters and biases now match values likeSan Francisco,New Yorkand94102-1234(previously only single-word, unhyphenated values matched)postal_code_2,postal_code_3,state_code,is_pobox,is_businessand theirbias_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
msgCountryToggledefault is now recorded as"Change Country"
- Documents the WCAG 2.1 AA statement, keyboard support map, and testing regime; the
- [API] Premier support enrollment visible on key details (2026-08-20, v3.8.0)
- The read-only
premier_supportflag reports whether a key is enrolled in the premier support program
- The read-only
- [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
msgCountryToggledefault of"Change Country"
- The Address Lookup reference now covers WCAG 2.1 AA conformance, keyboard behavior, and the
- [Data] New Swisstopo dataset for Switzerland and Liechtenstein addresses (2026-08-20)
- Enable the
swtflag on your API key to search, autocomplete, resolve and cleanse Swiss (CHE) and Liechtenstein (LIE) addresses, with German, French, Italian and Romansh language indexes
- Enable the
- [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-IPheader 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
- The address forwarded in the
- [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 theonNoMatchActioncallback — useful for revealing a manual address entry form
- Set
- [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
shouldAddressPopulatehook to gate address population (2026-07-13, v2.3.5)- Return
falsefrom 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
- Return
- [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
shouldAddressPopulateoption
- New "Gate Population by Delivery Area" guide covers synchronous and asynchronous checks and fail-open error handling for the new
- [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
banflag on your API key to search and resolve French addresses from the Base Adresse Nationale
- Enable the
- [API] BAN (France) TypeScript types available in the AddressZen OpenAPI package (2026-07-01, v3.7.0)
- New
BanAddresstype exposes the Base Adresse Nationale schema across the address lookup and resolve endpoints
- New
- [Integration] BAN (France) dataset added to the API integration agent skill (2026-07-01, v0.2.5)
June 2026
- [Integration] CLI:
keyssubcommands split for context and dataset management (2026-06-30, v0.3.0)azn keys contextreports the current and available geographic contexts;azn keys datasetsreports dataset availabilityazn keys datasets updateenables or disables datasets with repeatable-e/--enableand-d/--disableflags (e.g.azn keys datasets update -e paf -e abp -d mr)
- [Integration] AddressZen agent skills: CLI reference updated for the new
keyssubcommands (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-lookupskill now documents how to mapcountry_iso,country_iso_2, andcountryfields to a country<select>element azn-reactskill is now listed in the Cursor and Codex plugin manifests
- The
- [API] AddressBase Premium TypeScript types available in the AddressZen OpenAPI package (2026-06-23, v3.6.0)
- New
AbpAddresstype exposes the full property-level record from Ordnance Survey AddressBase Premium — BLPU, DPA, classification, and ground stability — across the address lookup and resolve endpoints
- New
- [API] New endpoint to regenerate a licensee API key (2026-06-23)
POST /v1/keys/:key/licensees/:licensee/regenerate-keymints 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
azncommand 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 forazn-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-lookupskill covers the@addresszen/address-lookupvanilla JS widget - New
azn-api-integrationskill covers direct HTTP integration with the AddressZen API - The
addresszen-reactskill has been renamed toazn-react; update withnpx skills add addresszen/skills
- New
- [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
- When wrapping your own controlled
- [API] New
AZ-Source-IPresponse 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/reactprovides 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/skillsplugin ships a quickstart and reference docs for Address Lookup and the React component - Install with
npx skills add addresszen/skills
- New
- [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/detailsreturns expanded key metadata (2026-03-25)- Response now includes
name,contexts,datasets, and notification settings
- Response now includes
- [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=nybfor 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
.mdto 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
lookupscolumn 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
.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] 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/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
February 2024
- [Data] Search improvements for Iberian languages: Spanish, Catalan, Galician and Basque
- [Address Lookup] 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 Lookup] Added the ability to
fixAddress 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/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)
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 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.comwill matchexample.comas 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]
/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 acontextsvalue which correlates with the user's locality
April 2022
- [Data] Welsh PAF addresses now generally available