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