# Quickstart

> Van inloggen tot je eerste woningwaarde.

Bron: https://huispedia.dev/nl/docs/quickstart/

1. Log in op [https://huispedia.dev/nl/dashboard/signin/](https://huispedia.dev/nl/dashboard/signin/) met je huispedia.nl- of Pro-account.
2. Kies je plan; Free kan ook.
3. Maak onder *API-sleutels* een API-sleutel (`hp_…`). Je ziet hem één keer.
4. Waardeer een woning:

```bash
curl https://huispedia.dev/v5/properties/1076LJ-12-2/valuation \
  -H "X-API-Key: $HUISPEDIA_KEY"
```

<details class="hp-sample">
<summary>Zo ziet het antwoord eruit</summary>

```json
{
  "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 de Huispedia Woningwaarde; de werkelijke waarde ligt met 80% zekerheid tussen `lower` en `upper`.

</details>

## Verder

- [Datacatalogus](https://huispedia.dev/nl/docs/catalogue/): wat je nog meer opvraagt.
- [Endpoints](https://huispedia.dev/nl/docs/endpoints/): elk endpoint, ingelogd te proberen met je eigen credits.
- [Adressen en gebieden](https://huispedia.dev/nl/docs/locators/): een woning aanduiden met een BAG-id of een gebied met een CBS-code.
- [Claude Code-plugin](https://huispedia.dev/nl/docs/claude/): laat Claude Code je aanroepen schrijven.
- [Overstappen van Altum](https://huispedia.dev/nl/docs/migrate/altum/)
- [Overstappen van Matrixian](https://huispedia.dev/nl/docs/migrate/matrixian/)
