=== FOOD STANDARDS AGENCY === 

UK FOOD HYGIENE RATING IMAGES AND DATA APPLICATION PROGRAMMING INTERFACE (API)
https://www.food.gov.uk/ratings
https://www.food.gov.uk/hygiene-rating-open-data



=== CONTENTS === 

1. GUIDANCE ON USING THE IMAGES WITH THE API RATING VALUES AND KEYS
2. TERMS AND CONDITIONS (ENGLISH)




=== 1. GUIDANCE ON USING THE IMAGES WITH THE API RATING VALUES AND KEYS === 

Rating values and keys

The rating value is the result of an inspection for a business. These are different between scheme types. The FHIS uses status messages only, while FHRS uses either a rating (between 0 and 5) or a status. See below for a complete list.

The rating key can be used by developers to decide which rating image to show within their application. The keys correspond to images available on the FSA website (https://ratings.food.gov.uk/open-data-resources/images/images.zip). Images have been made available in three sizes and should not be modified in any way. Images supplied by the FSA must only be used in accordance with the Terms and Conditions below (also at: www.food.gov.uk/ratings-terms-and-conditions).

Supported cultures are English and Welsh (en-GB and cy-GB). Images available are: 

* large:  width 540 pixels
* medium: width 481 pixels 
* small: width 291 pixels

---------------------------------------------------------------
FHRS
---------------------------------------------------------------
Rating Value		Rating Key			Culture
---------------------------------------------------------------
0			fhrs_0_en-gb			en-GB
1			fhrs_1_en-gb			en-GB
2			fhrs_2_en-gb			en-GB
3			fhrs_3_en-gb			en-GB
4			fhrs_4_en-gb			en-GB
5			fhrs_5_en-gb			en-GB
exempt			fhrs_exempt_en-gb		en-GB
awaitingpublication	fhrs_awaitingpublication_en-gb	en-GB
awaitinginspection	fhrs_awaitinginspection_en-gb	en-GB
0			fhrs_0_cy-gb			cy-GB
1			fhrs_1_cy-gb			cy-GB
2			fhrs_2_cy-gb			cy-GB
3			fhrs_3_cy-gb			cy-GB
4			fhrs_4_cy-gb			cy-GB
5			fhrs_5_cy-gb			cy-GB
exempt			fhrs_exempt_cy-gb		cy-GB
awaitingpublication	fhrs_awaitingpublication_cy-gb	cy-GB
awaitinginspection	fhrs_awaitinginspection_cy-gb	cy-GB
awaitinginspection	fhrs_ratingawaited_cy-gb	cy-GB

===============================================================


---------------------------------------------------------------
FHIS
---------------------------------------------------------------
Rating Value		Rating Key			Culture
---------------------------------------------------------------
Pass			fhis_pass			-
Exempt			fhis_exempt			-
Improvement Required	fhis_improvement_required	-
Awaiting Inspection	fhis_awaiting_inspection	-
Awaiting Publication	fhis_awaiting_publication	-
Pass and Eat Safe	fhis_pass_and_eat_safe		-
===============================================================




=== 2. TERMS AND CONDITIONS (ENGLISH)  === 


Terms and conditions for information and services at food.gov.uk/ratings

If you continue to browse and use the information and services (including the food hygiene rating data and application programming interface, API) at food.gov.uk/ratings, you are agreeing to comply with and be bound by the following terms and conditions of use, which together with our privacy policy govern the Food Standards Agency's relationship with you in relation to food.gov.uk/ratings and its services. If you disagree with any part of these terms and conditions, please do not use www.food.gov.uk/ratings or the services it provides.

The use of www.food.gov.uk/ratings and its services is subject to the following terms of use:

1. The use of the branding of the Food Hygiene Rating Scheme (FHRS), which is operated in England, Wales and Northern Ireland, and the branding of the Food Hygiene Information Scheme (FHIS), which is operated in Scotland, should not be seen as or portrayed as Food Standards Agency (FSA) endorsement of any individual food business chain of food businesses, website, smartphone application or other online application. 

2. The images must only be used in accordance with the FHRS 'Brand Standard' and with these terms and conditions. You should read and familiarise yourself with the FHRS Brand Standard (Section 9 gives guidance on using the FHRS branding) [https://smartercommunications.food.gov.uk/connect/lsc9TTpp1s]. 

3. Food business operators and users of FHRS/FHIS images and data should be reminded that displaying an invalid rating or using this in any advertising or publicity material may constitute an offence under trading standards legislation. For example, an offence under the Consumer Protection from Unfair Trading Regulations 2008. The ratings will be subject to change based on the level of compliance when a business receives a visit to review the standard of food hygiene. Users of the information are responsible for ensuring that the information/images used reflect the current rating of the establishment. 

4. The food hygiene rating data is available via an API. This is a free service and there is no need to register before using it. However, it is your responsibility to ensure that you make clear whether the data you are using is either from the live data or static data that is updated daily. Read more about how to access the API [https://www.food.gov.uk/hygiene-rating-open-data].

5. The content of the pages at www.food.gov.uk/ratings is subject to change without notice. 

6. www.food.gov.uk/ratings uses cookies to monitor browsing preferences. If you do allow cookies to be used, personal information may be stored by us for use by third parties. For more information about the cookies used and personal information that may be stored, see our cookies policy [https://www.food.gov.uk/cookie-policy].

7. Neither we nor any third parties provide any warranty or guarantee as to the accuracy, timeliness, performance, completeness or suitability of the information and materials found or offered at www.food.gov.uk/ratings for any particular purpose. You acknowledge that such information and materials may contain inaccuracies or errors and we expressly exclude liability for any such inaccuracies or errors to the fullest extent permitted by law. 

Your use of any information or materials at www.food.gov.uk/ratings is entirely at your own risk, for which we shall not be liable. It shall be your own responsibility to ensure that any services or information available through  www.food.gov.uk/ratings meet the specific requirements and in particular make clear to the user that the food hygiene rating or inspection result given to a business reflects the standards of food hygiene found on the date of inspection or visit by the local authority. 

8. www.food.gov.uk/ratings contains material which is owned by or licensed to us. This material includes, but is not limited to, the design, layout, look, appearance, maps and graphics. Reproduction is prohibited other than in accordance with these terms and conditions and the Crown Copyright notice. Read the Crown Copyright  notice [https://www.food.gov.uk/crown-copyright]. Local authority logos are owned by local authorities and if you want to use a local authority's logo, you will need to ask that local authority for permission. 

9. Unauthorised use of www.food.gov.uk/ratings and its services may give rise to a claim for damages and/or be a criminal offence. 

10. From time to time www.food.gov.uk/ratings may also include links to other websites. These links are provided for your convenience to provide further information. They do not signify that we endorse the website(s). We have no responsibility for the content of the linked website(s). 

11. Your use of www.food.gov.uk/ratings, and its services, and any dispute arising out of such use of food.gov.uk/ratings and its services is subject to the laws of England, Wales, Northern Ireland and Wales.





=== END
