# UK Open Data

UK postcodes, police crime data and bank holidays from free government sources.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://uk-open-data.x402tookit.com/openapi.json
- x402 manifest: https://uk-open-data.x402tookit.com/.well-known/x402
- Catalog (free): https://uk-open-data.x402tookit.com/catalog
- Health (free): https://uk-open-data.x402tookit.com/health
- Uptime (free): https://uk-open-data.x402tookit.com/uptime

## Endpoints (9)

### GET /bank-holidays — $0.02
Official UK bank holidays for England and Wales, Scotland or Northern Ireland in a given year, with weekdays, from GOV.UK.
Params: division?: string, year?: integer
Example: https://uk-open-data.x402tookit.com/bank-holidays?division=scotland&year=2026

### GET /crime-near — $0.03
Police street-crime counts by category within 1 mile of a UK point for a month (Eng, Wales, NI); data lags ~2 months.
Params: lat: number, lon: number, month?: string
Example: https://uk-open-data.x402tookit.com/crime-near?lat=51.5007&lon=-0.1246&month=2026-07

### GET /next-bank-holiday — $0.02
Next UK bank holiday on or after a date (default today) for England and Wales, Scotland or Northern Ireland, plus the next two.
Params: division?: string, from?: string
Example: https://uk-open-data.x402tookit.com/next-bank-holiday?division=england-and-wales&from=2026-10-20

### GET /outcode-lookup — $0.02
Look up a UK outcode (e.g. EC1A, SW1A, M1): centre coordinates, districts, wards, parishes and constituencies it covers.
Params: outcode: string
Example: https://uk-open-data.x402tookit.com/outcode-lookup?outcode=EC1A

### GET /police-force-for-point — $0.02
Which UK police force and neighbourhood team covers a lat/lon (England, Wales, NI), with the force website and 101 number.
Params: lat: number, lon: number
Example: https://uk-open-data.x402tookit.com/police-force-for-point?lat=51.5007&lon=-0.1246

### GET /postcode-lookup — $0.02
Look up a UK postcode: coordinates, council, ward, constituency, region and police force area; flags terminated postcodes.
Params: postcode: string
Example: https://uk-open-data.x402tookit.com/postcode-lookup?postcode=EC1A+1BB

### GET /postcode-nearest — $0.02
Nearest UK postcodes to a given postcode, with distance in metres, council and ward, via postcodes.io.
Params: postcode: string, limit?: integer, radius_m?: integer
Example: https://uk-open-data.x402tookit.com/postcode-nearest?postcode=SW1A+2JR&limit=5&radius_m=300

### GET /postcode-reverse — $0.02
Reverse geocode a lat/lon to the nearest UK postcodes with distance, council, ward and constituency via postcodes.io.
Params: lat: number, lon: number, limit?: integer, radius_m?: integer
Example: https://uk-open-data.x402tookit.com/postcode-reverse?lat=51.5007&lon=-0.1246&limit=3&radius_m=200

### GET /postcode-validate — $0.02
Validate a UK postcode: format rules (outward/inward split) plus live existence and terminated status via postcodes.io.
Params: postcode: string
Example: https://uk-open-data.x402tookit.com/postcode-validate?postcode=EC1A+1BB

## Terms

Computed from postcodes.io, data.police.uk and GOV.UK, public sources provided as is. Crime data is a lagged, approximate, location-anonymised record, not a risk rating. Not legal, safety or property advice.