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

Prev Next
Get
/api/v1/realestateobjects/sections/filter

Get a paged list of existing sections, optionally filtered to the given parameters. A param-based alternative to the '/filter' POST endpoint.

Get sections filtered and paged

This endpoint returns a paged list of existing sections, optionally filtered by the given query 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

pageSize

integer

No

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

pageNumber

integer

No

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

name

string

No

Filters results on the name of the section.

reference

string

No

Filters results on the internal identifier of the section.

externalIdentifier

string

No

Filters results on the external identifier of the section.

complexReference

string

No

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

ownerReference

string

No

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

estateAgentReference

string

No

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

addressStreetAndHouseNumber

string

No

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

addressPostalCode

string

No

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

addressCity

string

No

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

addressCountryISOCode

string

No

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


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.

Security
Query parameters
pageSize
integer (int32)

The requested page size. Defaults to 100 when not given.

Minimum1
Maximum1000
pageNumber
integer (int32)

The requested page number. Defaults to 1 when not given.

Minimum1
Maximum9999
name
string

Optional filter on the name of the section.

reference
string

Optional filter on the reference of the section.

externalIdentifier
string

Optional filter on the external API identifier of the section.

complexReference
string

Optional filter on the reference of the complex the section belongs to.

ownerReference
string

Optional filter on the reference of the owner of the unit.

estateAgentReference
string

Optional filter on the reference of the estate agent of the unit.

addressStreetAndHouseNumber
string

Optional filter on the street and house number of the address of the section.

addressPostalCode
string

Optional filter on the postal code of the address of the section.

addressCity
string

Optional filter on the city of the address of the section.

addressCountryISOCode
string

Optional filter on the country ISO code of the address of the section.

Responses
200

OK

Expand All
object
paging
object (PagingInfo)
pageSize
integer (int32) | null
Minimum1
Maximum1000
pageNumber
integer (int32) | null
Minimum1
Maximum9999
sorting
object (SortingInfo)
columnName
string | null
order
integer (int32)

Ascending = 0 Descending = 1

sections
Array of object (SectionSearchResultFilter) | null
object
name
string | null
reference
string | null
externalIdentifier
string | null
complexReference
string | null
addressStreetAndHouseNumber
string | null
addressPostalCode
string | null
addressCity
string | null
addressCountryISOCode
string | null
rawFloorArea
number (double) | null
rentableFloorArea
number (double) | null
usableFloorArea
number (double) | null
underManagementSince
string (date-time) | null
salesDate
string (date-time) | null
lastModified
string (date-time)