Ideal Postcodes API

Direct HTTP integration with the Ideal Postcodes API. Supports multiple client libraries and language SDKs. UK and Irish addresses by default, with international coverage selected per request.

Quick Start (fetch)

const key = process.env.IDEAL_POSTCODES_API_KEY;
const base = 'https://api.ideal-postcodes.co.uk/v1';
const headers = { Authorization: `Bearer ${key}` };

// Postcode lookup: every address at a postcode, as an AddressListItem[]
const lookup = await fetch(`${base}/postcodes/SW1A1AA`, { headers });
const { result: addresses } = await lookup.json();
console.log(addresses[0].line_1, addresses[0].dataset); // "10 Downing Street" "paf"