BAG adres & postcode API documentatie

GET	https://api.overheid.io/bag

Doorzoek de BAG dataset. De reponse bevat een lijst van adressen.

Parameters

Naam	Standaard waarde	Omschrijving
size	100	Het aantal resultaten per pagina.
page	1	De gewenste pagina van resultaten.
sort		sorteer veld.
order	desc	sorteer richting.
fields[]	woonplaatsnaam huisletter huisnummer huisnummertoevoeging openbareruimtenaam postcode url	Velden in het overzicht.
filters[]	Filter velden resulaten op termen. Dit is handig voor het filteren van vaste waardes, zoals bijvoorbeeld het merk.
query		Zoek naar waarde.
queryfields	openbareruimtenaam postcode	Zoek naar waarde in deze velden.

Voorbeelden

 1 
 2{
 3    "totalItemCount": 109,
 4    "pageCount": 2,
 5    "size": 100,
 6    "_links": {
 7        "first": {
 8            "href": "/bag?filters[postcode]=3015BA&page=1"
 9        },
10        "last": {
11            "href": "/bag?filters[postcode]=3015BA&page=10"
12        },
13        "next": {
14            "href": "/bag?filters[postcode]=3015BA&page=2"
15        },
16        "self": {
17            "href": "/bag?filters%5Bpostcode%5D=3015BA"
18        }
19    },
20    "_embedded": {
21        "adres": [{
22                "_links": {
23                    "self": {
24                        "href": "/bag/3015ba-nieuwe-binnenweg-2"
25                    }
26                },
27                "huisletter": "",
28                "huisnummer": "2",
29                "huisnummertoevoeging": "",
30                "openbareruimte": "Nieuwe Binnenweg",
31                "postcode": "3015BA",
32                "slug": "3015ba-nieuwe-binnenweg-2",
33                "woonplaats": "Rotterdam"
34            },
35            {
36                "_links": {
37                    "self": {
38                        "href": "/bag/3015ba-nieuwe-binnenweg-10-f"
39                    }
40                },
41                "huisletter": "F",
42                "huisnummer": "10",
43                "huisnummertoevoeging": "",
44                "openbareruimte": "Nieuwe Binnenweg",
45                "postcode": "3015BA",
46                "slug": "3015ba-nieuwe-binnenweg-10-f",
47                "woonplaats": "Rotterdam"
48            },
49            ...
50        ]
51    }
52}

Je kan met de wildcard (*) zoeken. Meerdere zijn mogelijk.

 1 
 2{
 3    "totalItemCount": 8,
 4    "pageCount": 1,
 5    "size": 100,
 6    "_links": {
 7        "self": {
 8            "href": "/bag?filters[postcode]=3015BA&filters[huisnummer]=10"
 9        }
10    },
11    "_embedded": {
12        "adres": [{
13                "huisletter": "E",
14                "huisnummer": "10",
15                "huisnummertoevoeging": "",
16                "openbareruimtenaam": "Nieuwe Binnenweg",
17                "postcode": "3015BA",
18                "url": "3015ba-nieuwe-binnenweg-10-e",
19                "woonplaatsnaam": "Rotterdam",
20                "_links": {
21                    "self": {
22                        "href": "/bag/3015ba-nieuwe-binnenweg-10-e"
23                    }
24                }
25            },
26            {
27                "huisletter": "A",
28                "huisnummer": "10",
29                "huisnummertoevoeging": "",
30                "openbareruimtenaam": "Nieuwe Binnenweg",
31                "postcode": "3015BA",
32                "url": "3015ba-nieuwe-binnenweg-10-a",
33                "woonplaatsnaam": "Rotterdam",
34                "_links": {
35                    "self": {
36                        "href": "/bag/3015ba-nieuwe-binnenweg-10-a"
37                    }
38                }
39            },
40            ...
41        ]
42    }
43}

GET	https://api.overheid.io/bag/{bag_id}

 1 
 2{
 3    "_links": {
 4        "self": {
 5            "href": "/bag/3015ba-nieuwe-binnenweg-10-a?filters%5Bpostcode%5D=3015BA"
 6        }
 7    },
 8    "gemeente": "Rotterdam",
 9    "huisletter": "A",
10    "huisnummer": "10",
11    "huisnummertoevoeging": "",
12    "locatie": {
13        "lat": 51.9167095236329,
14        "lon": 4.47216609904281
15    },
16    "nevenadres": "f",
17    "object_id": 599010000160412,
18    "openbareruimte": "Nieuwe Binnenweg",
19    "oppervlakteverblijfsobject": 109,
20    "pand_id": "0599100000755382",
21    "pandbouwjaar": 1979,
22    "pandstatus": "Pand in gebruik",
23    "postcode": "3015BA",
24    "provincie": "Zuid-Holland",
25    "slug": "3015ba-nieuwe-binnenweg-10-a",
26    "verblijfsobjectgebruiksdoel": "winkelfunctie",
27    "verblijfsobjectstatus": "Verblijfsobject in gebruik",
28    "woonplaats": "Rotterdam",
29    "x": 92047.05,
30    "y": 436865.24
31}