API Endpoints

Dining and Shopping

Takeaways

Tokens
× 1

API Credit Cost


Endpoint Overview

e Takeaways endpoint provides a list of takeaway food establishments within a postcode radius, including their names, cuisine types, and locations.


Coverage

EnglandEngland
ScotlandScotland
WalesWales
N. IrelandN. Ireland

Update Frequency

Bi-Annually

Request Format

HTTP Method:

GET

To use the API you should send an HTTP request to the following endpoint URL. This will return a JSON response.

https://api.postcodearea.co.uk/takeaways/?key=&postcode={postcode}

Note that your key has automatically been added to the API endpoint for convenience.

Querystring Parameters:

{postcode}

A valid UK postcode (e.g., SW1A 1AA). Note that you can send the postcode with or without the space separating the outward and inward codes. For example, both "SW1A 1AA" and "SW1A1AA" are both valid.

{api_key}

A valid API key that authenticates your account.


Authorisation

For every endpoint request your API Key should be sent as part of the querystring:

https://api.postcodearea.co.uk/takeaways/?key={api_key}&postcode=WS3+3PD

For example:

https://api.postcodearea.co.uk/takeaways/?key=&postcode=WS3+3PD

Example Request and Response

If the above URL endpoint exists and the API key is valid, our system will return the following example response:

https://api.postcodearea.co.uk/takeaways/?key=&postcode=WS3+3PD
{"data":[{"Takeaway Name":"Jia Jin Takeaway","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"32 High Street","Address 3":"Gnosall","Address 4":"Stafford","Postcode":"ST20 0EX","Overall Rating":"5","Scheme":"FHRS","Hygiene":"0","Structural":"5","Confidence in Management":"0","Local Authority":"Stafford","Local Authority Business ID":"5","FHRS ID":"1195687","Latitude":"52.7850068","Longitude":"-2.2545196","Distance":0.33},{"Takeaway Name":"Gnosall Kitchen Takeaway","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"1 Station Road","Address 3":"Gnosall","Address 4":"Stafford","Postcode":"ST20 0EZ","Overall Rating":"3","Scheme":"FHRS","Hygiene":"10","Structural":"10","Confidence in Management":"5","Local Authority":"Stafford","Local Authority Business ID":"64748","FHRS ID":"1195800","Latitude":"52.7831499","Longitude":"-2.2555003","Distance":0.43},{"Takeaway Name":"Gnosall Fish Bar","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"Newport Road","Address 3":"Gnosall","Address 4":"Stafford","Postcode":"ST20 0BL","Overall Rating":"4","Scheme":"FHRS","Hygiene":"0","Structural":"0","Confidence in Management":"10","Local Authority":"Stafford","Local Authority Business ID":"151","FHRS ID":"1195431","Latitude":"52.78160095","Longitude":"-2.261214018","Distance":0.69},{"Takeaway Name":"Haughton Fish & Chips","Restaurant Type":"Takeaway/sandwich shop","Address 1":"Shopping Centre","Address 2":"4 Newport Road","Address 3":"Haughton","Address 4":"Stafford","Postcode":"ST18 9EZ","Overall Rating":"AwaitingInspection","Scheme":"FHRS","Hygiene":"","Structural":"","Confidence in Management":"","Local Authority":"Stafford","Local Authority Business ID":"118235","FHRS ID":"1368670","Latitude":"52.78205109","Longitude":"-2.202924013","Distance":1.9},{"Takeaway Name":"King Cod","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"1 Cape Avenue","Address 3":"Western Downs","Address 4":"Stafford","Postcode":"ST17 9FL","Overall Rating":"4","Scheme":"FHRS","Hygiene":"5","Structural":"10","Confidence in Management":"5","Local Authority":"Stafford","Local Authority Business ID":"92689","FHRS ID":"1196086","Latitude":"52.78858948","Longitude":"-2.136743069","Distance":4.64},{"Takeaway Name":"Marco's Pizza","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"211 Doxey","Address 3":"Stafford","Address 4":"Staffordshire","Postcode":"ST16 1EG","Overall Rating":"3","Scheme":"FHRS","Hygiene":"10","Structural":"10","Confidence in Management":"10","Local Authority":"Stafford","Local Authority Business ID":"116473","FHRS ID":"1195324","Latitude":"52.8110472","Longitude":"-2.1412204","Distance":4.74},{"Takeaway Name":"Doxey Fish Bar","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"211 Doxey","Address 3":"Stafford","Address 4":"Staffordshire","Postcode":"ST16 1EG","Overall Rating":"AwaitingInspection","Scheme":"FHRS","Hygiene":"","Structural":"","Confidence in Management":"","Local Authority":"Stafford","Local Authority Business ID":"118246","FHRS ID":"1368675","Latitude":"52.8110472","Longitude":"-2.1412204","Distance":4.74},{"Takeaway Name":"Highfields Fish Bar","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"160 West Way","Address 3":"Highfields","Address 4":"Stafford","Postcode":"ST17 9YF","Overall Rating":"4","Scheme":"FHRS","Hygiene":"10","Structural":"5","Confidence in Management":"0","Local Authority":"Stafford","Local Authority Business ID":"286","FHRS ID":"1195538","Latitude":"52.7948317","Longitude":"-2.1321655","Distance":4.85},{"Takeaway Name":"Oriental Tree","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"156 West Way","Address 3":"Highfields","Address 4":"Stafford","Postcode":"ST17 9YF","Overall Rating":"5","Scheme":"FHRS","Hygiene":"5","Structural":"5","Confidence in Management":"5","Local Authority":"Stafford","Local Authority Business ID":"92302","FHRS ID":"1196081","Latitude":"52.7947958","Longitude":"-2.132106","Distance":4.86},{"Takeaway Name":"Tandoori Kitchen","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"7 Small Lane","Address 3":"Eccleshall","Address 4":"Stafford","Postcode":"ST21 6AD","Overall Rating":"4","Scheme":"FHRS","Hygiene":"0","Structural":"10","Confidence in Management":"5","Local Authority":"Stafford","Local Authority Business ID":"408","FHRS ID":"1195629","Latitude":"52.8586047","Longitude":"-2.2527213","Distance":4.94},{"Takeaway Name":"The Great Wall","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"22 Stafford Street","Address 3":"Eccleshall","Address 4":"Stafford","Postcode":"ST21 6BH","Overall Rating":"AwaitingInspection","Scheme":"FHRS","Hygiene":"","Structural":"","Confidence in Management":"","Local Authority":"Stafford","Local Authority Business ID":"338","FHRS ID":"1195576","Latitude":"52.8587868","Longitude":"-2.2516084","Distance":4.95},{"Takeaway Name":"Eccleshall Fish & Chip Shop","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"5 Stafford Street","Address 3":"Eccleshall","Address 4":"Stafford","Postcode":"ST21 6BL","Overall Rating":"5","Scheme":"FHRS","Hygiene":"5","Structural":"5","Confidence in Management":"0","Local Authority":"Stafford","Local Authority Business ID":"215","FHRS ID":"1195490","Latitude":"52.8595066","Longitude":"-2.2513155","Distance":5},{"Takeaway Name":"Star Pizza","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"30a High Street","Address 3":"Eccleshall","Address 4":"Stafford","Postcode":"ST21 6BZ","Overall Rating":"5","Scheme":"FHRS","Hygiene":"5","Structural":"0","Confidence in Management":"5","Local Authority":"Stafford","Local Authority Business ID":"27","FHRS ID":"1195529","Latitude":"52.8597082","Longitude":"-2.2537228","Distance":5.02},{"Takeaway Name":"Chris' Fish Bar","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"8 Burton Square","Address 3":"Rising Brook","Address 4":"Stafford","Postcode":"ST17 9LT","Overall Rating":"4","Scheme":"FHRS","Hygiene":"10","Structural":"5","Confidence in Management":"5","Local Authority":"Stafford","Local Authority Business ID":"685","FHRS ID":"1195827","Latitude":"52.78753662","Longitude":"-2.118961096","Distance":5.38},{"Takeaway Name":"Windmill Fish Bar","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"8 Castle Hill","Address 3":"Stafford","Address 4":"Staffordshire","Postcode":"ST16 2QB","Overall Rating":"3","Scheme":"FHRS","Hygiene":"5","Structural":"10","Confidence in Management":"10","Local Authority":"Stafford","Local Authority Business ID":"721","FHRS ID":"1195859","Latitude":"52.8069506","Longitude":"-2.1229011","Distance":5.39},{"Takeaway Name":"Momotaj Spice","Restaurant Type":"Takeaway/sandwich shop","Address 1":"36 High Street","Address 2":"Wheaton Aston","Address 3":"South Staffordshire","Address 4":"","Postcode":"ST19 9NP","Overall Rating":"4","Scheme":"FHRS","Hygiene":"10","Structural":"5","Confidence in Management":"5","Local Authority":"South Staffordshire","Local Authority Business ID":"LS-40A/4","FHRS ID":"1258261","Latitude":"52.7104913","Longitude":"-2.2222443","Distance":5.41},{"Takeaway Name":"Jones Fish And Chip Shop","Restaurant Type":"Takeaway/sandwich shop","Address 1":"43A Audley Road","Address 2":"Newport","Address 3":"Shropshire","Address 4":"","Postcode":"TF10 7DL","Overall Rating":"4","Scheme":"FHRS","Hygiene":"0","Structural":"10","Confidence in Management":"5","Local Authority":"Telford and Wrekin Council","Local Authority Business ID":"00970/0043/A/000","FHRS ID":"249732","Latitude":"52.769156","Longitude":"-2.374036","Distance":5.43},{"Takeaway Name":"Britannia Fish Bar","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"109 First Avenue","Address 3":"Trinity Fields","Address 4":"Stafford","Postcode":"ST16 1QE","Overall Rating":"5","Scheme":"FHRS","Hygiene":"5","Structural":"5","Confidence in Management":"5","Local Authority":"Stafford","Local Authority Business ID":"95814","FHRS ID":"1196137","Latitude":"52.8276234","Longitude":"-2.1338387","Distance":5.51},{"Takeaway Name":"Golden Chef","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"107 First Avenue","Address 3":"Trinity Fields","Address 4":"Stafford","Postcode":"ST16 1QE","Overall Rating":"4","Scheme":"FHRS","Hygiene":"10","Structural":"0","Confidence in Management":"0","Local Authority":"Stafford","Local Authority Business ID":"114318","FHRS ID":"1195235","Latitude":"52.8275785","Longitude":"-2.1337792","Distance":5.51},{"Takeaway Name":"Szechuan House","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"50 Foregate Street","Address 3":"Stafford","Address 4":"Staffordshire","Postcode":"ST16 2PJ","Overall Rating":"3","Scheme":"FHRS","Hygiene":"10","Structural":"10","Confidence in Management":"5","Local Authority":"Stafford","Local Authority Business ID":"85846","FHRS ID":"1195992","Latitude":"52.812624","Longitude":"-2.121938","Distance":5.54},{"Takeaway Name":"The Fryer","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"52 Foregate Street","Address 3":"Stafford","Address 4":"Staffordshire","Postcode":"ST16 2PJ","Overall Rating":"4","Scheme":"FHRS","Hygiene":"5","Structural":"10","Confidence in Management":"5","Local Authority":"Stafford","Local Authority Business ID":"99620","FHRS ID":"1196197","Latitude":"52.812606","Longitude":"-2.1219083","Distance":5.54},{"Takeaway Name":"Caprinos Pizza","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"52 Foregate Street","Address 3":"Stafford","Address 4":"Staffordshire","Postcode":"ST16 2PJ","Overall Rating":"3","Scheme":"FHRS","Hygiene":"10","Structural":"5","Confidence in Management":"10","Local Authority":"Stafford","Local Authority Business ID":"117302","FHRS ID":"1210679","Latitude":"52.812606","Longitude":"-2.1219083","Distance":5.54},{"Takeaway Name":"Star Pizza Kebab","Restaurant Type":"Takeaway/sandwich shop","Address 1":"8 Stafford Street","Address 2":"Newport","Address 3":"Shropshire","Address 4":"","Postcode":"TF10 7LT","Overall Rating":"5","Scheme":"FHRS","Hygiene":"","Structural":"","Confidence in Management":"","Local Authority":"Telford and Wrekin Council","Local Authority Business ID":"13/00013/COMM","FHRS ID":"511265","Latitude":"52.769092","Longitude":"-2.377119","Distance":5.56},{"Takeaway Name":"Bamboo Garden","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"61 Foregate Street","Address 3":"Stafford","Address 4":"Staffordshire","Postcode":"ST16 2PT","Overall Rating":"5","Scheme":"FHRS","Hygiene":"5","Structural":"5","Confidence in Management":"5","Local Authority":"Stafford","Local Authority Business ID":"903","FHRS ID":"1196067","Latitude":"52.8114567","Longitude":"-2.1206143","Distance":5.56},{"Takeaway Name":"Roosters Chicken and Grill","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"2 Stone Road","Address 3":"Stafford","Address 4":"Staffordshire","Postcode":"ST16 2RQ","Overall Rating":"3","Scheme":"FHRS","Hygiene":"10","Structural":"5","Confidence in Management":"10","Local Authority":"Stafford","Local Authority Business ID":"112380","FHRS ID":"1195181","Latitude":"52.814736","Longitude":"-2.1224188","Distance":5.57},{"Takeaway Name":"Golden Gate","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"10 Stone Road","Address 3":"Stafford","Address 4":"Staffordshire","Postcode":"ST16 2RQ","Overall Rating":"3","Scheme":"FHRS","Hygiene":"10","Structural":"10","Confidence in Management":"10","Local Authority":"Stafford","Local Authority Business ID":"707","FHRS ID":"1195847","Latitude":"52.8148977","Longitude":"-2.1224637","Distance":5.57},{"Takeaway Name":"Tiger Bowl Takeaway","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"12 Stone Road","Address 3":"Stafford","Address 4":"Staffordshire","Postcode":"ST16 2RQ","Overall Rating":"4","Scheme":"FHRS","Hygiene":"5","Structural":"10","Confidence in Management":"5","Local Authority":"Stafford","Local Authority Business ID":"102","FHRS ID":"1195004","Latitude":"52.8149517","Longitude":"-2.1224787","Distance":5.57},{"Takeaway Name":"Subway","Restaurant Type":"Takeaway/sandwich shop","Address 1":"40 High Street","Address 2":"Newport","Address 3":"Shropshire","Address 4":"","Postcode":"TF10 7AQ","Overall Rating":"5","Scheme":"FHRS","Hygiene":"0","Structural":"0","Confidence in Management":"0","Local Authority":"Telford and Wrekin Council","Local Authority Business ID":"17/00187/COMM","FHRS ID":"1008003","Latitude":"52.768228","Longitude":"-2.377452","Distance":5.58},{"Takeaway Name":"Peking House","Restaurant Type":"Takeaway/sandwich shop","Address 1":"8 Baddeley Court","Address 2":"Newport","Address 3":"Shropshire","Address 4":"","Postcode":"TF10 7AD","Overall Rating":"3","Scheme":"FHRS","Hygiene":"10","Structural":"10","Confidence in Management":"10","Local Authority":"Telford and Wrekin Council","Local Authority Business ID":"01070/0008/0/000","FHRS ID":"249770","Latitude":"52.767357","Longitude":"-2.377119","Distance":5.58},{"Takeaway Name":"Spice Island","Restaurant Type":"Takeaway/sandwich shop","Address 1":"7 Baddeley Court","Address 2":"Newport","Address 3":"Shropshire","Address 4":"","Postcode":"TF10 7AD","Overall Rating":"3","Scheme":"FHRS","Hygiene":"10","Structural":"10","Confidence in Management":"10","Local Authority":"Telford and Wrekin Council","Local Authority Business ID":"01070/0007/0/000","FHRS ID":"249914","Latitude":"52.767357","Longitude":"-2.377119","Distance":5.58},{"Takeaway Name":"Northern Lights","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"178 Stone Road","Address 3":"Stafford","Address 4":"Staffordshire","Postcode":"ST16 1NT","Overall Rating":"5","Scheme":"FHRS","Hygiene":"0","Structural":"5","Confidence in Management":"5","Local Authority":"Stafford","Local Authority Business ID":"33","FHRS ID":"1195569","Latitude":"52.8221299","Longitude":"-2.1266096","Distance":5.6},{"Takeaway Name":"Subway","Restaurant Type":"Takeaway/sandwich shop","Address 1":"Unit 1","Address 2":"70a Stone Road","Address 3":"Stafford","Address 4":"Staffordshire","Postcode":"ST16 2RS","Overall Rating":"5","Scheme":"FHRS","Hygiene":"0","Structural":"5","Confidence in Management":"5","Local Authority":"Stafford","Local Authority Business ID":"107511","FHRS ID":"1195086","Latitude":"52.8171678","Longitude":"-2.1226576","Distance":5.62},{"Takeaway Name":"Papa Johns","Restaurant Type":"Takeaway/sandwich shop","Address 1":"Unit 4","Address 2":"70d Stone Road","Address 3":"Stafford","Address 4":"Staffordshire","Postcode":"ST16 2RS","Overall Rating":"4","Scheme":"FHRS","Hygiene":"0","Structural":"10","Confidence in Management":"10","Local Authority":"Stafford","Local Authority Business ID":"107604","FHRS ID":"1195088","Latitude":"52.8174353","Longitude":"-2.1227761","Distance":5.62},{"Takeaway Name":"Atlas Kebab House Ltd","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"1a-1b Marston Road","Address 3":"Stafford","Address 4":"Staffordshire","Postcode":"ST16 3BS","Overall Rating":"3","Scheme":"FHRS","Hygiene":"10","Structural":"10","Confidence in Management":"10","Local Authority":"Stafford","Local Authority Business ID":"281","FHRS ID":"1195534","Latitude":"52.8134629","Longitude":"-2.1190769","Distance":5.67},{"Takeaway Name":"Spices of Stafford","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"157 Marston Road","Address 3":"Stafford","Address 4":"Staffordshire","Postcode":"ST16 3BS","Overall Rating":"4","Scheme":"FHRS","Hygiene":"5","Structural":"10","Confidence in Management":"5","Local Authority":"Stafford","Local Authority Business ID":"115461","FHRS ID":"1195263","Latitude":"52.8146677","Longitude":"-2.118917","Distance":5.7},{"Takeaway Name":"Happy Meeting","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"56 Marston Road","Address 3":"Stafford","Address 4":"Staffordshire","Postcode":"ST16 3BX","Overall Rating":"3","Scheme":"FHRS","Hygiene":"10","Structural":"10","Confidence in Management":"10","Local Authority":"Stafford","Local Authority Business ID":"47302","FHRS ID":"1195674","Latitude":"52.8181379","Longitude":"-2.1186297","Distance":5.8},{"Takeaway Name":"Mandarin House","Restaurant Type":"Takeaway/sandwich shop","Address 1":"5 Parkside Shopping Precinct","Address 2":"Parkside Avenue","Address 3":"Parkside","Address 4":"Stafford","Postcode":"ST16 1TQ","Overall Rating":"4","Scheme":"FHRS","Hygiene":"10","Structural":"5","Confidence in Management":"5","Local Authority":"Stafford","Local Authority Business ID":"289","FHRS ID":"1195541","Latitude":"52.8296652","Longitude":"-2.1245537","Distance":5.92},{"Takeaway Name":"Direct Pizza","Restaurant Type":"Takeaway/sandwich shop","Address 1":"8 Parkside Shopping Precinct","Address 2":"Parkside Avenue","Address 3":"Parkside","Address 4":"Stafford","Postcode":"ST16 1TQ","Overall Rating":"3","Scheme":"FHRS","Hygiene":"5","Structural":"10","Confidence in Management":"10","Local Authority":"Stafford","Local Authority Business ID":"88813","FHRS ID":"1196040","Latitude":"52.8297016","Longitude":"-2.1242125","Distance":5.93},{"Takeaway Name":"JSK Food Services (Subway)","Restaurant Type":"Takeaway/sandwich shop","Address 1":"Unit 10","Address 2":"Penkridge Retail Park","Address 3":"Wolverhampton Road","Address 4":"Penkridge","Postcode":"ST19 5NS","Overall Rating":"5","Scheme":"FHRS","Hygiene":"0","Structural":"5","Confidence in Management":"0","Local Authority":"South Staffordshire","Local Authority Business ID":"PE-254","FHRS ID":"1258343","Latitude":"52.7169161","Longitude":"-2.1184126","Distance":7.27},{"Takeaway Name":"Greggs","Restaurant Type":"Takeaway/sandwich shop","Address 1":"11 Penkridge Retail Park","Address 2":"Wolverhampton Road","Address 3":"Penkridge","Address 4":"South Staffordshire","Postcode":"ST19 5NS","Overall Rating":"5","Scheme":"FHRS","Hygiene":"0","Structural":"0","Confidence in Management":"0","Local Authority":"South Staffordshire","Local Authority Business ID":"PE-253","FHRS ID":"1258342","Latitude":"52.7169161","Longitude":"-2.1184126","Distance":7.27},{"Takeaway Name":"Flaming Grill","Restaurant Type":"Takeaway/sandwich shop","Address 1":"3 Penkridge Retail Park","Address 2":"Wolverhampton Road","Address 3":"Penkridge","Address 4":"South Staffordshire","Postcode":"ST19 5NS","Overall Rating":"3","Scheme":"FHRS","Hygiene":"5","Structural":"10","Confidence in Management":"10","Local Authority":"South Staffordshire","Local Authority Business ID":"PE-165C/1","FHRS ID":"1258309","Latitude":"52.7169161","Longitude":"-2.1184126","Distance":7.27},{"Takeaway Name":"Oysters Fish Bar","Restaurant Type":"Takeaway/sandwich shop","Address 1":"4 Boscomoor Shopping Centre","Address 2":"Wolverhampton Road","Address 3":"Penkridge","Address 4":"South Staffordshire","Postcode":"ST19 5NS","Overall Rating":"5","Scheme":"FHRS","Hygiene":"5","Structural":"0","Confidence in Management":"5","Local Authority":"South Staffordshire","Local Authority Business ID":"PE-165D","FHRS ID":"1258310","Latitude":"52.71699905","Longitude":"-2.117954016","Distance":7.28},{"Takeaway Name":"M.S Hot & Cold Food","Restaurant Type":"Takeaway/sandwich shop","Address 1":"","Address 2":"Diamond Way","Address 3":"Stone","Address 4":"Staffordshire","Postcode":"ST15 0SD","Overall Rating":"5","Scheme":"FHRS","Hygiene":"5","Structural":"0","Confidence in Management":"5","Local Authority":"Stafford","Local Authority Business ID":"117102","FHRS ID":"1195399","Latitude":"52.88706207","Longitude":"-2.139626026","Distance":8.24}],"response_time":0.0781,"Source":"PostcodeArea API","Output Area":"Radius","Radius":10,"Distance Unit":"Mile","Records":43,"Unique Fields":18,"Referrer":"api.postcodearea.co.uk","Host":"https://api.postcodearea.co.uk/takeaways/?key=pa_XWQAV24RXCUU19NGUFM11TKTLN&postcode=st200ly","Endpoint":"/takeaways/?key=pa_XWQAV24RXCUU19NGUFM11TKTLN&postcode=st200ly"}

Error Handling

HTTP Status Code Error Message Reason
400 Invalid postcode format The postcode provided is not valid.
401 Unauthorised request API key missing or invalid.
404 Postcode not found No data available for the given postcode.
404 No Results Found No data available for the given radius.
429 Too many requests Exceeded rate limit.
500 Internal server error An unexpected issue occurred.

Caching Policy

You may temporarily cache data retrieved from the API for performance optimisation purposes, provided that the cached data is:

  1. Stored in-memory only (e.g., application-level cache).
  2. Retained for no longer than one hour.

Caching API data to any persistent storage, including but not limited to databases, files, or external systems, constitutes a breach of our API Terms and Conditions. Such actions are strictly prohibited to ensure data accuracy and compliance with our licensing agreements.

If you have specific requirements for extended caching, you must seek prior written consent from us.


Get started today

Ready to use this data for your own business or organisation? Sign up today and get immediate access to all the PostcodeArea API endpoints.

Share this page