Building List
List assets of type Building.
Query parameters
id:
Numerical filter on the id
field.
code:
Text filter on the code
field. All text field filter methods,
like startswith
, endswith
, icontains
are supported,
created:
Temporal filter on created
. Supports various lookup types
(exact
, lt
, lte
, gt
, gte
; created__exact by default).
Filter values should be specified in ISO 8601 YYYY-MM-DDThh:mm:ssZ format.
last_modified:
Temporal filter on last_modified
. Supports various lookup types
(exact
, lt
, lte
, gt
, gte
; last_modified__exact by default).
Filter values should be specified in ISO 8601 YYYY-MM-DDThh:mm:ssZ format.
organisation
Filter by organisation. Supports lookups on uuid
and name
.
build_year:
Numerical filter on the build_year
field. All numeric field filter methods are supported: gt
, gte
, lt
, lte
, and isnull
.
start/end:
Both query parameters can be used to filter the buildings. They define
an interval [start, end) and should be either in ISO 8601
YYYY-MM-DDThh:mm:ssZ format or in milliseconds since the epoch.
Available lookups are gt
, gte
, lt
, lte
, isnull
.
valid_at:
Return only buildings that are present at given timestamp. If multiple
buildings with the same code and organisation are present, only the
one with the latest start
is returned.
geom_within:
Spatial filter on geometry
, filter operator is ST_within.
Supports WKT, HEXEWKB, and GeoJSON.
geom_intersects:
Spatial filter on geometry
, filter operator is ST_intersects.
Supports WKT, HEXEWKB, and GeoJSON.
in_bbox:
Spatial filter on geometry
. The bounding box format is: min Lat,
min Lon, max Lat, max Lon. Includes assets that overlap the bounding
box.
boundary__id:
Filter on geometry of the region/boundary with the id boundary__id
.
For a list of regions/boundaries, see the boundary endpoint /api/v4/boundaries/
boundary__code:
Filter on geometry of the region/boundary with the id boundary__code
.
For a list of regions/boundaries, see the boundary endpoint /api/v4/boundaries/
boundary__type:
Spatial filter on geometry
, whereby geometry is specified by a
region/boundary object (see below) and filter operator is
ST_Intersects. Available types are COUNTRY, PROVINCE, WATER_BOARD,
MUNICIPALITY, CATCHMENT, POLDER, FIXED_DRAINAGE_LEVEL_AREA,
PUMPED_DRAINAGE_AREA, MAIN_PUMPED_DRAINAGE_AREA, DISTRICT,
NEIGHBOURHOOD, CADASTRE, PLANTATION, FIELD, CITY, and CUSTOM
boundary__name:
Filter on name of the region/boundary with the name
boundary__name
. Requires boundary__type
.
For a list of regions/boundaries, see the boundary endpoint /api/v4/boundaries/
simplify: Simplify the query geometries (in WGS84) using this value as tolerance. A higher value may result in a better response time for detailed geometries. Defaults to 0.00001 degrees (approx. 1 meter). NB: Returned geometries are unaffected.
addresses__postalcode:
Filter on postal code of the building address(es). All text field
filter methods, in particular startswith
, endswith
, contains
are supported, e. g. postalcode__startswith=9
returns buildings
within the postal code area 9.
addresses__house_number: Filter on house number of building address(es).
addresses__house_letter: Filter on house letter of building address(es).
addresses__house_number_suffix: Filter on house number suffix of building address(es).
page_size
The number of results on a single page. Defaults to 10, maximum is 100.
Note that pagination is disabled for the root endpoint: the response
will be truncated to page_size
.
Custom route: by-organisation
Filter assets by organisation UUID. Pagination is enabled on this endpoint.
/api/v4/buildings/by-organisation/
Examples
?id=1
?code=135123
?code__startswith=0100
?created__gte=2017-01-01T00:00:00Z
?last_modified__lt=2018-01-01T00:00:00Z
?organisation__name__startswith=Nelen
?organisation__uuid=61f5a464-c350-44c1-9bc7-d4b42d7f58cb
?organisation__name__icontains=Schuur
?build_year__gt=1997
?start__gt=1900-01-01T00:00:00Z
?start=2019-01-01T02:03:04Z
?start__gt=1900-01-01T00:00:00Z&end__lt=2000-01-01T00:00:00Z
?start__gt=2015-01-01T00:00:00Z&end__isnull=true
?valid_at=2010-01-01T00:00:00Z
?geom_within=POLYGON((4.87 52.73, 4.87 52.79, 4.98 52.79,
4.98 52.73, 4.87 52.73))
?geom_intersects=POLYGON((4.87 52.73, 4.87 52.79, 4.98 52.79,
4.98 52.73, 4.87 52.73))
?in_bbox=4.8,52.7,4.9,52.8
?boundary__id=198
?boundary__code=NL_GM0344
?boundary__type=PROVINCE&boundary__name=Utrecht
?addresses__postalcode=1111AA
?addresses__postalcode=1111AA&addresses__house_number__gte=1&addresses__house_number__lte=99
?addresses__postalcode__startswith=1
?page_size=20
/by-organisation/61f5a464-c350-44c1-9bc7-d4b42d7f58cb/
GET /api/v4/buildings/?format=api
https://demo.lizard.net/api/v4/buildings/15622337/?format=api", "id": 15622337, "code": "0603100000012290", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/61f5a464-c350-44c1-9bc7-d4b42d7f58cb/?format=api", "uuid": "61f5a464-c350-44c1-9bc7-d4b42d7f58cb", "name": "Nelen & Schuurmans Consultancy" }, "geometry": { "type": "Polygon", "coordinates": [ [ [ 4.341155404013666, 52.048935133535814, 0.0 ], [ 4.34103395408161, 52.04885309325346, 0.0 ], [ 4.341094102794063, 52.04881831980003, 0.0 ], [ 4.341220938037654, 52.04889762134308, 0.0 ], [ 4.341215516872214, 52.04890064734164, 0.0 ], [ 4.341215119620124, 52.04890579435667, 0.0 ], [ 4.341192391537908, 52.048918877841565, 0.0 ], [ 4.341184160136638, 52.048918633947025, 0.0 ], [ 4.341178884725309, 52.04892166123843, 0.0 ], [ 4.341155404013666, 52.048935133535814, 0.0 ] ] ] }, "last_modified": "2019-06-25T13:54:17.426094Z", "created": "2019-06-25T13:54:17.426103Z", "image_url": "", "addresses": [ { "street": "Thierenskade", "house_number": 74, "house_letter": "", "house_number_suffix": "", "postalcode": "2282XW", "city": "Rijswijk" }, { "street": "Thierenskade", "house_number": 72, "house_letter": "", "house_number_suffix": "", "postalcode": "2282XW", "city": "Rijswijk" } ], "start": "2010-11-26T00:00:00Z", "end": "2020-07-10T00:00:00Z", "build_year": 1934 }, { "url": "https://demo.lizard.net/api/v4/buildings/15622338/?format=api", "id": 15622338, "code": "0603100000012291", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/61f5a464-c350-44c1-9bc7-d4b42d7f58cb/?format=api", "uuid": "61f5a464-c350-44c1-9bc7-d4b42d7f58cb", "name": "Nelen & Schuurmans Consultancy" }, "geometry": { "type": "Polygon", "coordinates": [ [ [ 4.341220938037654, 52.04889762134308, 0.0 ], [ 4.341094102794063, 52.04881831980003, 0.0 ], [ 4.341157339974758, 52.04878176701285, 0.0 ], [ 4.341280881343372, 52.048862899903085, 0.0 ], [ 4.341259260351674, 52.04887539997638, 0.0 ], [ 4.341256201359269, 52.04887716156672, 0.0 ], [ 4.341255821837332, 52.04888217390839, 0.0 ], [ 4.341233058538314, 52.0488955177615, 0.0 ], [ 4.341224985166464, 52.04889537414936, 0.0 ], [ 4.341220938037654, 52.04889762134308, 0.0 ] ] ] }, "last_modified": "2019-06-25T13:54:17.426192Z", "created": "2019-06-25T13:54:17.426200Z", "image_url": "", "addresses": [ { "street": "Thierenskade", "house_number": 76, "house_letter": "", "house_number_suffix": "", "postalcode": "2282XW", "city": "Rijswijk" }, { "street": "Thierenskade", "house_number": 78, "house_letter": "", "house_number_suffix": "", "postalcode": "2282XW", "city": "Rijswijk" } ], "start": "2010-11-26T00:00:00Z", "end": null, "build_year": 1934 }, { "url": "https://demo.lizard.net/api/v4/buildings/15622339/?format=api", "id": 15622339, "code": "0603100000012292", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/61f5a464-c350-44c1-9bc7-d4b42d7f58cb/?format=api", "uuid": "61f5a464-c350-44c1-9bc7-d4b42d7f58cb", "name": "Nelen & Schuurmans Consultancy" }, "geometry": { "type": "Polygon", "coordinates": [ [ [ 4.341917458502735, 52.049238662534634, 0.0 ], [ 4.34185104295904, 52.049277093127394, 0.0 ], [ 4.34172690473694, 52.04919582971336, 0.0 ], [ 4.341732831561414, 52.04919237672108, 0.0 ], [ 4.341722926060783, 52.04918578094851, 0.0 ], [ 4.341764091970596, 52.04916228129541, 0.0 ], [ 4.341773997681996, 52.04916886807766, 0.0 ], [ 4.341788081250249, 52.04916074143725, 0.0 ], [ 4.34177816117242, 52.04915414553993, 0.0 ], [ 4.341783790801597, 52.04915093260275, 0.0 ], [ 4.341831608670848, 52.049182206375185, 0.0 ], [ 4.34184732431214, 52.04918347844894, 0.0 ], [ 4.341860663359823, 52.04919100355991, 0.0 ], [ 4.341858602886765, 52.049200576246605, 0.0 ], [ 4.341917458502735, 52.049238662534634, 0.0 ] ] ] }, "last_modified": "2019-06-25T13:54:17.426290Z", "created": "2019-06-25T13:54:17.426298Z", "image_url": "", "addresses": [ { "street": "Thierenskade", "house_number": 19, "house_letter": "", "house_number_suffix": "", "postalcode": "2282XS", "city": "Rijswijk" } ], "start": "2010-11-26T00:00:00Z", "end": "2011-10-03T00:00:00Z", "build_year": 1933 }, { "url": "https://demo.lizard.net/api/v4/buildings/15622340/?format=api", "id": 15622340, "code": "0603100000012292", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/61f5a464-c350-44c1-9bc7-d4b42d7f58cb/?format=api", "uuid": "61f5a464-c350-44c1-9bc7-d4b42d7f58cb", "name": "Nelen & Schuurmans Consultancy" }, "geometry": { "type": "Polygon", "coordinates": [ [ [ 4.341917458502735, 52.049238662534634, 0.0 ], [ 4.341979258763077, 52.04927926480412, 0.0 ], [ 4.341945459881975, 52.049298820942354, 0.0 ], [ 4.34188365941571, 52.049258227642135, 0.0 ], [ 4.34185104295904, 52.049277093127394, 0.0 ], [ 4.34172690473694, 52.04919582971336, 0.0 ], [ 4.341732831561414, 52.04919237672108, 0.0 ], [ 4.341722926060783, 52.04918578094851, 0.0 ], [ 4.341764091970596, 52.04916228129541, 0.0 ], [ 4.341773997681996, 52.04916886807766, 0.0 ], [ 4.341788081250249, 52.04916074143725, 0.0 ], [ 4.34177816117242, 52.04915414553993, 0.0 ], [ 4.341783790801597, 52.04915093260275, 0.0 ], [ 4.341831608670848, 52.049182206375185, 0.0 ], [ 4.34184732431214, 52.04918347844894, 0.0 ], [ 4.341860663359823, 52.04919100355991, 0.0 ], [ 4.341858602886765, 52.049200576246605, 0.0 ], [ 4.341917458502735, 52.049238662534634, 0.0 ] ] ] }, "last_modified": "2024-01-26T06:35:56.686768Z", "created": "2019-06-25T13:54:17.426398Z", "image_url": "", "addresses": [ { "street": "Thierenskade", "house_number": 19, "house_letter": "", "house_number_suffix": "", "postalcode": "2282XS", "city": "Rijswijk" } ], "start": "2011-10-03T00:00:00Z", "end": "2023-01-09T00:00:00Z", "build_year": 1933 }, { "url": "https://demo.lizard.net/api/v4/buildings/15622343/?format=api", "id": 15622343, "code": "0603100000012295", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/61f5a464-c350-44c1-9bc7-d4b42d7f58cb/?format=api", "uuid": "61f5a464-c350-44c1-9bc7-d4b42d7f58cb", "name": "Nelen & Schuurmans Consultancy" }, "geometry": { "type": "Polygon", "coordinates": [ [ [ 4.342256614451024, 52.048920567798795, 0.0 ], [ 4.342242238797702, 52.0489268492132, 0.0 ], [ 4.342221186618143, 52.04891186697115, 0.0 ], [ 4.342307433676242, 52.04886260092852, 0.0 ], [ 4.342297455703244, 52.048855986583554, 0.0 ], [ 4.342334944630338, 52.048834467585785, 0.0 ], [ 4.342344922604122, 52.04884108192758, 0.0 ], [ 4.342352576525756, 52.04883670939909, 0.0 ], [ 4.342361737938707, 52.0488427052614, 0.0 ], [ 4.342369286681756, 52.04883846662971, 0.0 ], [ 4.342403113757456, 52.04886140933824, 0.0 ], [ 4.342395550437811, 52.048865647842796, 0.0 ], [ 4.342404954619353, 52.04887186158489, 0.0 ], [ 4.34241246005501, 52.048867604588764, 0.0 ], [ 4.342446421923211, 52.04889039567187, 0.0 ], [ 4.342438901911022, 52.04889465254085, 0.0 ], [ 4.342453702131833, 52.04890453660555, 0.0 ], [ 4.342450548616042, 52.04892534450715, 0.0 ], [ 4.342374131268131, 52.048920738512784, 0.0 ], [ 4.34236392488158, 52.04891391540648, 0.0 ], [ 4.342354753059186, 52.04891898457898, 0.0 ], [ 4.342353975080912, 52.048920460817406, 0.0 ], [ 4.34226688954272, 52.048916326397126, 0.0 ], [ 4.342256614451024, 52.048920567798795, 0.0 ] ] ] }, "last_modified": "2019-06-25T13:54:17.426687Z", "created": "2019-06-25T13:54:17.426695Z", "image_url": "", "addresses": [ { "street": "Thierenskade", "house_number": 27, "house_letter": "", "house_number_suffix": "", "postalcode": "2282XS", "city": "Rijswijk" } ], "start": "2010-11-26T00:00:00Z", "end": "2020-08-14T00:00:00Z", "build_year": 1938 }, { "url": "https://demo.lizard.net/api/v4/buildings/15622345/?format=api", "id": 15622345, "code": "0603100000012297", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/61f5a464-c350-44c1-9bc7-d4b42d7f58cb/?format=api", "uuid": "61f5a464-c350-44c1-9bc7-d4b42d7f58cb", "name": "Nelen & Schuurmans Consultancy" }, "geometry": { "type": "Polygon", "coordinates": [ [ [ 4.343841791397605, 52.04799868834164, 0.0 ], [ 4.343845111739275, 52.04794128876392, 0.0 ], [ 4.343888095322872, 52.04794228978041, 0.0 ], [ 4.343906731239189, 52.04794272453411, 0.0 ], [ 4.343907490928177, 52.04792951783155, 0.0 ], [ 4.343951640131323, 52.04793054712818, 0.0 ], [ 4.343950880455336, 52.04794375383111, 0.0 ], [ 4.343989915311071, 52.04794466589877, 0.0 ], [ 4.343986595154755, 52.04800206548098, 0.0 ], [ 4.343841791397605, 52.04799868834164, 0.0 ] ] ] }, "last_modified": "2019-06-25T13:54:17.426889Z", "created": "2019-06-25T13:54:17.426898Z", "image_url": "", "addresses": [ { "street": "Delftweg", "house_number": 29, "house_letter": "", "house_number_suffix": "", "postalcode": "2289AK", "city": "Rijswijk" } ], "start": "2011-10-03T00:00:00Z", "end": "2020-01-23T00:00:00Z", "build_year": 1957 }, { "url": "https://demo.lizard.net/api/v4/buildings/15622347/?format=api", "id": 15622347, "code": "0603100000012300", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/61f5a464-c350-44c1-9bc7-d4b42d7f58cb/?format=api", "uuid": "61f5a464-c350-44c1-9bc7-d4b42d7f58cb", "name": "Nelen & Schuurmans Consultancy" }, "geometry": { "type": "Polygon", "coordinates": [ [ [ 4.33901438813872, 52.049316662626, 0.0 ], [ 4.339008276378626, 52.04931243745819, 0.0 ], [ 4.339031875650428, 52.04929954191871, 0.0 ], [ 4.339036793430947, 52.04929685311145, 0.0 ], [ 4.33907200361493, 52.049321687738605, 0.0 ], [ 4.339097668764911, 52.0493077319234, 0.0 ], [ 4.339167199156487, 52.04935618871984, 0.0 ], [ 4.339112396748073, 52.04938606497459, 0.0 ], [ 4.33901438813872, 52.049316662626, 0.0 ] ] ] }, "last_modified": "2024-01-26T06:35:56.686789Z", "created": "2019-06-25T13:54:17.427102Z", "image_url": "", "addresses": [ { "street": "Abeelstraat", "house_number": 4, "house_letter": "", "house_number_suffix": "", "postalcode": "2282XJ", "city": "Rijswijk" } ], "start": "2011-10-03T00:00:00Z", "end": "2023-05-30T00:00:00Z", "build_year": 1927 }, { "url": "https://demo.lizard.net/api/v4/buildings/15622348/?format=api", "id": 15622348, "code": "0603100000012301", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/61f5a464-c350-44c1-9bc7-d4b42d7f58cb/?format=api", "uuid": "61f5a464-c350-44c1-9bc7-d4b42d7f58cb", "name": "Nelen & Schuurmans Consultancy" }, "geometry": { "type": "Polygon", "coordinates": [ [ [ 4.339112081124178, 52.04938584643618, 0.0 ], [ 4.339055773368595, 52.04941650027705, 0.0 ], [ 4.338987088741079, 52.04936928239917, 0.0 ], [ 4.339019880805703, 52.049351066451344, 0.0 ], [ 4.338990182187472, 52.04932993927799, 0.0 ], [ 4.33901438813872, 52.049316662626, 0.0 ], [ 4.339112081124178, 52.04938584643618, 0.0 ] ] ] }, "last_modified": "2019-06-25T13:54:17.427192Z", "created": "2019-06-25T13:54:17.427200Z", "image_url": "", "addresses": [ { "street": "Abeelstraat", "house_number": 2, "house_letter": "", "house_number_suffix": "", "postalcode": "2282XJ", "city": "Rijswijk" } ], "start": "2010-11-26T00:00:00Z", "end": "2011-10-03T00:00:00Z", "build_year": 1927 }, { "url": "https://demo.lizard.net/api/v4/buildings/15622349/?format=api", "id": 15622349, "code": "0603100000012301", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/61f5a464-c350-44c1-9bc7-d4b42d7f58cb/?format=api", "uuid": "61f5a464-c350-44c1-9bc7-d4b42d7f58cb", "name": "Nelen & Schuurmans Consultancy" }, "geometry": { "type": "Polygon", "coordinates": [ [ [ 4.339112396748073, 52.04938606497459, 0.0 ], [ 4.33905570433385, 52.04941695808805, 0.0 ], [ 4.338987088741079, 52.04936928239917, 0.0 ], [ 4.338950642970243, 52.04934429292955, 0.0 ], [ 4.338984085003906, 52.04932571423865, 0.0 ], [ 4.339008276378626, 52.04931243745819, 0.0 ], [ 4.33901438813872, 52.049316662626, 0.0 ], [ 4.339112396748073, 52.04938606497459, 0.0 ] ] ] }, "last_modified": "2024-01-26T06:35:56.686798Z", "created": "2019-06-25T13:54:17.427297Z", "image_url": "", "addresses": [ { "street": "Abeelstraat", "house_number": 2, "house_letter": "", "house_number_suffix": "", "postalcode": "2282XJ", "city": "Rijswijk" } ], "start": "2011-10-03T00:00:00Z", "end": "2023-05-30T00:00:00Z", "build_year": 1927 }, { "url": "https://demo.lizard.net/api/v4/buildings/15622350/?format=api", "id": 15622350, "code": "0603100000012302", "organisation": { "url": "https://demo.lizard.net/api/v4/organisations/61f5a464-c350-44c1-9bc7-d4b42d7f58cb/?format=api", "uuid": "61f5a464-c350-44c1-9bc7-d4b42d7f58cb", "name": "Nelen & Schuurmans Consultancy" }, "geometry": { "type": "Polygon", "coordinates": [ [ [ 4.338992427453126, 52.05142710242403, 0.0 ], [ 4.339014004920957, 52.05148316841173, 0.0 ], [ 4.338904455716046, 52.05149921805316, 0.0 ], [ 4.338904290475566, 52.05149880310079, 0.0 ], [ 4.338885541217722, 52.05150127890447, 0.0 ], [ 4.338891937058142, 52.05149463023956, 0.0 ], [ 4.338926815456829, 52.051458365534536, 0.0 ], [ 4.338992427453126, 52.05142710242403, 0.0 ] ] ] }, "last_modified": "2019-06-25T13:54:17.427385Z", "created": "2019-06-25T13:54:17.427393Z", "image_url": "", "addresses": [ { "street": "Ottoburgstraat", "house_number": 1, "house_letter": "C", "house_number_suffix": "", "postalcode": "2282EG", "city": "Rijswijk" } ], "start": "2010-11-26T00:00:00Z", "end": "2011-10-03T00:00:00Z", "build_year": 1923 } ][ { "url": "