Quickstart

1. 1

   Sign in

   With your huispedia.nl or Pro account.

   Sign in
2. 2

   Choose your plan

   After you sign in.

3. 3

   Value a home

   Every call needs an API key. Here you use a temporary one, so you can try right away. A valuation costs 8 credits.

   Postcode-number-extension

   Value it

   After you sign in.

4. 4

   Your own API key (optional)

   For your own code. You see it once.

   From your terminal:

   curl https://huispedia.dev/v5/properties/1076LJ-12-2/valuation \
     -H "X-API-Key: hp_…"

What the answer looks like

{
  "address": {
    "bag_id": "0363200000028422", "postcode": "1076LJ", "house_number": 12, "house_number_ext": "2",
    "street": "Amazonenstraat", "city": "Amsterdam", "municipality": "Amsterdam", "province": "Noord-Holland",
    "location": { "lat": 52.34536032, "lon": 4.86274012 },
    "huispedia_url": "https://huispedia.nl/amsterdam/1076LJ/amazonenstraat/12-2"
  },
  "valuation": { "value": 888264, "lower": 838099, "upper": 941431, "interval": 0.8, "price_per_m2": 9064, "as_of_date": "2026-10-26", "model": "avm4", "model_version": "2026.10" },
  "confidence": { "score_pct": 90.3, "class": "high", "within_5_pct": 45.2, "within_10_pct": 90.3, "within_20_pct": 100.0 },
  "meta": { "request_id": "req_01M5W27EFJTGG4DQDJ6DVK3NVY", "as_of": "2026-10-26", "credits": { "charged": 8, "balance": 192 } }
}

value is the Huispedia home value; the actual value lies between lower and upper with 80% certainty.

Next

• Data catalogue: what else you can ask for.
• Endpoints: every endpoint, to try with your own credits once signed in.
• Addresses and areas: point at a home by BAG id or at an area by CBS code.
• Claude Code plugin: let Claude Code write your calls.
• Migrating from Altum
• Migrating from Matrixian