> ## 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 sections filtered and paged > Get a paged list of existing sections, optionally filtered to the given parameters. ## OpenAPI ````json POST /api/v1/realestateobjects/sections/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/sections/filter": { "post": { "tags": [ "Sections" ], "summary": "Get sections filtered and paged", "description": "Get a paged list of existing sections, optionally filtered to the given parameters.", "operationId": "GetSectionsFilteredPaged", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SectionSearchRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SectionSearchResult" } } } } }, "x-d360-narrative-url": "

Get sections filtered and paged (POST)

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

Integrators use it to display or synchronize multiple sections at once, for example when populating a list view in an external application.

Request Fields

Field

Type

Required

Description

paging.pageSize

integer

No

Maximum number of sections 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 section.

filter.reference

string

No

Filters results on the internal identifier of the section.

filter.externalIdentifier

string

No

Filters results on the external identifier of the section.

filter.complexReference

string

No

Filters results on the reference of the complex the section belongs to.

filter.ownerReference

string

No

Filters results on the reference of the owner of the section.

filter.estateAgentReference

string

No

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

filter.addressStreetAndHouseNumber

string

No

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

filter.addressPostalCode

string

No

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

filter.addressCity

string

No

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

filter.addressCountryISOCode

string

No

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

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.

sections

array of object

No

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

sections.name

string

No

Name of the section.

sections.reference

string

No

Internal identifier of the section.

sections.externalIdentifier

string

No

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

sections.complexReference

string

No

Reference of the complex the section belongs to.

sections.addressStreetAndHouseNumber

string

No

Street and house number of the section's address.

sections.addressPostalCode

string

No

Postal code of the section's address.

sections.addressCity

string

No

City of the section's address.

sections.addressCountryISOCode

string

No

Country ISO code of the section's address.

sections.rawFloorArea

number (double)

No

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

sections.rentableFloorArea

number (double)

No

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

sections.usableFloorArea

number (double)

No

Usable floor area of the section, in square meters.

sections.underManagementSince

string (date-time)

No

Date the section came under management. ISO 8601 format.

sections.salesDate

string (date-time)

No

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

sections.lastModified

string (date-time)

Yes

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

" } } }, "components": { "schemas": { "SectionSearchRequest": { "type": "object", "properties": { "paging": { "$ref": "#/components/schemas/PagingInfo" }, "sorting": { "$ref": "#/components/schemas/SortingInfo" }, "filter": { "$ref": "#/components/schemas/SectionSearchRequestFilter" } }, "additionalProperties": false }, "SectionSearchResult": { "type": "object", "properties": { "paging": { "$ref": "#/components/schemas/PagingInfo" }, "sorting": { "$ref": "#/components/schemas/SortingInfo" }, "sections": { "type": "array", "items": { "$ref": "#/components/schemas/SectionSearchResultFilter" }, "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 }, "SectionSearchRequestFilter": { "type": "object", "properties": { "name": { "type": "string", "nullable": true }, "reference": { "type": "string", "nullable": true }, "externalIdentifier": { "type": "string", "nullable": true }, "complexReference": { "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 }, "underManagementSince": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "salesDate": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "lastModified": { "$ref": "#/components/schemas/CompareFilterModelDateTime" } }, "additionalProperties": false }, "SectionSearchResultFilter": { "type": "object", "properties": { "name": { "type": "string", "nullable": true }, "reference": { "type": "string", "nullable": true }, "externalIdentifier": { "type": "string", "nullable": true }, "complexReference": { "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 }, "CompareFilterModelDateTime": { "type": "object", "properties": { "from": { "type": "string", "format": "date-time", "nullable": true }, "to": { "type": "string", "format": "date-time", "nullable": true } }, "additionalProperties": false } } } } ````