Pandgegevens API

Premium

MCP

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.

15.00 credit / call

2.50 credit / cached call

Woningen

Veelgestelde vragen

Waar komt de data vandaan?

Hoe actueel zijn de gegevens?

Waarom kost deze API meer credits?

Welke zoekmethoden worden ondersteund?

Wat zijn de kosten voor deze api?

Integratie voorbeeld

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/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/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/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/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_labels": [
        {
            "registration_date": "2024-08-30T22:25:14.623",
            "recording_date": "2024-08-26T00:00:00",
            "valid_until": "2034-08-26T00:00:00",
            "certificate_holder": "Prosperos B.V.",
            "recording_type": "Basisopname",
            "status": "Bestaand",
            "calculation_type": "NTA 8800:2024 (basisopname utiliteitsbouw)",
            "is_simplified_label": null,
            "based_on_reference_building": false,
            "building_class": "Utiliteitsbouw",
            "building_type": null,
            "building_subtype": null,
            "sbi_code": null,
            "zipcode": "1012LG",
            "house_number": 1,
            "house_letter": null,
            "house_number_addition": null,
            "detail_description": null,
            "bag_residence_id": "0363010012111931",
            "bag_mooring_id": null,
            "bag_stand_id": null,
            "bag_building_ids": [
                "0363100012185508"
            ],
            "construction_year": 1890,
            "usable_area_thermal_zone": 16131.58,
            "compactness": 0.51,
            "energy_class": "A+",
            "energy_index": null,
            "energy_index_emg_forfeit": null,
            "energy_demand": 112.77,
            "primary_fossil_energy": 177.25,
            "primary_fossil_energy_emg_forfeit": null,
            "renewable_energy_share": 19.4,
            "renewable_energy_share_emg_forfeit": null,
            "temperature_overrun": null,
            "heat_demand": 74.62,
            "requirement_energy_demand": null,
            "requirement_primary_fossil_energy": null,
            "requirement_renewable_energy_share": null,
            "requirement_temperature_overrun": null,
            "calculated_co2_emission": 36.99,
            "calculated_energy_consumption": 177.24
        }
    ],
    "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",
        "history": [
            {
                "amount": 450000,
                "reference_date": "2023-01-01"
            },
            {
                "amount": 425000,
                "reference_date": "2022-01-01"
            },
            {
                "amount": 400000,
                "reference_date": "2021-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."
    }
}

Responsvelden

Overzicht van alle velden die de API teruggeeft in een succesvol antwoord.

Veld	Type	Verplicht
`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_labels`	array	nee
└ `registration_date`	string	nee
└ `recording_date`	string	nee
└ `valid_until`	string	nee
└ `certificate_holder`	string	nee
└ `recording_type`	string	nee
└ `status`	string	nee
└ `calculation_type`	string	nee
└ `is_simplified_label`	null	nee
└ `based_on_reference_building`	boolean	nee
└ `building_class`	string	nee
└ `building_type`	null	nee
└ `building_subtype`	null	nee
└ `sbi_code`	null	nee
└ `zipcode`	string	nee
└ `house_number`	integer	nee
└ `house_letter`	null	nee
└ `house_number_addition`	null	nee
└ `detail_description`	null	nee
└ `bag_residence_id`	string	nee
└ `bag_mooring_id`	null	nee
└ `bag_stand_id`	null	nee
└ `bag_building_ids`	array	nee
└ `construction_year`	integer	nee
└ `usable_area_thermal_zone`	number	nee
└ `compactness`	number	nee
└ `energy_class`	string	nee
└ `energy_index`	null	nee
└ `energy_index_emg_forfeit`	null	nee
└ `energy_demand`	number	nee
└ `primary_fossil_energy`	number	nee
└ `primary_fossil_energy_emg_forfeit`	null	nee
└ `renewable_energy_share`	number	nee
└ `renewable_energy_share_emg_forfeit`	null	nee
└ `temperature_overrun`	null	nee
└ `heat_demand`	number	nee
└ `requirement_energy_demand`	null	nee
└ `requirement_primary_fossil_energy`	null	nee
└ `requirement_renewable_energy_share`	null	nee
└ `requirement_temperature_overrun`	null	nee
└ `calculated_co2_emission`	number	nee
└ `calculated_energy_consumption`	number	nee
`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
└ `history`	array	ja
└ `amount`	integer null	ja
└ `reference_date`	string null	ja
`building`	object null	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	nee
└ `type`	string	nee
└ `plan`	string	nee
└ `plan_id`	string	nee
└ `plan_url`	string	nee
└ `plan_status`	string	nee
└ `plan_datum`	string	nee
└ `overheid`	string	nee
└ `bestemmingsvlak`	object	nee
└ `id`	string	nee
└ `naam`	string	nee
└ `type`	string	nee
└ `bestemmingshoofdgroep`	string	nee
└ `artikelnummer`	string	nee
└ `verwijzingNaarTekst`	array	nee
└ `plannen`	array	nee
└ `copyright`	string	nee
`environmental_info`	object null	nee
└ `mogelijk`	boolean	nee
└ `reden`	string	nee
└ `bestemming`	string	nee
└ `plan_url`	string	nee
└ `bestemmingsvlak`	object	nee
└ `id`	string	nee
└ `naam`	string	nee
└ `type`	string	nee
└ `bestemmingshoofdgroep`	string	nee
└ `artikelnummer`	string	nee
└ `verwijzingNaarTekst`	array	nee
└ `documenten`	array	nee
└ `copyright`	string	nee

Limieten & kosten

Tier	Rate limit	Kosten per call	Cached request
Trial	5 verzoeken/min	15.00 credits	2.50 credits
Betaald	20 verzoeken/min	15.00 credits	2.50 credits

Credits worden afgeschreven per succesvol verzoek. Bekijk onze prijzen voor meer informatie over creditpakketten.

Documentatie & codevoorbeelden

Klaar om te integreren?

Bekijk de volledige API-referentie met authenticatie, endpoints en automatisch gegenereerde codevoorbeelden in cURL, PHP, JavaScript en Python.

Bekijk API-referentie Gratis proberen Download OpenAPI spec (.json)