Je eerste adreslookup.

Doorloop deze stappen op je server. Een private API-key hoort nooit in browsercode.

1. Toegang verkrijgen

Registreer met een gebruikersnaam en e-mailadres. Stel via de registratie-e-mail je wachtwoord in en log in op Mijn account om je API-key aan te maken.

Inloggen op Mijn account

2. Je API-key beheren

Maak in de bestaande Customer Portal een API-key aan. Sla de eenmalig getoonde key direct veilig op. De portal beheert ook intrekken en het huidige verbruik.

API-keygebruik en intrekken

3. De key veilig opslaan

Gebruik de secret store of serverconfiguratie van je applicatie. Het voorbeeld hieronder verwacht de key in de serveromgeving onder GEOLEDGER_API_KEY. Commit de key niet, log haar niet en plaats haar niet in een URL.

De variabelenaam in dit voorbeeld is een keuze voor jouw applicatie, geen nieuwe portalconfiguratie.

4. Een request uitvoeren

curl --get 'https://api-postcode.casag.nl/v1/address' \
  --header "X-API-Key: ${GEOLEDGER_API_KEY}" \
  --data-urlencode 'postcode=1012JS' \
  --data-urlencode 'huisnummer=1'

Dit request gebruikt de bestaande publieke API-host api-postcode.casag.nl. De nieuwe merknaam verandert het API-contract niet. Het voorbeeldpostcode/huisnummerpaar is illustratief; het is geen live bevestiging van een adres. De officiële hostname is api.geoledger.eu; deze lokale frontendwijziging migreert geen bestaande integratie.

5. Resultaat, fouten en quota verwerken

Controleer eerst de HTTP-status. Bij HTTP 200 lees je status in de JSON: ok, not_found of ambiguous. Houd handmatige adresinvoer beschikbaar en toon geen technische details of secrets aan de eindgebruiker.

Lees de volledige API-referentie Verwerk fouten Controleer quota-impact

Contract gecontroleerd op 30 september 2026 aan de hand van de huidige API-broncode. De actieve accountlimits vind je in Mijn account.

Maak gratis een API-key