# GET /report/area: $0.10 per call

UK area report for a postcode in one call: local authority, ward and constituency, street crime by category (latest month), house-price statistics (sales at the postcode: median, range, by year), food-hygiene ratings of nearby businesses, and a short AI summary. Official open data (OGL). Statistics only: no addresses of private homes. Pass ?postcode=SW1A1AA.

- **Price:** $0.10 in USDC, the same on Base, Solana, Polygon, Arbitrum. Failed calls are never charged.
- **Free trial:** no, paid only (it uses a paid AI model or data source, or costs more than the trial covers). Other ways to pay: x402 or [prepaid credits](/credits).
- **Tier:** deep
- **Answers cached for:** 1 day(s)
- **Data sources:** postcodes.io, data.police.uk, HM Land Registry, Food Standards Agency (free, OGL); Workers AI (metered)
- **Lane:** Premium reports ([OpenAPI](/openapi/reports.json))
- **Live health:** [status page](/status)

## Free sample

See an answer for the demo input first, free (no payment, 10 a minute): [https://aayatai.com/sample/report-area](/sample/report-area). It is a stored real answer when we have one, otherwise an example marked `"kind": "illustrative"`.

```bash
curl "https://aayatai.com/sample/report-area"
```

## 1. See the price (free)

Call it without paying: you get `402 Payment Required` and a `PAYMENT-REQUIRED` header with the exact price and where to pay.

```bash
curl -i "https://aayatai.com/report/area?postcode=PL6+8RU"
```

## 2. Pay and call (TypeScript)

```bash
npm install @x402/fetch @x402/evm viem
```

```ts
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

// A wallet used only by your agent, holding a little USDC on Base.
const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);
const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const res = await pay("https://aayatai.com/report/area?postcode=PL6+8RU");
console.log(await res.json());
```

## 3. Or as an MCP tool

```ts
// MCP server: https://aayatai.com/mcp (Streamable HTTP). With the x402 MCP client (see /start):
const result = await client.callTool("report-area", {"postcode":"PL6 8RU"});
```

## Inputs

- `postcode` **(required)** (string): Full UK postcode (house prices cover England and Wales).

Bad inputs are rejected with HTTP 400 before any payment is asked for.

## Example answer

```json
{
  "postcode": "PL6 8RU",
  "area": {
    "districts": [
      "Plymouth"
    ],
    "wards": [
      "Moor View"
    ],
    "constituencies": [
      "Plymouth Moor View"
    ],
    "country": [
      "England"
    ]
  },
  "crime": {
    "month": "2026-07",
    "total": 55,
    "top": [
      {
        "category": "violent-crime",
        "count": 27
      }
    ]
  },
  "housePrices": {
    "count": 3,
    "medianPrice": 200000,
    "minPrice": 180000,
    "maxPrice": 250000,
    "latestSale": "2024-05-28"
  },
  "foodHygiene": {
    "businesses": 50,
    "byRating": {
      "2": 1,
      "3": 3,
      "4": 8,
      "5": 38
    },
    "shareRated4or5": 92
  },
  "summary": "A residential part of Plymouth ...",
  "model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
  "licence": "Contains public sector information licensed under the Open Government Licence v3.0."
}
```

## Related

- [GET /report/topic](/services/report-topic) ($0.15): Brief me on a topic in one call: gathers the last N days of coverage from Hacker News, Reddit and world news, reads the top articles in full, and writes an anal
- [GET /report/due-diligence](/services/report-due-diligence) ($0.30): Due diligence on a token AND the project behind it, in one call: contract safety verdict, market data, the project's public footprint (website and domain age, t

New here? [Getting started in 60 seconds](/start). All services: [Aayat AI](/).