Postcode API

If not the cheapest, FREE Address and Postcode API services, giving you access to a constantly validated pool of data.

Create an account to get started / Already have an account? Log in

A comprehensive suite of easy to use, up to date, free, if not affordable, address postcode APIs.

We’re not just a leading UK postcode API lookup service, we’re so much more. We are approved licenced resellers for Ordnance Survey and Royal Mail and manage, maintain and link to a lot of other data including Companies House, Directors at Home, Police, Government, Ordnance Survey and Royal Mail’s Postcode Address File (PAF) & Multi Residency files.

We essentially provide information services delivered through one of several means: you taking out a licence and downloading comma separate files (CSV, Excel, etc), you uploading data to our servers for enhancement & cleaning, you sending us requests via our postcode API or you simply surfing our websites.

Well over 30 million verified UK address records!

No need to store and process these large cumbersome postcode data files yourself, no need for labour intensive processing of updates and changes or otherwise keeping on top of data decay, we take care of all of this inhouse, which must be a considerable time saving benefit for you?

Just some of the applications:

  • Downloads
  • Postcode / address validation
  • Postcode / address correction
  • Postcode / address auto-complete
  • Postcode / address Data enhancement
  • Mapping

Requests to the API should be made over HTTPS so all traffic is encrypted.

The API responds to different methods depending on the endpoint.

Method Usage
GET To retrieve information such as addresses or account data.
POST To create a new resource.
PUT To update the information in an existing resource.
DELETE To permanently remove a resource from Addresses and Postcodes.

All requests to endpoint V2 and V3 should be made to the following URL structure:

https://addressesandpostcodes.co.uk/api/version/resource/endpoint?key=your-api-key

Our legacy V1 API uses a slightly different API structure:

https://addressesandpostcodes.co.uk/api/pc2add/v1/resource/endpoint?key=your-api-key

Response Codes

The API always responds with HTTP status code of 200 code.

All responses are returned with a status parameter of 'success' or 'error'.

Lookup addresses by postcodes

Lookup addresses by postcodes

Basic Request

The basic request provides only plain address data from PAF sources. This is ideal for lightweight applications.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/pc2add/v1/{postcode}/basic?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes The postcode you want to lookup the addresses for.

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Full Request

The full request provides our full data set at the expense of slightly increased return size and processing time.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/pc2add/v1/{postcode}/full?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes The postcode you want to lookup the addresses for.

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Requests to our V2 API are deprecated. Please use our API V3.

Search for sectors

Postcode Information

Boundaries

Get area boundary path

Retrieve a list of coordinates to produce a polygon around the postcode area.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/areas/{area}/path?key=your-api-key

Request

Parameter Type Required Description
area URL Part Yes Any part of a postcode, but must include the area.

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Get sector boundary path

Retrieve a list of coordinates to produce a polygon around the postcode sector.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/sectors/{sector}/path?key=your-api-key

Request

Parameter Type Required Description
sector URL Part Yes Any part of a postcode, but must include the sector.

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Search for sectors

Get sector count & path

Retrieve a count of properties within a polygon and the polygon coordinates.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/sectors/{sector}/total?key=your-api-key

Request

Parameter Type Required Description
sector URL Part Yes The full postcode sector

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Search for postcodes

Postcode count by Polygon

Retrieve a count of postcodes within a polygon.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/total/by/path?key=your-api-key

Request

Parameter Type Required Description
path GET Yes array of [lat, lng] values of the polygon.

Example: [[lat, lng]. [lat, lng]. [lat, lng]]

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode list by polygon

Retrieve a list of postcodes within a polygon.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/list/by/path?key=your-api-key

Request

Parameter Type Required Description
path GET Yes array of [lat, lng] values of the polygon.

Example: [[lat, lng]. [lat, lng]. [lat, lng]]

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Search for properties

Search for property

Retrieve a property by building name or number and postcode.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/paf/properties/lookup?building={building}&postcode={postcode}?key=your-api-key

Request

Parameter Type Required Description
building GET Yes Name or number of the building being searched for.
postcode GET Yes Postcode being searched

Accepted inputs (not case sensitive):
AB101AB, AB10 1AB, ab101ab, Ab101Ab, AB10%201AB

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Properties list by Postcode

Retrieve a list of properties within a postcode.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/addresses?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode being searched

Accepted inputs (not case sensitive):
AB101AB, AB10 1AB, ab101ab, Ab101Ab, AB10%201AB

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Properties count by Polygon

Retrieve a count of properties within a polygon.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/properties/total/by/path?key=your-api-key

Request

Parameter Type Required Description
path GET Yes array of [lat, lng] values of the polygon.

Example: [[lat, lng]. [lat, lng]. [lat, lng]]

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Properties count by radius

Retrieve a count of properties within radius.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/properties/total/by/radius?key=your-api-key

Request

Parameter Type Required Description
lat GET Yes latitude of the center point of your search
lng GET Yes longitude of the center point of your search
radius GET Yes Distance in meters from the center lat, lng

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Properties count by line polygon

Retrieve a count of properties a set buffer from a line.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/properties/list/by/line?key=your-api-key

Request

Parameter Type Required Description
path GET Yes array of [lat, lng] values of the polygon.

Example: [[lat, lng]. [lat, lng]. [lat, lng]]
radius GET Yes Distance in meters from the center lat, lng

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Properties count by postcode

Retrieve a count of properties within a postcode.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/total?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes The full postcode

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode Information

Postcode GEO Information

Returns latitude & longitude centroid for the postcode, County and town.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/geo?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Door Drop Searches

Get Saved Searches

Get a list of all your saves searches - By polygon or radius.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/door-drop?key=your-api-key

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Save a Polygon or Radius search to your account.

Endpoint

POST: https://addressesandpostcodes.co.uk/api/v3/postcodes/door-drop?key=your-api-key

Request

Parameter Type Required Description
name POST Yes Give your search results a friendly name
params[endpoint] POST Yes Send the endpoint of the search type you are using. Valid values are:

/api/v3/properties/total/by/radius
/api/v3/properties/total/by/path
params[total] POST No Number of search results found.

Leave blank to calculate based on input.
params[path] POST No Use if sending a polygon

array of lat, lng values.

Example [[lat, lng]. [lat, lng], [lat, lng]]
params[lat] POST No Use if sending a radius

latitude of the center point of your search
params[lng] POST No Use if sending a radius

longitude of the center point of your search
params[radius] POST No Use if sending a radius

Distance in meters from the center lat, lng

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Remove / hide a Polygon or Radius search to your account.

Endpoint

DELETE: https://addressesandpostcodes.co.uk/api/v3/postcodes/door-drop?key=your-api-key

Request

Parameter Type Required Description
id POST Yes ID of the search you wish to delete

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode API

Postcodes Current and Terminated API

Contains all live and terminated (closed) postcodes within the UK.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/postcode?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to County API

The current county to which the postcode has been assigned.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/electoral-county?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to Local Authority District

Description endpoint #3

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/local-authority-district?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to London Borough API

There are 33 boroughs in London (Includes the City of London which is officially a separate entity despite being located in the centre of London). We’ve reversed engineered ONS data to identify the postcodes that represent each borough.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/london-borough?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to Electoral Ward / Division API

Description endpoint #5

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/electoral-ward?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to Civil Parish (England), Communities (Wales) API

Description endpoint #6

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/civil-parish?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to National Grid Reference API

Shows the status of the assigned grid reference.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/national-grid-reference?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to Former Strategic Health Authority (SHA) England/ Local Health Board (LHB) Wales / Health Board (HB) Scotland / Health Authority (HA) Channel Islands / Health & Social Care Board (HSCB) Northern Ireland API

The health area code for the postcode. SHAs were abolished in England in 2013 but the codes remain as a ‘frozen’ geography. The field will otherwise be blank for postcodes with no grid reference. 36 areas across the UK.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/hlthau?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to NHS England Regions (NHS ER) API

NHSERs (formerly NHS Commissioning Regions - NHS CR) are sub-divisions of the NHS commissioning board. There are four NHS ERs in England and they were renamed from NHS CRs in May 2017. The NHS CRs were formed on 1 April 2013, replacing pan SHAs, and are responsible for providing clinical and professional leadership at sub-national level. They are also responsible for the co-ordination of planning, operational management and emergency preparedness at sub-national level and undertaking direct commissioning functions and processes.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/nhser?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to UK Country Names & Codes API

The code for the appropriate country (i.e. one of the four constituent countries of the UK or Crown dependencies - the Channel Islands or the Isle of Man) to which each postcode is assigned.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/uk-country-names?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to Regions (RGN) (formerly Government Office Regions GOR) API

The nine GORs were abolished on 1 April 2011 and are now known as "regions" for statistical purposes. They were the primary statistical subdivisions of England and also the areas in which the Government Offices for the Regions fulfilled their role. Each region covered a number of local authorities. The region code for each postcode. Pseudo codes are included for Wales, Scotland, Northern Ireland, Channel Island and Isle of Man. The field will be blank for postcodes in England with no grid reference

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/region?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to Standard Statistical Regions API

The 8 SSRs were the primary statistical subdivisions of England before the GORs were adopted for this purpose in 1996. They are now rarely used. The SSR code for the associated county or unitary authority to which each postcode is assigned. A pseudo code is included for postcodes not in England. The field will be blank for postcodes in England with no grid reference.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/standard-statistical-regions?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to Westminster Parliamentary Constituency API

England and Wales - Parliamentary constituencies relate to those defined by the Parliamentary Constituencies (England) Order 2007, the Parliamentary Constituencies (England) (Amendment) Order 2008 and the Parliamentary Constituencies (Wales) (Amendment) Order 2008, and which came into effect at the May 2010 General Election. No further changes are envisaged until 2020. Scotland - The Scottish Parliament (Constituencies) Act 2004, passed by the UK Parliament in July 2004, came into effect upon the dissolution of the last UK Parliament and breaks the linkage between UK parliamentary constituencies and Scottish parliamentary constituencies. This Act has enabled the Westminster Government to reduce the number of Scottish constituencies in the UK parliament in line with recommendations made by the Boundary Commission for Scotland following its Fifth Periodical Review of Constituencies (December 2004). The Parliamentary Constituencies (Scotland) Order 2005 details the reduction of the number of constituencies for the UK Parliament from 72 to 59 Scottish seats. The changes bring the size of Scottish constituencies more into line with the size of English seats. English constituencies currently contain nearly 70,000 voters on average, compared to the Scottish average of 53,500. Northern Ireland - In Northern Ireland, the Commission's Fifth Periodical Report on Parliamentary Constituencies outlined changes to and the composition of constituencies in 2010. In practice, the new Parliamentary Constituencies are not very different to their predecessors. As before there are 18 constituencies, all retaining the same name. In the main, the boundary amendment process has involved the re-assigning of existing electoral wards from one constituency into a neighbouring constituency. The only exception concerns Derryaghy ward within Lisburn City local government district which previously resided entirely within Lagan Valley County constituency. It has now been split into two separate wards - Derryaghy (North) and Derryaghy (South), the former now included in Belfast West borough constituency, the latter remaining where it was.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/westminster-parliamentary-constituency?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to European Electoral Regions (EER) API

EERs are as defined in the European Parliamentary Elections Bill (Bill 65, 1997) to amend the European Parliamentary Elections Act 1978 so as to alter the method used in Great Britain for electing Members of the European Parliament. The Bill created 9 EERs in England with 64 MEPs; Scotland, Wales and Northern Ireland each constitute a single EER, with 7 MEPs, 4 MEPs and 3 MEPs respectively. The EER code for each postcode. Pseudo codes are included for Channel Islands and Isle of Man. The field will otherwise be blank for postcodes with no grid reference.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/european-electoral-regions?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to Local Learning and Skills Council (LLSC)/ Dept. of Children, Education, Lifelong Learning and Skills (DCELLS)/ Enterprise Region (ER) API

The LLSC (England), DCELLS (Wales) or ER (Scotland) code for each postcode. Pseudo codes are included for Northern Ireland, Channel Islands and Isle of Man. The field will otherwise be blank for postcodes with no grid reference.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/postcode-to-local-learning-and-skills-council?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to Travel to Work Areas (TTWA) API

TTWAs are used in labour market analysis and reflect reasonably self-contained zones in which the bulk of the resident population also work. The 228 current TTWAs were defined in 2015 using 2011 Census information on home and work addresses and are built from 2011 Census LSOAs in England and Wales, data zones in Scotland, and SOAs in Northern Ireland (see Section 34). The previous (2007) areas were based on the same statistical geographies from the 2001 Census. The TTWA code for the postcode. Pseudo codes are included for Channel Islands and Isle of Man. The field will otherwise be blank for postcodes with no grid reference.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/travel-to-work-areas?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to Primary Care Trusts

Postcodes on the ONSPD have been assigned PCO codes (England), LHB codes (Wales), CHP codes (Scotland), LCG codes (NI) or Primary Healthcare Directorate code (Isle of Man). Postcodes in the Channel Islands (for which there are no equivalent areas) have been assigned a pseudo code.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/primary-care-trusts?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to Nomenclature of Units for Territorial Statistics (NUTS)

NUTS is a hierarchical classification of spatial units that provides a breakdown of the European Union’s territory for producing regional statistics that are comparable across the Union. The NUTS area classification in the UK comprises current national administrative and electoral areas, except in Scotland where some NUTS areas comprise whole and/or part Local Enterprise Regions.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/nomenclature-of-units-for-territorial-statistics?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to 2005 Statistical Wards API

"Statistical" wards were those electoral wards promulgated in Statutory Instruments by the end of a calendar year and implemented for statistical purposes on 1 April in the following year, irrespective of the year of statutory operation. The policy on statistical wards was agreed by ministers and was originally intended to minimise the impact on statistics of the frequent changes to the electoral ward boundaries. However, in 2006 a change to the policy on statistical wards was agreed by the then NSGG (the National Statistics Geography Group). The 1 April implementation date is retained but it now relates to those administrative and electoral areas that are statutorily operative on 31 December of the previous calendar year (i.e. statutory wards). As such, statistical wards no longer exist – the last set produced was 2005 statistical wards. The administrative and electoral areas in England and Wales for each postcode, used for statistical analysis. A pseudo code is included for Scotland, Northern Ireland, Channel Islands and Isle of Man. The field will be blank for postcodes in England or Wales with no grid reference.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/2005-statistical-wards?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to 2001 National UK Census Output Area Classification names API.

The 2001 Census OAs were built from unit postcodes and constrained to 2003 ‘statistical’ wards, and they form the building bricks for defining higher level geographies. Pseudo codes are included for Channel Islands and Isle of Man. The field will otherwise be blank for postcodes with no grid reference. Includes OAC01, Supergroup, Group and Subgroup.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/2001-national-uk-census-output-area?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to 2001 Census Area Statistics (CAS) Wards API.

In processing 2001 Census data for publication, 18 2003 statistical wards were identified as sub- threshold i.e. the count of population and households fell below the threshold for creating OAs and for the non-disclosive release of Census data. These 18 sub-threshold wards were combined with seven "receiving" wards to form acceptably sized OAs and permit publication of data. The sub- threshold wards are not separately identified in the ONSPD and postcodes in these statistical wards have been assigned to their receiving ward. The resulting set of wards is known as CAS wards. Sub-threshold wards (those below the threshold for creating OAs and for the non- disclosive release of Census data) are not separately identified in this field and postcodes in these "statistical wards" have been assigned to their "receiving ward". The resulting set of wards is known as "CAS Wards". A pseudo code is included for Channel Island and Isle of Man. The field will otherwise be blank for postcodes with no grid reference.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/2001-census-area-statistics?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


Postcode to National Park API

National parks are designed to conserve the natural beauty and cultural heritage of areas of outstanding landscape value, and to promote public understanding and enjoyment of these areas. There are currently 13 national parks in England and Wales. Of these, 10 were designated in the 1950s following the National Parks and Access to the Countryside Act 1949, The Broads (Norfolk/Suffolk) has had a similar status since 1989 (the Broads has its own special authority, the Broads Authority, which is similar to the National Park Authorities but with extra powers in relation to navigation) and The New Forest was given national park status in 2005. The South Downs is the latest national park, becoming fully operational on 1 April 2011. In Scotland the National Parks (Scotland) Act was passed in July 2000. The first Scottish national park, Loch Lomond and the Trossachs, was established in July 2002, and the Cairngorms National Park was established in March 2003. Their boundaries are not constrained by any other geography. The national parks cover parts of England, Wales and Scotland. Pseudo codes are included for Northern Ireland, Channel Islands and Isle of Man. The field will otherwise be blank for postcodes with no grid reference.

Endpoint

GET: https://addressesandpostcodes.co.uk/api/v3/postcodes/{postcode}/national-park?key=your-api-key

Request

Parameter Type Required Description
postcode URL Part Yes Postcode of the current to lookup

Example: AB10 1AB or ab101ab

Try this API

You must be logged in to use our test tool. Click here to login.

Response


How up-to-date is our address data?

Our data is very up-to-date. Our address data is regularly updated from various sources, including Royal Mail's Postcode Address File database, and is enhanced with real-time corrections from address owners/occupiers submitted through our site (no other API service offers this additional feature).

How do I use this service?

Just register a free account and purchase an API credits pack, upon which we will assign you a dedicated API key in order to use our API lookup service.

What is an API lookup?

A lookup is a search of a full UK postcode against our entire address database.

How much are the credits?

Lookup credits are one flat low rate of 2.5p each. It's that simple.

Do the lookup credits expire?

All credits in a pack expire one calendar year after purchase. Upon this expiry, they are considered lost and non-refundable.

Do we deduct a credit if the lookup doesn't produce any data?

If your lookup fails to get a list of addresses for any reason (e.g. an invalid UK postcode was searched), no credits will be deducted.

Is the API completely documented?

Not yet but we are working to hard to complete it. Over time we will complete the documentation and expose our hundreds of endpoints.

Is there a rate limit?

Currently there is not rate limit to paying customers. We reserve the right to change this at any time.

Where is the API hosted?

All our data is stored in London using an industry leading cloud provider.

Why do different endpoints return data in different formats?

The API has been designed and built over many years with best practices at the time being applied. We are working very hard to standardise the end-points. V3 of our API is our LTS release.

The endpoint is returning a generic error message?

Please let us know if any of our API endpoints are not returning useful error messages and we will work with you to fix your API query.

Is there any technical support?

Yes. While our service is designed to be self-service and fully automated, we offer support for any technical enquiry. Simply get in touch with us and we will get back to you within one business day (in most cases, within a couple of hours).

What is your service uptime?

We guarantee availability of at least 99.9% from our high-performance multi-core cloud servers.