API-documentatie

Basis-URL: https://api.pandlens.com (api.pandlens.nl volgt). OpenAPI: Swagger UI.

Authenticatie

Stuur je API-key in de header X-Api-Key bij elke request (behalve de demo-endpoint).

X-Api-Key: uw_api_key

Endpoints

Methode	Pad	Beschrijving
GET	`/v1/address/{postcode}/{huisnummer}`	Verrijking (optioneel: huisletter, toevoeging)
GET	`/v1/usage`	Maandelijks verbruik
GET	`/v1/demo/address/…`	Publieke demo (Turnstile, rate limits)
POST	`/v1/signup`	Gratis Free-plan key

curl

curl -s -H "X-Api-Key: $PANDLENS_API_KEY" \
  "https://api.pandlens.com/v1/address/1012JS/1"

JavaScript

const res = await fetch(
  "https://api.pandlens.com/v1/address/1012JS/1",
  { headers: { "X-Api-Key": process.env.PANDLENS_API_KEY } }
);
const data = await res.json();

C#

client.DefaultRequestHeaders.Add("X-Api-Key", apiKey);
var json = await client.GetStringAsync(
    "https://api.pandlens.com/v1/address/1012JS/1");

Foutcodes

401	Ongeldige of ontbrekende API-key
404	Adres niet gevonden
402	Quotum overschreden
429	Rate limit

Rate limits

Per API-key geldt een requestlimiet per minuut (zie response headers). Maandelijkse quotas per plan via GET /v1/usage.

Attributie

Vermeld in je product: BAG via Kadaster/PDOK, energielabel via RVO EP-Online, en "CBS, CC BY 4.0" voor buurtcijfers.