Product updates

Changelog

A running record of what we ship across the API, address verification tools, dashboard, and integrations. Updated regularly.

JSON feed

Ideal Postcodes CLI

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 Adds Welsh Parliament and Expanded Scottish Data

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 Dashboard

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

Agent Skills for Claude Code, Cursor, and Codex

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.

Postcode Lookup for Microsoft Dynamics 365 Business Central

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.

WooCommerce 4: Block Checkout Support

WooCommerce 4 is the new major release of our WooCommerce plugin, adding support for the block-based checkout. The postcode lookup is rebuilt as an isolated web component so it no longer interferes with checkout form validation. Requires WooCommerce 8 or above; legacy shortcode checkout is no longer supported.

Details

  • Block checkout: Postcode Lookup and Address Autocomplete work natively in the block-based checkout
  • Isolated web component: The rebuilt postcode lookup no longer blocks order submission by clashing with form validation
  • Country-aware validation: A new toggle switches off address validation automatically when the customer selects an unsupported country
  • Dedicated Address Finder field: Optionally render the address search in its own field
  • JSON configuration overrides: Fine-tune Postcode Lookup and Address Autocomplete behaviour directly from the Advanced settings tab
  • Validation controls: Address line one character limit (default 40), transliteration of accented characters to ASCII, ASCII-only input, automatic company name population, and PO Box blocking

Find the settings under WooCommerce > Settings > Integration > UK Address Postcode Validation. Full setup in the WooCommerce integration docs.

Postcode Lookup for Singapore, Ireland and Netherlands

Postcode lookup is now available for Singapore, Ireland (HERE) and the Netherlands. Resolve a postcode to its set of addresses in three more markets without falling back to an autocomplete flow.

Details

  • Singapore: Postcode-to-address resolution across the SGP dataset
  • Ireland: Eircode-style postcode lookups against the HERE Ireland dataset
  • Netherlands: Postcode lookup over Dutch address data

Passkey Sign-In for Dashboard Accounts

Sign in to your Ideal Postcodes account with a passkey. Use Touch ID, Face ID, Windows Hello or a hardware security key in place of a password. Phishing-resistant by design and faster on every return visit.

Details

  • Register from settings: Add one or more passkeys to your account from the security settings
  • WebAuthn standard: Works with platform authenticators (Touch ID, Face ID, Windows Hello) and roaming keys (YubiKey and similar)
  • Coexists with passwords: Keep your existing password as a fallback while adopting passkeys at your own pace

Partnership with Cytora for Commercial Insurance Risk Processing

Ideal Postcodes address validation is now embedded in Cytora, the digital risk processing platform used by commercial insurers worldwide. Underwriters get verified, building-level location data at the point of risk ingestion, without extra steps or manual checking.

Details

  • Unique Property Reference Numbers: Every risk is pinned to a UPRN, identifying the individual building and eliminating location ambiguity
  • Rooftop geocodes: Building-level latitude and longitude rather than street or postcode approximations, sharpening risk selection and pricing for location-specific hazards
  • Fuzzy matching: Common address errors are caught and corrected automatically during ingestion, standardising records for accumulation management and faster claims handling

Organizations and Role-Based Access

Accounts now belong to an organization. Multiple users can collaborate on the same set of API keys and billing, with role-based permissions controlling what each member can do. Every existing user has been migrated into a single-member organization automatically.

Details

  • Shared workspace: API keys, purchases, invoices and agreements live under the organization, not an individual user
  • Roles: Owners, admins and developers see scoped controls in the dashboard
  • Invitations: Add teammates by email and manage pending invitations from the dashboard
  • Billing & invoices: Centralized at the organization level, with the existing tokens and balance preserved