Stuur een Nederlandse postcode en huisnummer en ontvang een volledig pandprofiel: officieel adres en BAG-identificatoren, energielabel, WOZ-waarde, ruimtelijke plannen en omgevingsinformatie. De data is afkomstig van meerdere officiële bronnen en wordt 24 uur gecached.
De data is samengesteld uit meerdere officiële bronnen: BAG (Basisregistratie Adressen en Gebouwen), EP-Online (RVO energielabels), WOZ-waarden en het Digitaal Stelsel Omgevingswet (DSO-LV) voor ruimtelijke plannen en omgevingsinformatie.
De dataset wordt dagelijks gesynchroniseerd. Nieuwe panden of wijzigingen zijn doorgaans binnen 24–48 uur zichtbaar via de API.
Een pandgegevens-call bevraagt meerdere externe diensten in parallel. Bij een cache-hit (24 uur geldig) wordt slechts 1 credit in rekening gebracht; bij een cache-miss worden 3 credits in rekening gebracht.
Je kunt zoeken op basis van een Nederlands adres (postcode + huisnummer, optioneel met toevoeging). BAG-identificatoren worden teruggegeven in de response.
Integreren in jouw applicatie? Probeer onze codevoorbeelden hieronder of bekijk de volledige documentatie voor meer details en extra talen en/of collecties.
curl "https://api.getapi.nl/api/v1/property/pandgegevens?postcode=1234AB&house_number=1&house_letter=value&house_number_addition=value" \
--header "X-Api-Key: ga_live_YOUR_KEY"
const response = await fetch('https://api.getapi.nl/api/v1/property/pandgegevens?postcode=1234AB&house_number=1&house_letter=value&house_number_addition=value', {
method: 'GET',
headers: {
'X-Api-Key': 'ga_live_YOUR_KEY',
},
});
const data = await response.json();
$ch = curl_init();
$headers = [
'X-Api-Key: ga_live_YOUR_KEY',
];
curl_setopt_array($ch, [
CURLOPT_URL => 'https://api.getapi.nl/api/v1/property/pandgegevens?postcode=1234AB&house_number=1&house_letter=value&house_number_addition=value',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => $headers,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
import requests
headers = {
'X-Api-Key': 'ga_live_YOUR_KEY',
}
params = {
'postcode': '1234AB',
'house_number': '1',
'house_letter': 'value',
'house_number_addition': 'value',
}
response = requests.get('https://api.getapi.nl/api/v1/property/pandgegevens', headers=headers, params=params)
data = response.json()
{
"found": true,
"address": {
"bag_nummeraanduiding_id": "0363200000218908",
"bag_verblijfsobject_id": "0363010000218908",
"bag_pand_ids": [
"0363100012165277"
],
"bag_openbare_ruimte_id": "0363300000006316",
"bag_woonplaats_id": "3594",
"street": "Damrak",
"short_name": "Damrak",
"house_number": 1,
"house_letter": null,
"house_number_addition": null,
"postcode": "1012LG",
"city": "Amsterdam",
"municipality": "Amsterdam",
"address_line": "Damrak 1",
"address_line_postal": "1012 LG AMSTERDAM",
"usage_purposes": [
"retail"
],
"surface_area_m2": 312,
"build_year": 1900,
"status": "in_use",
"type": "residence",
"is_secondary_address": false,
"is_observed": false,
"in_investigation": null,
"document_date": "2019-11-22",
"document_number": "19SZ2048",
"secondary_address_ids": [],
"occurrence": null,
"lat": 52.3745,
"lon": 4.8986
},
"bag_identifiers": {
"nummeraanduiding_id": "1234567890123456",
"verblijfsobject_id": "1234567890123456",
"openbareruimte_id": "1234567890123456"
},
"energy_label": {
"label": "C",
"energy_class": "C",
"energy_index": 1.4,
"building_class": "residential",
"building_type": "apartment",
"building_subtype": "corner_apartment",
"construction_year": 1925,
"calculated_co2_emission": 12.5,
"calculated_energy_consumption": 85.3,
"registration_date": "2024-01-01",
"valid_until": "2034-01-01"
},
"energy_details": {
"recording": {
"recording_date": "2024-01-01",
"recording_type": "full_calculation",
"certificate_holder": "Example Company",
"status": "valid",
"calculation_type": "detailed",
"is_simplified_label": false,
"based_on_reference_building": false
},
"energy_performance": {
"energy_index_emg_forfeit": 1.35,
"energy_demand": 75.2,
"primary_fossil_energy": 120.5,
"primary_fossil_energy_emg_forfeit": 118.3,
"renewable_energy_share": 15.2,
"renewable_energy_share_emg_forfeit": 16.8,
"temperature_overrun": 2.1,
"heat_demand": 45.8
},
"requirements": {
"energy_demand": 70,
"primary_fossil_energy": 115,
"renewable_energy_share": 14,
"temperature_overrun": 2
},
"bag_building_ids": [
"1234567890123456"
],
"sbi_code": "4110",
"detail_description": "Detailed building description"
},
"property_value": {
"amount": 475000,
"reference_date": "2024-01-01"
},
"building": {
"surface_area": 72,
"construction_year": 1925,
"type": "residential",
"subtype": "apartment",
"class": "residential",
"compactness": 0.85
},
"spatial_planning": {
"agrarisch": false,
"type": "Wonen",
"plan": "Bestemmingsplan Centrum",
"plan_id": "NL.IMRO.1234.BP1234",
"plan_url": "https:\/\/www.ruimtelijkeplannen.nl\/viewer\/viewer?planidn=NL.IMRO.1234.BP1234",
"plan_status": "vastgesteld",
"plan_datum": "2023-06-15",
"overheid": "Gemeente Voorbeeldstad",
"bestemmingsvlak": {
"id": "12345",
"naam": "Wonen",
"type": "bestemmingsvlak",
"bestemmingshoofdgroep": "Wonen",
"artikelnummer": "3.1",
"verwijzingNaarTekst": [
"Artikel 3 Wonen"
]
},
"plannen": [],
"copyright": "Gegevens geleverd door Digitaal Stelsel Omgevingswet (DSO-LV) onder CC-BY licentie."
},
"environmental_info": {
"mogelijk": true,
"reden": "Woonfunctie aanwezig in bestemmingsvlak.",
"bestemming": "Wonen",
"plan_url": "https:\/\/www.ruimtelijkeplannen.nl\/viewer\/viewer?planidn=NL.IMRO.1234.BP1234",
"bestemmingsvlak": {
"id": "12345",
"naam": "Wonen",
"type": "bestemmingsvlak",
"bestemmingshoofdgroep": "Wonen",
"artikelnummer": "3.1",
"verwijzingNaarTekst": [
"Artikel 3 Wonen"
]
},
"documenten": [],
"copyright": "Gegevens geleverd door Digitaal Stelsel Omgevingswet (DSO-LV) onder CC-BY licentie."
}
}
Overzicht van alle velden die de API teruggeeft in een succesvol antwoord.
| Veld | Type | Verplicht | Omschrijving |
|---|---|---|---|
found
|
boolean | ja | |
address
|
object null | nee | |
└ bag_nummeraanduiding_id
|
string null | ja | |
└ bag_verblijfsobject_id
|
string null | ja | |
└ bag_pand_ids
|
array | ja | |
└ bag_openbare_ruimte_id
|
string null | ja | |
└ bag_woonplaats_id
|
string null | ja | |
└ street
|
string null | ja | |
└ short_name
|
string null | ja | |
└ house_number
|
integer null | ja | |
└ house_letter
|
string null | ja | |
└ house_number_addition
|
string null | ja | |
└ postcode
|
string null | ja | |
└ city
|
string null | ja | |
└ municipality
|
string null | ja | |
└ address_line
|
string null | ja | |
└ address_line_postal
|
string null | ja | |
└ usage_purposes
|
array | ja | |
└ surface_area_m2
|
integer null | ja | |
└ build_year
|
integer null | ja | |
└ status
|
string null | ja | |
└ type
|
string null | ja | |
└ is_secondary_address
|
boolean | ja | |
└ is_observed
|
boolean null | ja | |
└ in_investigation
|
string | ja | |
└ document_date
|
string null | ja | |
└ document_number
|
string null | ja | |
└ secondary_address_ids
|
array | ja | |
└ occurrence
|
string | ja | |
└ lat
|
number null | ja | |
└ lon
|
number null | ja | |
bag_identifiers
|
object | nee | |
└ nummeraanduiding_id
|
string null | ja | |
└ verblijfsobject_id
|
string null | ja | |
└ openbareruimte_id
|
string null | ja | |
energy_label
|
object null | nee | |
└ label
|
string null | ja | |
└ energy_class
|
string null | ja | |
└ energy_index
|
number null | ja | |
└ building_class
|
string null | ja | |
└ building_type
|
string null | ja | |
└ building_subtype
|
string null | ja | |
└ construction_year
|
integer null | ja | |
└ calculated_co2_emission
|
number null | ja | |
└ calculated_energy_consumption
|
number null | ja | |
└ registration_date
|
string null | ja | |
└ valid_until
|
string null | ja | |
energy_details
|
object null | nee | |
└ recording
|
object | ja | |
└ recording_date
|
string null | ja | |
└ recording_type
|
string null | ja | |
└ certificate_holder
|
string null | ja | |
└ status
|
string null | ja | |
└ calculation_type
|
string null | ja | |
└ is_simplified_label
|
boolean null | ja | |
└ based_on_reference_building
|
boolean null | ja | |
└ energy_performance
|
object | ja | |
└ energy_index_emg_forfeit
|
number null | ja | |
└ energy_demand
|
number null | ja | |
└ primary_fossil_energy
|
number null | ja | |
└ primary_fossil_energy_emg_forfeit
|
number null | ja | |
└ renewable_energy_share
|
number null | ja | |
└ renewable_energy_share_emg_forfeit
|
number null | ja | |
└ temperature_overrun
|
number null | ja | |
└ heat_demand
|
number null | ja | |
└ requirements
|
object | ja | |
└ energy_demand
|
number null | ja | |
└ primary_fossil_energy
|
number null | ja | |
└ renewable_energy_share
|
number null | ja | |
└ temperature_overrun
|
number null | ja | |
└ bag_building_ids
|
array | ja | |
└ sbi_code
|
string null | ja | |
└ detail_description
|
string null | ja | |
property_value
|
object null | nee | |
└ amount
|
integer null | ja | |
└ reference_date
|
string null | ja | |
building
|
object | nee | |
└ surface_area
|
integer null | ja | |
└ construction_year
|
integer null | ja | |
└ type
|
string null | ja | |
└ subtype
|
string null | ja | |
└ class
|
string null | ja | |
└ compactness
|
number null | ja | |
spatial_planning
|
object null | nee | |
└ agrarisch
|
boolean | ja | |
└ type
|
string | ja | |
└ plan
|
string | ja | |
└ plan_id
|
string null | ja | |
└ plan_url
|
string null | ja | |
└ plan_status
|
string null | ja | |
└ plan_datum
|
string null | ja | |
└ overheid
|
string null | ja | |
└ bestemmingsvlak
|
object null | ja | |
└ id
|
string | ja | |
└ naam
|
string | ja | |
└ type
|
string | ja | |
└ bestemmingshoofdgroep
|
string | ja | |
└ artikelnummer
|
string | ja | |
└ verwijzingNaarTekst
|
array | ja | |
└ plannen
|
array | ja | |
└ copyright
|
string | ja | |
environmental_info
|
object null | nee | |
└ mogelijk
|
boolean | ja | |
└ reden
|
string | ja | |
└ bestemming
|
string | ja | |
└ plan_url
|
string null | ja | |
└ bestemmingsvlak
|
object null | ja | |
└ id
|
string | ja | |
└ naam
|
string | ja | |
└ type
|
string | ja | |
└ bestemmingshoofdgroep
|
string | ja | |
└ artikelnummer
|
string | ja | |
└ verwijzingNaarTekst
|
array | ja | |
└ documenten
|
array | ja | |
└ copyright
|
string | ja |
| Tier | Rate limit | Kosten per call |
|---|---|---|
| Betaald | Alleen beschikbaar bij een abonnement. | |
| Premium | 20 verzoeken/min | 3.00 credits |
Credits worden afgeschreven per succesvol verzoek. Bekijk onze prijzen voor meer informatie over creditpakketten.
Documentatie & codevoorbeelden
Bekijk de volledige API-referentie met authenticatie, endpoints en automatisch gegenereerde codevoorbeelden in cURL, PHP, JavaScript en Python.