> ## Documentation Index > Fetch the complete documentation index at: https://www.bloxs.io/llms.txt > Use this file to discover all available pages before exploring further. # Get buildings filtered and paged > Get a paged list of existing buildings, optionally filtered to the given parameters. ## OpenAPI ````json POST /api/v1/realestateobjects/buildings/filter { "openapi": "3.0.4", "info": { "title": "RealEstateObjects V1", "description": "Welcome to BETA version of the new RealEstateObjects API - intended for client public testing before the launch of the final version. During this BETA phase, we'll be improving the API based on specific client's feedbacks.", "version": "v1" }, "security": [ {} ], "tags": [ { "name": "Admin" }, { "name": "Buildings" }, { "name": "Complexes" }, { "name": "Generic" }, { "name": "Metadata" }, { "name": "PublishObjects" }, { "name": "ScoringPointTotals" }, { "name": "Sections" }, { "name": "Units" } ], "paths": { "/api/v1/realestateobjects/buildings/filter": { "post": { "tags": [ "Buildings" ], "summary": "Get buildings filtered and paged", "description": "Get a paged list of existing buildings, optionally filtered to the given parameters.", "operationId": "GetBuildingsFilteredPaged", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BuildingSearchRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BuildingSearchResult" } } } } }, "x-d360-narrative-url": "

Get buildings filtered and paged (POST)

This endpoint returns a paged list of existing buildings, optionally filtered by the given parameters.

Integrators use it to display or synchronize multiple buildings at once, for example when populating a list view in an external application, rather than retrieving buildings one at a time.

Request Fields

Field

Type

Required

Description

paging.pageSize

integer

No

Maximum number of buildings to return per page. Defaults to 100 when not given. Minimum 1, maximum 1000.

paging.pageNumber

integer

No

Page number to retrieve. Defaults to 1 when not given. Minimum 1, maximum 9999.

sorting.columnName

string

No

Field the results are sorted on, for example name.

sorting.order

integer

No

Sort direction for columnName. 0 sorts ascending, 1 sorts descending.

filter.name

string

No

Filters results on the name of the building.

filter.reference

string

No

Filters results on the internal identifier of the building.

filter.externalIdentifier

string

No

Filters results on the external identifier of the building.

filter.ownerReference

string

No

Filters results on the reference of the owner the building belongs to.

filter.estateAgentReference

string

No

Filters results on the reference of the estate agent of the building.

filter.addressStreetAndHouseNumber

string

No

Filters results on the street and house number of the building's address.

filter.addressPostalCode

string

No

Filters results on the postal code of the building's address.

filter.addressCity

string

No

Filters results on the city of the building's address.

filter.addressCountryISOCode

string

No

Filters results on the country ISO code of the building's address.

filter.rawFloorArea.from

number (double)

No

Minimum raw floor area to include in the selection, in square meters, measured according to the NEN2580 standard. Decimals are separated with a period.

filter.rawFloorArea.to

number (double)

No

Maximum raw floor area to include in the selection, in square meters, measured according to the NEN2580 standard. Decimals are separated with a period.

filter.rentableFloorArea.from

number (double)

No

Minimum rentable floor area to include in the selection, in square meters, measured according to the NEN2580 standard. Decimals are separated with a period.

filter.rentableFloorArea.to

number (double)

No

Maximum rentable floor area to include in the selection, in square meters, measured according to the NEN2580 standard. Decimals are separated with a period.

filter.usableFloorArea.from

number (double)

No

Minimum usable floor area to include in the selection, in square meters.

filter.usableFloorArea.to

number (double)

No

Maximum usable floor area to include in the selection, in square meters.

filter.underManagementSince.from

string (date-time)

No

Earliest underManagementSince date to include in the selection. ISO 8601 format.

filter.underManagementSince.to

string (date-time)

No

Latest underManagementSince date to include in the selection. ISO 8601 format.

filter.salesDate.from

string (date-time)

No

Earliest salesDate to include in the selection. ISO 8601 format.

filter.salesDate.to

string (date-time)

No

Latest salesDate to include in the selection. ISO 8601 format.

filter.lastModified.from

string (date-time)

No

Earliest lastModified timestamp to include in the selection. ISO 8601 format, UTC.

filter.lastModified.to

string (date-time)

No

Latest lastModified timestamp to include in the selection. ISO 8601 format, UTC.

Response Fields

Field

Type

Required

Description

paging.pageSize

integer

No

Page size used for this result set. Minimum 1, maximum 1000.

paging.pageNumber

integer

No

Page number returned in this result set. Minimum 1, maximum 9999.

sorting.columnName

string

No

Field the results are sorted on.

sorting.order

integer

No

Sort direction for columnName. 0 is ascending, 1 is descending.

buildings

array of object

No

The list of buildings matching the filter, for the requested page. Empty or omitted when no buildings match.

buildings.name

string

No

Name of the building.

buildings.reference

string

No

Internal identifier of the building.

buildings.externalIdentifier

string

No

External identifier of the building, as set by the integrating system.

buildings.ownerReference

string

No

Reference of the owner the building belongs to.

buildings.estateAgentReference

string

No

Reference of the estate agent associated with the building.

buildings.addressStreetAndHouseNumber

string

No

Street and house number of the building's address.

buildings.addressPostalCode

string

No

Postal code of the building's address.

buildings.addressCity

string

No

City of the building's address.

buildings.addressCountryISOCode

string

No

Country ISO code of the building's address.

buildings.rawFloorArea

number (double)

No

Raw floor area of the building, in square meters, measured according to the NEN2580 standard. Decimals are separated with a period.

buildings.rentableFloorArea

number (double)

No

Rentable floor area of the building, in square meters, measured according to the NEN2580 standard. Decimals are separated with a period.

buildings.usableFloorArea

number (double)

No

Usable floor area of the building, in square meters.

buildings.underManagementSince

string (date-time)

No

Date the building came under management. ISO 8601 format.

buildings.salesDate

string (date-time)

No

Date the building was sold, if applicable. ISO 8601 format.

buildings.lastModified

string (date-time)

Yes

Date and time the building was last modified. ISO 8601 format, UTC.

" } } }, "components": { "schemas": { "BuildingSearchRequest": { "type": "object", "properties": { "paging": { "$ref": "#/components/schemas/PagingInfo" }, "sorting": { "$ref": "#/components/schemas/SortingInfo" }, "filter": { "$ref": "#/components/schemas/BuildingSearchRequestFilter" } }, "additionalProperties": false }, "BuildingSearchResult": { "type": "object", "properties": { "paging": { "$ref": "#/components/schemas/PagingInfo" }, "sorting": { "$ref": "#/components/schemas/SortingInfo" }, "buildings": { "type": "array", "items": { "$ref": "#/components/schemas/BuildingSearchResultFilter" }, "nullable": true } }, "additionalProperties": false }, "PagingInfo": { "type": "object", "properties": { "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "format": "int32", "nullable": true }, "pageNumber": { "maximum": 9999, "minimum": 1, "type": "integer", "format": "int32", "nullable": true } }, "additionalProperties": false }, "SortingInfo": { "type": "object", "properties": { "columnName": { "type": "string", "nullable": true }, "order": { "type": "integer", "description": "Ascending = 0\nDescending = 1", "format": "int32", "x-enumNames": [ "Ascending", "Descending" ] } }, "additionalProperties": false }, "BuildingSearchRequestFilter": { "type": "object", "properties": { "name": { "type": "string", "nullable": true }, "reference": { "type": "string", "nullable": true }, "externalIdentifier": { "type": "string", "nullable": true }, "ownerReference": { "type": "string", "nullable": true }, "estateAgentReference": { "type": "string", "nullable": true }, "addressStreetAndHouseNumber": { "type": "string", "nullable": true }, "addressPostalCode": { "type": "string", "nullable": true }, "addressCity": { "type": "string", "nullable": true }, "addressCountryISOCode": { "type": "string", "nullable": true }, "rawFloorArea": { "$ref": "#/components/schemas/CompareFilterModelDecimal" }, "rentableFloorArea": { "$ref": "#/components/schemas/CompareFilterModelDecimal" }, "usableFloorArea": { "$ref": "#/components/schemas/CompareFilterModelDecimal" }, "underManagementSince": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "salesDate": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "lastModified": { "$ref": "#/components/schemas/CompareFilterModelDateTime" } }, "additionalProperties": false }, "BuildingSearchResultFilter": { "type": "object", "properties": { "name": { "type": "string", "nullable": true }, "reference": { "type": "string", "nullable": true }, "externalIdentifier": { "type": "string", "nullable": true }, "ownerReference": { "type": "string", "nullable": true }, "estateAgentReference": { "type": "string", "nullable": true }, "addressStreetAndHouseNumber": { "type": "string", "nullable": true }, "addressPostalCode": { "type": "string", "nullable": true }, "addressCity": { "type": "string", "nullable": true }, "addressCountryISOCode": { "type": "string", "nullable": true }, "rawFloorArea": { "type": "number", "format": "double", "nullable": true }, "rentableFloorArea": { "type": "number", "format": "double", "nullable": true }, "usableFloorArea": { "type": "number", "format": "double", "nullable": true }, "underManagementSince": { "type": "string", "format": "date-time", "nullable": true }, "salesDate": { "type": "string", "format": "date-time", "nullable": true }, "lastModified": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "CompareFilterModelDecimal": { "type": "object", "properties": { "from": { "type": "number", "format": "double", "nullable": true }, "to": { "type": "number", "format": "double", "nullable": true } }, "additionalProperties": false }, "CompareFilterModelDateTime": { "type": "object", "properties": { "from": { "type": "string", "format": "date-time", "nullable": true }, "to": { "type": "string", "format": "date-time", "nullable": true } }, "additionalProperties": false } } } } ````