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 published objects filtered and paged

Prev Next
Post
/api/v1/realestateobjects/publish/filter

Get a paged list of existing published objects, optionally filtered to the given parameters.

Get published objects filtered and paged (POST)

This endpoint returns a paged list of currently published real estate objects, optionally filtered by the given parameters, with sorting support.

Integrators use it to review all published objects at once, for example to check which ones need a data correction.


Request Fields

Field

Type

Required

Description

paging.pageSize

integer

No

Maximum number of objects 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.reference

string

No

Filters results on the internal identifier of the object.

filter.externalIdentifier

string

No

Filters results on the external identifier of the object.

filter.name

string

No

Filters results on the custom display name of the object.

filter.addressStreetAndHouseNumber

string

No

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

filter.addressPostalCode

string

No

Filters results on the postal code of the published object's address.

filter.addressCity

string

No

Filters results on the city of the published object's address.

filter.addressCountryCode

string

No

Filters results on the country code of the published object's address.

filter.publishedStatus

integer

No

Filters results on publication status. Valid values are 0 (Available), 1 (Reserved), 2 (Rented), or 3 (UnderOption).

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.

filter.lastModified_Publication.from

string (date-time)

No

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

filter.lastModified_Publication.to

string (date-time)

No

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

filter.publishedDate.from

string (date-time)

No

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

filter.publishedDate.to

string (date-time)

No

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

filter.availableFrom.from

string (date-time)

No

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

filter.availableFrom.to

string (date-time)

No

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


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.

publications

array of object

No

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

publications.reference

string

No

Internal identifier of the published object.

publications.externalIdentifier

string

No

External identifier of the published object.

publications.name

string

No

Custom display name of the published object.

publications.addressStreetAndHouseNumber

string

No

Street and house number of the published object's address.

publications.addressPostalCode

string

No

Postal code of the published object's address.

publications.addressCity

string

No

City of the published object's address.

publications.addressCountryCode

string

No

Country code of the published object's address.

publications.publishedStatus

integer

Yes

Publication status of the object. Valid values are 0 (Available), 1 (Reserved), 2 (Rented), or 3 (UnderOption).

publications.lastModified

string (date-time)

Yes

Timestamp of the last modification to the object itself. ISO 8601 format, UTC.

publications.lastModified_Publication

string (date-time)

Yes

Timestamp of the last modification made to any of the custom published properties. ISO 8601 format, UTC.

publications.publishedDate

string (date)

Yes

Date the object was initially published.

publications.availableFrom

string (date)

No

Date from which the object is available.

Security
Body parameters
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

filter
object (PublishedObjectsSearchRequestFilter)
reference
string | null
externalIdentifier
string | null
name
string | null
addressStreetAndHouseNumber
string | null
addressPostalCode
string | null
addressCity
string | null
addressCountryCode
string | null
publishedStatus
integer (int32) | null

Available = 0 Reserved = 1 Rented = 2 UnderOption = 3

lastModified
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
lastModified_Publication
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
publishedDate
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
availableFrom
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
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

publications
Array of object (PublishedObjectsSearchResponseData) | null
object
reference
string | null
externalIdentifier
string | null
name
string | null
addressStreetAndHouseNumber
string | null
addressPostalCode
string | null
addressCity
string | null
addressCountryCode
string | null
publishedStatus
integer (int32)

Available = 0 Reserved = 1 Rented = 2 UnderOption = 3

lastModified
string (date-time)
lastModified_Publication
string (date-time)
publishedDate
string (date)
availableFrom
string (date) | null