Cookie

Cookie consent

We use some essential cookies to make this website work. We'd like to set additional cookies to help us measure your experience when you view and interact with the website.

Cookie policy

Address lookup API

UK and international

These endpoints return address information when given a postcode, part of an address or a coordinate position. They provide you with access to addresses in the Royal Mail PAF and Multiple Residence datasets, and addresses in global datasets covering 249 countries including Eircode, USPS ZIP+4 and HERE.

addressReturns one or more full addresses with optional coordinates for a given postcode or part of an address. Supports 249 countries and can be used for UK postcode lookup, Irish Eircode lookup, global address lookup and geocoding.
autocomplete/findReturns one or more address suggestions as an address is being typed. Supports 249 countries.
autocomplete/retrieveReturns the full address for a given suggestion ID returned by the /autocomplete/find endpoint above.
reversegeoReturns one or more full addresses within a specified range of a coordinate position in the UK or Ireland.
positionReturns the coordinates for a given UK postcode or Irish Eircode.
udprnReturns the full address for a given Royal Mail UDPRN.
streetReturns one or more street addresses for a given UK postcode.
nybReturns one or more Royal Mail Not Yet Built addresses for a given UK postcode.
ipaddressReturns geolocation information for an IP address.

AddressBase

These endpoints return Ordnance Survey property records for England, Scotland and Wales using the AddressBase Core and AddressBase Premium datasets.

addressbaseReturns one or more property records with an associated Delivery Point Address (DPA) record that matches a given postcode or part of an address.
pafaddressbaseReturns one or more Royal Mail PAF addresses for a given postcode or part of an address, enriched with data from the associated property records.
addressbase/uprnReturns the property record for a given Ordnance Survey UPRN.
addressbase/dpaReturns one or more property records with an associated Delivery Point Address (DPA) record that matches a given postcode or part of an address.
addressbase/lpiReturns one or more property records with an associated Local Property Identifier (LPI) record that matches a given postcode or part of address.
addressbase/dpalpiRefer to the addressbase/lpi endpoint which now works in the same way as this original endpoint.