Food Hygiene Ratings API Documentation

POSThttps://www.brainiac.software/api/v1/food-safety/search$0.05 USDC

Search food businesses

Search UK food businesses by name, location, postcode, or hygiene rating using the Food Standards Agency Food Hygiene Rating Scheme API.

Body

Field	Required	Notes
`query`	Yes	string
`ratingValue`	No	string
`businessTypeId`	No	integer
`localAuthorityId`	No	string
`postcode`	No	string
`latitude`	No	number
`longitude`	No	number
`maxDistance`	No	number
`limit`	No	integer; Default: 20
`page`	No	integer; Default: 1

Request exampleJSON

{
  "query": "Tesco",
  "postcode": "PE13",
  "ratingValue": "5",
  "limit": 20
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/food-safety/search" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "query": "Tesco",
  "postcode": "PE13",
  "ratingValue": "5",
  "limit": 20
}
JSON

POSThttps://www.brainiac.software/api/v1/food-safety/business$0.03 USDC

Get food business details

Retrieve detailed information for a specific food business by its FSA FHRSID from the Food Standards Agency Food Hygiene Rating Scheme API.

Body

Field	Required	Notes
`fsaId`	Yes	integer

Request exampleJSON

{
  "fsaId": 1216146
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/food-safety/business" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "fsaId": 1216146
}
JSON

POSThttps://www.brainiac.software/api/v1/food-safety/batch$0.15 USDC

Batch lookup food businesses

Retrieve details for multiple food businesses in a single batch request using the Food Standards Agency Food Hygiene Rating Scheme API.

Body

Field	Required	Notes
`fsaIds`	Yes	array; Array

Request exampleJSON

{
  "fsaIds": [
    1216146,
    246490,
    321016
  ]
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/food-safety/batch" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "fsaIds": [
    1216146,
    246490,
    321016
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/food-safety/ratings$0.01 USDC

Get food safety ratings

Retrieve the list of available hygiene rating values and their descriptions from the Food Standards Agency Food Hygiene Rating Scheme API.

Body

Field	Required	Notes
`schemeType`	No	string

Request exampleJSON

{
  "schemeType": "FHRS"
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/food-safety/ratings" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "schemeType": "FHRS"
}
JSON

POSThttps://www.brainiac.software/api/v1/food-safety/authorities$0.02 USDC

Get food safety authorities

Retrieve the list of local authorities and their establishment counts from the Food Standards Agency Food Hygiene Rating Scheme API.

Body

Field	Required	Notes
`regionName`	No	string
`limit`	No	integer; Default: 50
`page`	No	integer; Default: 1

Request exampleJSON

{
  "regionName": "England",
  "limit": 50
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/food-safety/authorities" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "regionName": "England",
  "limit": 50
}
JSON