# Food Hygiene Ratings API

> Search UK food businesses and read hygiene ratings, business details, and local authority lists from the Food Standards Agency Food Hygiene Rating Scheme.

Each POST has a fixed USDC price on Base, paid with the x402 exact scheme. The request is validated first, and payment settles only after a successful (2xx) result. Failed calls are not charged.

1. POST JSON matching the requestBody. Invalid input returns 400 with no payment challenge.
2. A valid unpaid call returns 402 with the exact amount and payTo.
3. Pay and retry with payment-signature. Payment settles only if the operation returns 2xx. A 4xx/5xx is not charged.

- Product: https://www.brainiac.software/api/food-safety
- Docs: https://www.brainiac.software/api/food-safety/docs
- OpenAPI: https://www.brainiac.software/api/food-safety/openapi.json
- Contact: support@brainiac.software (https://www.brainiac.software/contact)

## Operations

### POST /api/v1/food-safety/search

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

Inputs: query, ratingValue?, businessTypeId?, localAuthorityId?, postcode?, latitude?, longitude?, maxDistance?, limit?, page?

Docs: https://www.brainiac.software/api/food-safety/docs#food-safety-search

Example request:

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

Example response:

```json
undefined
```

### POST /api/v1/food-safety/business

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

Inputs: fsaId

Docs: https://www.brainiac.software/api/food-safety/docs#food-safety-business

Example request:

```json
{
  "fsaId": 1216146
}
```

Example response:

```json
undefined
```

### POST /api/v1/food-safety/batch

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

Inputs: fsaIds

Docs: https://www.brainiac.software/api/food-safety/docs#food-safety-batch

Example request:

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

Example response:

```json
undefined
```

### POST /api/v1/food-safety/ratings

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

Inputs: schemeType?

Docs: https://www.brainiac.software/api/food-safety/docs#food-safety-ratings

Example request:

```json
{
  "schemeType": "FHRS"
}
```

Example response:

```json
undefined
```

### POST /api/v1/food-safety/authorities

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

Inputs: regionName?, limit?, page?

Docs: https://www.brainiac.software/api/food-safety/docs#food-safety-authorities

Example request:

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

Example response:

```json
undefined
```