Changelog

French address searches now run on the Base Adresse Nationale (BAN), France's official national address database. Authoritative, localised address data across mainland France and the overseas territories.

Details

• Official source: The BAN is France's government-maintained national address base, giving standardised coverage nationwide
• Localised formatting: Addresses are parsed and formatted to French conventions, with province and province_code derived from the INSEE code
• New dataset flag: Enable BAN on an API key with the ban dataset flag; France (FRA) is available as a search context

AddressBase Premium is now available across the API. Ordnance Survey's most comprehensive Great Britain address dataset reaches beyond Royal Mail's PAF to include properties with no postal delivery point - subdivided units, multi-occupancy buildings, commercial premises, and objects still under development. Every record carries a UPRN and a rooftop geolocation, alongside the full Ordnance Survey property record. Contact us to enable the abp dataset, then search it through autocomplete, address lookup, and postcode lookup.

Details

• Wider coverage than PAF: AddressBase Premium records every Basic Land and Property Unit in Great Britain, including premises Royal Mail does not hold.
• UPRN and rooftop coordinates on every record: Each result carries Ordnance Survey's Unique Property Reference Number plus a rooftop latitude and longitude. Some records have no Royal Mail UDPRN, since the dataset extends past PAF's delivery points.
• Full Ordnance Survey property record: The native object exposes the consolidated BLPU, DPA, LPI, classification, and street records - land-use classification, multi-occupancy count, street (USRN) and topography (TOID) references, council tax and non-domestic rates references, and lifecycle dates.
• Available everywhere: Select abp on the /autocomplete, /addresses, and /postcodes endpoints. Suggestions show the post town and outward code (for example, ... Brighton, BN41), with full title-cased address lines on resolve.
• Reference: See the AddressBase Premium dataset docs for the full field list.

Add UK address autocomplete to a React app in a single component. The new @ideal-postcodes/react package gives you a drop-in <AddressFinder> with no useEffect or useRef wiring to manage. Install with npm install @ideal-postcodes/react.

Details

• Drop-in component: Render <AddressFinder> and start searching. The widget lifecycle is handled for you, with no manual setup or teardown
• Bring your own input: Let the component render its own field, or wrap an input you already have. It works alongside design systems such as shadcn/ui, MUI, and Mantine
• Every callback as a prop: Each widget event is exposed directly, including onAddressRetrieved. Inline handlers always see your latest state, so there is no need to reach for useCallback
• Styling that fits your build: CSS is injected automatically, or import it yourself for full control under server-side rendering
• Framework ready: Tested with the Next.js App Router ("use client") and Pages Router, Remix, and Astro, on both React 18 and 19

Read the React integration guide to get started. The latest Address Finder (5.2.15) and Postcode Lookup (3.3.2) widget bundles also ship in this release.

Cleanse, verify, and enrich UK addresses without leaving Excel. The new Address Cleanse add-in matches your addresses against the Royal Mail Postcode Address File: drag-select the address column, click Cleanse, and corrected addresses with UPRNs and geocodes are written alongside your data. No exports, no code.

Details

• Cleanse in place: Select one column of freeform addresses, or two columns with a postcode hint, and results are written immediately to the right
• 31 columns per row: Status, formatted address, confidence and fit scores, per-element match levels, geocodes, UPRN, UDPRN, and country data
• Static values: Results persist in the workbook, so it can be shared and reopened by anyone without the add-in or an API key
• All Microsoft 365 platforms: Works in Excel for Windows, Excel for Mac, and Excel for the web
• Key kept private: Your API key is held in Office storage, never in cells or files

Follow the install guide to get started; an AppSource listing is on its way.

Introducing idpc, the Ideal Postcodes command-line interface. Manage your account, clean address data, and validate emails and phone numbers from the terminal. Built for humans and agents.

In agent mode, the CLI will non-interactively emit JSON to stdout and signal failure through exit codes.

Details

• Key management: Check balances, usage, lookup logs, and allowed-URL configurations for your API keys
• Address cleansing: idpc cleanse matches messy addresses against authoritative data, taking a single query, a file, or stdin, with CSV output for batches
• Find and resolve: idpc find returns address suggestions for a partial query; pipe a suggestion ID into idpc resolve for the full record
• Email and phone validation: idpc email and idpc phone mirror the cleanse workflow, with --carrier lookups for phone numbers
• Diagnostics: idpc doctor verifies connectivity and reports whether your key is actually usable, explaining limits or restrictions when it is not

Install with npm install -g @ideal-postcodes/cli. Available on npm.

Postcodes.io 19 is out, adding Senedd Cymru constituency fields, a far richer Scottish Postcode Directory, and faster bulk lookups.

Details

• Welsh Parliament data: Postcode lookups now return official Senedd Cymru constituency fields, with schemas and documentation updated to match
• Expanded Scottish coverage: The Scottish Postcode Directory endpoint grows from three fields to over 50 distinct data fields and 20+ administrative codes, including the Scottish Index of Multiple Deprivation, data zones (2001 and 2011), and historical Census Output Areas (1991, 2001, 2011)
• Simpler data layer: The database is flattened and denormalised into three master tables: onspd, spd, and osopennames
• Faster bulk operations: Bulk postcode and reverse-geocoding requests are batched into single SQL queries, with Postgres tuned for read-only workloads using pg_prewarm and partial indexes

Reseller organisations now have a dedicated dashboard that summarises their licensees, active client count, and usage costs for any billing period. Track the accounts you manage and reconcile usage without exporting raw logs by hand.

Details

• Account overview: See your licensees, active client count, and usage costs at a glance for the selected period
• Customer breakdown: A per-licensee table shows each client's address and API key, with sortable numeric columns and CSV export
• Period picker and deep-links: Choose any billing period and jump straight to a licensee's keys and dates

Integrate Ideal Postcodes from inside your AI coding agent. The new ideal-postcodes/skills plugin teaches Claude Code, Cursor, and Codex how to wire up our widgets, API, and CLI correctly the first time. Install with npx skills add ideal-postcodes/skills.

Details

• Address Finder: Set up the autocomplete widget (@ideal-postcodes/address-finder), from install to populated form fields
• Postcode Lookup: Postcode in, address dropdown out (@ideal-postcodes/postcode-lookup)
• API integration: Authentication, /postcodes, /addresses, /udprn, and /autocomplete, client libraries, and error handling
• CLI: Manage keys, cleanse addresses, and resolve partial queries from the terminal with the idpc CLI
• Built for agents: Each skill carries quickstarts, critical gotchas, and reference material, cutting the back-and-forth of getting a working integration

The repo is public; issues and pull requests are welcome.

Ideal Postcodes is now the address validation provider built into Microsoft Dynamics 365 Business Central. From Release 28, the extension ships by default to all UK and Republic of Ireland Business Central users, replacing the discontinued getAddress.io service.

Details

• Native postcode lookup: Fast UK postcode search inside the existing Business Central interface, with fuzzy matching for unrecognised postcodes
• Automatic field population: Selected addresses fill the address fields in the correct format across customer records, quotes, and orders
• Royal Mail PAF data: Backed by the Postcode Address File, covering over 30 million delivery points and 1.8 million postcodes
• Simple activation: Add your Ideal Postcodes API key in Business Central's Service Connections settings; no additional software required
• Rollout window: New customers receive version 28.0 automatically; existing customers can schedule the update any time before 31 August 2026

See Microsoft's setup guide to get started.