Predictable token pricing.
Not per-lookup billing.

curl --get "https://api.homedata.co.uk/address/match/" \
  --data-urlencode "address=10 Downing Street" \
  --data-urlencode "postcode=SW1A 2AA" \
  -H "Authorization: Api-Key YOUR_API_KEY"
# 200: address-level retrieve body plus address_resolution; 5 tokens.
# 422: reason no_match or multiple_matches; never charged.
# Use the returned UPRN for further property data.

import requests

headers = {"Authorization": "Api-Key YOUR_API_KEY"}
response = requests.get(
    "https://api.homedata.co.uk/address/match/",
    params={"address": "10 Downing Street", "postcode": "SW1A 2AA"},
    headers=headers,
    timeout=30,
)
if response.status_code == 422:
    raise ValueError("Check the address: " + response.json()["reason"] + ". No charge.")
response.raise_for_status()
matched = response.json()
print(matched["uprn"], matched["address_resolution"])
# Address fields are already included. Enrich by UPRN if needed.
epc = requests.get(
    "https://api.homedata.co.uk/epc-checker/" + str(matched["uprn"]) + "/",
    headers=headers, timeout=30,
)
epc.raise_for_status()
print(epc.json())

// Run on your server; keep the API key out of browser code.
const headers = { Authorization: `Api-Key ${process.env.HOMEDATA_API_KEY}` };
const params = new URLSearchParams({
  address: '10 Downing Street', postcode: 'SW1A 2AA',
});
const response = await fetch(
  `https://api.homedata.co.uk/address/match/?${params}`, { headers },
);
const matched = await response.json();
if (response.status === 422) {
  throw new Error(`Check the address: ${matched.reason}. No charge.`);
}
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(matched.uprn, matched.address_resolution);