Postcode API - Nederlandse en Belgische Adressen

Probeer onze Postcode API direct uit. Ondersteunt Nederlandse (1234AB) en Belgische (1000) postcodes. Vul een postcode en huisnummer in om de API response te zien.

Interactieve API Demo

Voorbeelden

Nederlandse Postcode

Request:

GET api.pluginplus.nl/api/postcode?postcode=1234AB&number=42

Response:

{
  "street": "Voorbeeldstraat",
  "city": "Amsterdam",
  "postcode": "1234AB",
  "number": 42,
  "number_addition": null,
  "country": "NL"
}

Belgische Postcode

Request:

GET api.pluginplus.nl/api/postcode?postcode=1000&number=1&number_addition=B

Response:

{
  "street": "Voorbeeldstraat",
  "city": "Brussel",
  "postcode": "1000",
  "number": 1,
  "number_addition": "B",
  "country": "BE"
}

API Documentatie

Endpoint

GET api.pluginplus.nl/api/postcode

Request Parameters

Parameter	Type	Verplicht	Beschrijving
`postcode`	string	Ja	NL: 1234AB (4 cijfers + 2 letters), BE: 1000 (4 cijfers)
`number`	string	Ja	Huisnummer (bijv. 42 of 1)
`number_addition`	string	Nee	Huisnummertoevoeging, vooral belangrijk voor BE (bijv. B, bis)

Response Format

Bij succes (200) wordt het volgende JSON object teruggegeven:

{
  "street": "Straatnaam",
  "city": "Plaatsnaam",
  "postcode": "1234AB",
  "number": 42,
  "number_addition": null,
  "country": "NL"
}

Error Responses

400 Bad Request: Ongeldig postcodeformaat

{
  "error": "Ongeldig postcodeformaat. Gebruik voor NL: 1234AB of voor BE: 1000",
  "country": null
}

404 Not Found: Postcode en huisnummer combinatie niet gevonden

{
  "street": "",
  "city": "",
  "postcode": "1000",
  "number": 1,
  "number_addition": null,
  "country": "BE",
  "error": "Deze postcode en huisnummer combinatie is niet gevonden. U kunt het adres handmatig invullen."
}