DEVELOPER API V2

Postcodewise API Documentation

Comprehensive REST API reference for UK postcode intelligence, property valuations, crime statistics, schools, demographics, spatial GIS nodes, and embeddable UI components.

API Explorer Get API Key

API Overview

The Postcodewise REST API allows developers to retrieve full spatial intelligence, safety metrics, school ratings, transit connectivity, house price histories, census demographics, and OpenStreetMap spatial data for any location in the United Kingdom.

Base URL

https://postcodewise.co.uk/api/v1

Response Format

JSON (UTF-8, ISO 8601 timestamps)

Average Latency

< 35ms (Edge Cached)

GET

Full Postcode Intelligence

Fetch complete 360° spatial intelligence for any UK postcode.

GET/api/v1/postcode/{postcode}/intelligence

Returns overall score, location geography, data quality breakdown, and detailed metrics across safety, schools, transport, housing, demographics, environment, connectivity, and lifestyle.

Postcode

API Key

Request Code

curl -X GET "https://postcodewise.co.uk/api/v1/postcode/SW1A1AA/intelligence" \
  -H "X-API-Key: pk_live_demo9981a2b3c4d5e6" \
  -H "Accept: application/json"

RESPONSE SHELL

Time:24msSize:1.4 KBContent-Type:application/json

{
  "schema_version": 2,
  "type": "full_postcode",
  "postcode": "SW1A 1AA",
  "pc_compact": "SW1A1AA",
  "outcode": "SW1A",
  "area": "Westminster",
  "region": "London",
  "country": "England",
  "latitude": 51.501,
  "longitude": -0.1419,
  "overallScore": 7.8,
  "scores": {
    "overall": 7.8,
    "crime": 6.2,
    "schools": 8.9,
    "transport": 9.5,
    "housing_yoy_change": 4.2,
    "affluence": 8.7,
    "environment": 7.1,
    "connectivity": 9
  },
  "metrics": {
    "crime": {
      "total_12m": 142,
      "decile": 6,
      "safety_rating": "Moderate"
    },
    "schools": {
      "primary_count": 5,
      "outstanding_count": 3,
      "nearest_km": 0.3
    },
    "transport": {
      "nearest_station": "St James's Park",
      "station_dist_km": 0.4
    },
    "housing": {
      "average_price_gbp": 1250000,
      "price_change_yoy_pct": 4.2
    }
  }
}

Authenticated via X-API-KeyPostcodewise Edge API

Request Parameters Reference

Parameter	Type	Required	Description
postcode	string	REQUIRED	Valid UK Postcode in standard or compact format (e.g., SW1A 1AA or SW1A1AA).
sections	string	OPTIONAL	Comma-separated section filter: safety, schools, transport, housing, demographics, environment, connectivity, lifestyle.
X-API-Key	header	REQUIRED	Your workspace developer API key. Issued via Settings > API Keys.

Interactive Widget Studio

Customize and embed a live Postcodewise component directly into your web app with 1 line of HTML, React, or Vue code.

Quick Styles

Postcode

Embed Code Output

<iframe src="https://postcodewise.co.uk/widget/SW1A1AA?key=YOUR_API_KEY&theme=light&show=safety,schools,transport,connectivity&layout=detailed&accent=%234f46e5&radius=16px" width="100%" height="480" frameborder="0"></iframe>

Live Embed Preview