Address lookup API
These API endpoints provide address capture using the latest address data aggregated from our global data partners including Royal Mail, Ordnance Survey, Eircode, USPS and HERE.
Address autocomplete
These API endpoints provide free real-time address suggestions as users start to type their address, and a chargeable lookup to retrieve full details of a selected address. 249 countries supported.
| autocomplete/find | Returns a list of address suggestions as an address is being typed. |
| autocomplete/retrieve | Returns the full address for an address suggestion ID. |
Other API endpoints
These API endpoints offer address lookup and matching on postcodes, partial addresses, coordinates and IP addresses.
| address | Returns a list of addresses that match a postcode or partial address. |
| reversegeo | Returns a list of addresses within range of a UK or Irish coordinate position. |
| position | Returns the coordinates for a UK postcode or Irish Eircode. |
| udprn | Returns the address for a Royal Mail UDPRN. |
| street | Returns a list of street addresses for a UK postcode. |
| nyb | Returns a list of Royal Mail Not Yet Built addresses for a UK postcode. |
| ipaddress | Returns geolocation information for an IP address. |
| ngd/find | Returns a list of OS National Geographic Database (NGD) suggestions as an address is being typed. |
| ngd/retrieve | Returns the OS National Geographic Database (NGD) record for a suggestion ID. |
| ngd | Returns a list of OS National Geographic Database (NGD) records that match a postcode, partial address, UPRN or UDPRN. |
| pafaddressbase | Returns a list of Royal Mail PAF addresses that match a postcode or partial address, enriched with OS AddressBase data. |
| addressbase | Returns a list of OS AddressBase records that match a postcode or partial address. |
| addressbase/uprn | Returns the OS AddressBase record for a UPRN. |
| addressbase/dpa | Returns a list of OS AddressBase records with Delivery Point Addresses (DPAs) that match a postcode or partial address. |
| addressbase/lpi | Returns a list of OS AddressBase records with Local Property Identifiers (LPIs) that match a postcode or partial address. |