Know your costs
before you write a line of code.

Request

# Address search: 2 tokens (vs PropertyData's 10 credits)
curl https://api.homedata.co.uk/address/find/ \
  -G --data-urlencode "q=10 Downing Street, London" \
  -H "Authorization: Api-Key YOUR_API_KEY"

# Retrieve full property data: base tier (10 tokens)
curl https://api.homedata.co.uk/property/10002210501/base/ \
  -H "Authorization: Api-Key YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"
BASE    = "https://api.homedata.co.uk"

# Step 1: Address search (2 tokens)
res = requests.get(f"{BASE}/address/find/",
    params={"q": "10 Downing Street, London"}, headers={"Authorization": "Api-Key YOUR_API_KEY"})
uprn = res.json()["suggestions"][0]["uprn"]

# Step 2: Full property data (1 token)
prop = requests.get(f"{BASE}/property/{uprn}/base/",
    headers={"Authorization": f"Api-Key {API_KEY}"})
print(prop.json())

const BASE    = "https://api.homedata.co.uk";
const API_KEY = "YOUR_API_KEY";

// Step 1: Address search (2 tokens)
const find = await fetch(
  `${BASE}/address/find/?q=10+Downing+Street+London`,
  { headers: { Authorization: `Api-Key ${API_KEY}` } }
);
const { suggestions } = await find.json();
const uprn = suggestions[0].uprn;

// Step 2: Full property data (1 token)
const prop = await fetch(
  `${BASE}/property/${uprn}/base/`,
  { headers: { "Authorization": `Api-Key ${API_KEY}` } }
);
console.log(await prop.json());

Response

{
  "uprn": "10002210501",
  "address": "10 Downing Street, London",
  "postcode": "SW1A 2AA",
  "bedrooms": 4,
  "property_type": "Terraced",
  "current_energy_efficiency": 72,
  "epc_floor_area": 310,
  "construction_age_band": "1900-1929",
  "has_garden": false,
  "building_height": 14.2,
  "geometry_area_m2": 412,
  "latitude": 51.5034,
  "longitude": -0.1276
}

One call. No separate property lookup endpoint. Beds, EPC, floor area and construction age, all returned together.