Skip to content
Eden Engine

UK Food Hygiene Rating of One Premises (Food Standards Agency, by FHRS ID)

fsahygiene/establishment

The current food hygiene record of one UK food business by its FHRS id (the FHRSID from a search): rating, the inspection date behind it (RatingDate), the three component scores (lower is better), business type, address, position and the council responsible. The ratings are 0 to 5 in England, Wales and Northern Ireland and Pass or Improvement Required in Scotland; Exempt and Awaiting Inspection mean no rating, and their RatingDate is often a 1900 or 1901 placeholder. An unknown id is an error, not an empty answer. Ratings change on re-inspection, so always show RatingDate with a rating. Contains public sector information licensed under the Open Government Licence v3.0. Source: Food Standards Agency, Food Hygiene Rating Scheme.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

Food Standards Agency

Food Standards Agency, Food Hygiene Rating Scheme (api.ratings.food.gov.uk). Contains public sector information licensed under the Open Government Licence v3.0. Source: Food Standards Agency, Food Hygiene Rating Scheme. Served by Eden Engine; not an official Food Standards Agency product and not endorsed by the Agency. Ratings change when a business is re-inspected: show the rating date with any rating.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "fsahygiene/establishment" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "fsahygiene/establishment" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "fsahygiene/establishment", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "fsahygiene/establishment", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0026
Updated
Oct 20, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "fhrsid"
  ],
  "properties": {
    "fhrsid": {
      "type": "integer",
      "maximum": 99999999,
      "minimum": 1,
      "description": "The Food Hygiene Rating Scheme id of one premises: FHRSID in any search result, and the number at the end of its page on ratings.food.gov.uk, for example 1824519. An id that is not in the scheme answers HTTP 400 'The request is invalid.', not an empty record."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "FHRSID",
    "BusinessName",
    "RatingValue",
    "RatingDate",
    "SchemeType"
  ],
  "properties": {
    "Phone": {
      "type": "string",
      "description": "Telephone number; empty on every one of 9,251 records sampled, so do not rely on it."
    },
    "FHRSID": {
      "type": "integer",
      "description": "The Food Hygiene Rating Scheme id of the premises: the id the establishment tool takes. Unique across the whole scheme."
    },
    "scores": {
      "type": "object",
      "properties": {
        "Hygiene": {
          "type": [
            "integer",
            "null"
          ]
        },
        "Structural": {
          "type": [
            "integer",
            "null"
          ]
        },
        "ConfidenceInManagement": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "description": "The three inspection component scores behind an FHRS rating. LOWER IS BETTER: 0 is the best score, which is the reverse of the 0 to 5 rating. Hygiene is 0, 5, 10, 15, 20 or 25; Structural 0, 5, 10, 15, 20 or 25; ConfidenceInManagement 0, 5, 10, 20 or 30. All three are null for Scotland (FHIS), for Exempt and Awaiting records, and after a rescore (24 of 6,198 rated premises in a four-authority sample).",
      "additionalProperties": true
    },
    "geocode": {
      "type": "object",
      "properties": {
        "latitude": {
          "type": [
            "string",
            "null"
          ]
        },
        "longitude": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "description": "WGS84 position. longitude and latitude are decimal-degree STRINGS, or null when the premises has no position (about one in five), notably private-address businesses.",
      "additionalProperties": true
    },
    "Distance": {
      "type": [
        "number",
        "null"
      ],
      "description": "Miles from the searched point, only on a nearby search; null on every other call."
    },
    "PostCode": {
      "type": "string",
      "description": "Postcode as the local authority holds it; empty on about one premises in a hundred."
    },
    "RatingKey": {
      "type": "string",
      "description": "Machine key for the rating, for example fhrs_5_en-gb or fhis_pass_en-gb. Every Welsh authority's records end cy-gb instead of en-gb, and Wales spells awaiting inspection fhrs_ratingawaited_cy-gb. It is NOT accepted by the rating filter."
    },
    "RatingDate": {
      "type": "string",
      "description": "Date of the inspection the rating comes from, ISO 8601 with a midnight time and no offset, for example 2026-06-30T00:00:00. For premises with no inspection result the date is often a placeholder, not a date: 1900-01-01 or 1901-01-01 on every England, Wales and Northern Ireland AwaitingInspection and AwaitingPublication record and on most of their Exempt records. Scotland's Awaiting Inspection and Exempt records usually carry a real date."
    },
    "SchemeType": {
      "type": "string",
      "description": "FHRS (England, Wales, Northern Ireland: ratings 0 to 5) or FHIS (Scotland: Pass or Improvement Required)."
    },
    "RatingValue": {
      "type": "string",
      "description": "The rating, a STRING. England, Wales and Northern Ireland (FHRS): 0 to 5 where 5 is best, or Exempt, AwaitingInspection, AwaitingPublication. Scotland (FHIS): Pass, Improvement Required, Pass and Eat Safe, Awaiting Inspection, Exempt. Only 0 to 5, Pass, Improvement Required and Pass and Eat Safe are inspection results; the other values mean no rating exists yet or none is required."
    },
    "AddressLine1": {
      "type": "string",
      "description": "First address line. Empty on about half of premises: the address is spread over four lines with no fixed meaning, so join the non-empty lines with PostCode."
    },
    "AddressLine2": {
      "type": "string",
      "description": "Second address line, often empty."
    },
    "AddressLine3": {
      "type": "string",
      "description": "Third address line, often the town."
    },
    "AddressLine4": {
      "type": "string",
      "description": "Fourth address line, often the county, often empty."
    },
    "BusinessName": {
      "type": "string",
      "description": "Trading name as the local authority holds it, often in capitals and sometimes with a trading-as suffix."
    },
    "BusinessType": {
      "type": "string",
      "description": "Business type label, for example Restaurant/Cafe/Canteen. Scotland labels some types differently from England, Wales and Northern Ireland."
    },
    "RightToReply": {
      "type": "string",
      "description": "The business's published reply to its rating; empty on nearly every record."
    },
    "BusinessTypeID": {
      "type": "integer",
      "description": "Business type id; 1 is Restaurant/Cafe/Canteen, 7844 Takeaway/sandwich shop, 7843 Pub/bar/nightclub."
    },
    "NewRatingPending": {
      "type": "boolean",
      "description": "True when a re-inspection has been carried out and its new rating is not yet published; the rating shown is the previous one."
    },
    "ChangesByServerID": {
      "type": "integer",
      "description": "Internal change counter; ignore."
    },
    "LocalAuthorityCode": {
      "type": "string",
      "description": "The authority's code, a string. It is NOT the id the local_authority_id filter takes: use LocalAuthorityId from the local-authorities tool."
    },
    "LocalAuthorityName": {
      "type": "string",
      "description": "The council responsible for the premises."
    },
    "LocalAuthorityWebSite": {
      "type": "string",
      "description": "The council's website."
    },
    "LocalAuthorityBusinessID": {
      "type": "string",
      "description": "The council's own id for the premises; unique only within that council."
    },
    "LocalAuthorityEmailAddress": {
      "type": "string",
      "description": "The council's food safety contact address."
    }
  },
  "description": "One establishment, unwrapped: the FSA's single-premises response has no establishments array and no meta block.",
  "additionalProperties": true
}