Developers

The same matched data, straight into your stack

A small, predictable REST API. Bearer-key authentication, JSON responses, per-key rate limits and usage visible in your dashboard.

Request an API key

Endpoints

GET/v1/properties

Search matched properties by postcode, address fragment or UPRN.

GET/v1/properties/{uprn}

Full record: EPC, sale chain with tenure length, IMD decile, ONS codes.

GET/v1/postcodes/{postcode}

Postcode summary with geography codes and aggregated stock metrics.

GET/v1/areas/{code}/stats

Statistics for any ONS area code: LSOA, MSOA, ward, LA, region or national.

Example request

curl https://api.addressreports.co.uk/v1/properties/100023336956 \
  -H "Authorization: Bearer $EPC_API_KEY"

{
  "uprn": "100023336956",
  "address": "12 Bolingbroke Road, London",
  "postcode": "SW11 2XY",
  "epc": { "current_band": "E", "current_score": 48, "potential_band": "C" },
  "price_paid": [
    { "date": "2005-04-18", "price": 328000, "tenure": "F" }
  ],
  "tenure_length_years": 21,
  "deprivation": { "imd_decile": 4 },
  "geography": { "lsoa": "E01004718", "la": "E09000032", "region": "E12000007" }
}

Keys are hashed at rest and can be rotated or revoked instantly.
Rate limits and monthly call caps are set per key.
Every response includes match confidence and source vintage.

Works with your stack

The API is a plain, key-authenticated REST service with a published OpenAPI 3.0 specification and CSV output, so it connects to CRM, spreadsheet and automation tools without a bespoke connector.

OpenAPI specification

https://addressreports.co.uk/api/public/v1/openapi.json

Salesforce

External Services

Setup → External Services → Add from API Specification. Paste the OpenAPI URL below, add a Named Credential with your key in the x-api-key header. Endpoints become invocable actions in Flow and Apex.

HubSpot

Workflows / Custom code

Use a webhook or custom-code action pointing at /v1/properties with your key header. Map EPC band, opportunity score and price paid onto company or contact properties.

Microsoft Excel & Power BI

Get Data from Web

Paste the CSV URL with ?format=csv&api_key=… into Get Data → Web. Rows refresh on demand or on a schedule — no connector to install.

Google Sheets

IMPORTDATA

=IMPORTDATA("https://addressreports.co.uk/api/public/v1/properties?postcode_district=SW11&format=csv&api_key=…") pulls a live table straight into a sheet.

Zapier, Make & n8n

HTTP module

Any generic HTTP/Webhook step works: GET the endpoint, add the x-api-key header, and map the JSON fields into the next app in the scenario.

Postman & code clients

OpenAPI import

Import the OpenAPI 3.0 spec to generate a ready-made collection, or use it with openapi-generator for typed clients in TypeScript, Python, C# or Java.