Pricing & Rate Limits
One prepaid balance of tokens pays for everything: API calls and dashboard reveals. 100 tokens = £1. Every endpoint publishes its weight; every response tells you what it cost. Tokens never expire.
£20 to £2,500 at a time from Billing. A one-off top-up adds exactly what you pay: 100 tokens per £1.
Add tokens every month — any amount from £20 to £2,500 — and every payment earns 10% bonus tokens on any amount, 20% from £250 a month, 35% from £500, 50% from £1,000, 75% from £2,500. Change the amount or stop any time; unused tokens roll over.
Your organisation's first ever payment is doubled, whether it is a top-up or the first month of a subscription: £50 becomes 10,000 tokens, £20 becomes 4,000 tokens.
Save a card and choose a threshold and an amount. When your balance drops below the threshold we charge the amount, add exactly that many tokens and send a VAT invoice. It works alongside a monthly subscription, as a safety net between payments.
Bonus tokens
Bonus tokens come with a monthly subscription, on every payment. The bonus applies to any monthly amount at or above a threshold, not only the preset amounts. One-off top-ups and auto top-ups add exactly what you pay. Prices exclude VAT.
| Monthly amount | Bonus | Tokens a month | Effective cost / token |
|---|---|---|---|
| £20 – £249.99 | +10% | 2,200 – 27,498 | 0.91p |
| £250 – £499.99 | +20% | 30,000 – 59,998 | 0.83p |
| £500 – £999.99 | +35% | 67,500 – 134,998 | 0.74p |
| £1,000 – £2,499.99 | +50% | 150,000 – 374,998 | 0.67p |
| £2,500 | +75% | 437,500 | 0.57p |
| One-off or auto top-up, any amount | — | what you pay | 1.00p |
| First ever payment, any amount | +100% | 2× what you pay | 0.50p |
Tokens per request, by endpoint
Most endpoints cost 1 token. Address endpoints carry Royal Mail PAF / Ordnance Survey licensing; HMLR confirmed sales carry Land Registry licensing.
Custom slug picks (/property/{uprn}/?with=slug1,slug2) cost the sum of the chosen slugs' native weights — the discovery call lists each slug's price. Wallet keys carry X-Tokens-Charged and X-Tokens-Balance on every response; quota keys carry X-RateLimit-* instead. Requests that fail are automatically refunded: any 4xx (other than a 402) and any 5xx costs nothing.
Typical workflow: address/find (2) → address/retrieve (5) → property record (1) = 8 tokens, or 8p, to go from a typed address to a fully populated form.
Reveals — what 20 tokens covers
Revealing a listing unlocks its UPRN, full address and complete event timeline — added, reduced, withdrawn, sold. Each reveal, listing or sale-event request is a flat 20 tokens from the same balance as every other API request, and a listing your organisation has already revealed is free to re-fetch forever.
Rate limits
Rate limits are applied per API key. Exceeding the limit returns HTTP 429 — requests are not queued, retry with backoff. Rate limits are about request pace, not tokens: a 429 costs nothing.
Retry-After header (seconds) before retrying. For batch jobs, pace requests and back off whenever a 429 comes back.
Billing semantics
-
Tokens never expire. There is no monthly allowance and nothing resets — your balance is exactly what you have added minus what you have spent.
-
Only a served response is charged. Any 4xx response other than a 402 — a 400, 404 or 422 — and any 5xx is never billed: a debit taken before the failure is refunded automatically. A 402 (not enough tokens) raised after the base charge keeps that base charge.
-
Already-revealed listings re-fetch free — pass the same
listing_idwith a newIdempotency-Keyand the response returns with"charged": false. -
An empty balance returns HTTP 402 with
requiredandavailable(in tokens) and atopup_url. Top up, or switch on auto top-up, and calls resume immediately. -
Refunds of a top-up or a monthly payment claw back the tokens it granted, bonus included, pro rata to the amount refunded.
-
Live balance and spend are visible any time in the Developer Dashboard; every invoice is under Billing.
Ready to start?
Key in 30 seconds. Your first payment is matched 100% — £20 becomes 4,000 tokens.
Integrate into your own product
Pay as you goHomedata API billing is fully transparent — every endpoint publishes its token cost upfront, and your Developer Dashboard shows real-time spend and balance.
Structured as JSON · queryable by UPRN or postcode · ready to embed in any application
Exact measurements
Real values — distances, concentrations, counts — not rounded ratings
29 million UK properties covered
Every address queryable by UPRN or postcode
REST API
JSON responses, OpenAPI docs, sandbox — first call in under 5 minutes
Pay as you go: 100 tokens = £1 across every endpoint, no subscription needed. Bonus tokens with an optional monthly subscription, and your first top-up matched 100%. See pricing →
Sources
Further reading
Rate limit headers · 429 / 402 error codes · Endpoint token costs · Full pricing page