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

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.

" } } }, "components": { "schemas": { "PublishedObjectsSearchRequest": { "type": "object", "properties": { "paging": { "$ref": "#/components/schemas/PagingInfo" }, "sorting": { "$ref": "#/components/schemas/SortingInfo" }, "filter": { "$ref": "#/components/schemas/PublishedObjectsSearchRequestFilter" } }, "additionalProperties": false }, "PublishedObjectsSearchResponse": { "type": "object", "properties": { "paging": { "$ref": "#/components/schemas/PagingInfo" }, "sorting": { "$ref": "#/components/schemas/SortingInfo" }, "publications": { "type": "array", "items": { "$ref": "#/components/schemas/PublishedObjectsSearchResponseData" }, "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 }, "PublishedObjectsSearchRequestFilter": { "type": "object", "properties": { "reference": { "type": "string", "nullable": true }, "externalIdentifier": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "addressStreetAndHouseNumber": { "type": "string", "nullable": true }, "addressPostalCode": { "type": "string", "nullable": true }, "addressCity": { "type": "string", "nullable": true }, "addressCountryCode": { "type": "string", "nullable": true }, "publishedStatus": { "type": "integer", "description": "Available = 0\nReserved = 1\nRented = 2\nUnderOption = 3", "format": "int32", "nullable": true, "x-enumNames": [ "Available", "Reserved", "Rented", "UnderOption" ] }, "lastModified": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "lastModified_Publication": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "publishedDate": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "availableFrom": { "$ref": "#/components/schemas/CompareFilterModelDateTime" } }, "additionalProperties": false }, "PublishedObjectsSearchResponseData": { "type": "object", "properties": { "reference": { "type": "string", "nullable": true }, "externalIdentifier": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "addressStreetAndHouseNumber": { "type": "string", "nullable": true }, "addressPostalCode": { "type": "string", "nullable": true }, "addressCity": { "type": "string", "nullable": true }, "addressCountryCode": { "type": "string", "nullable": true }, "publishedStatus": { "type": "integer", "description": "Available = 0\nReserved = 1\nRented = 2\nUnderOption = 3", "format": "int32", "x-enumNames": [ "Available", "Reserved", "Rented", "UnderOption" ] }, "lastModified": { "type": "string", "format": "date-time" }, "lastModified_Publication": { "type": "string", "format": "date-time" }, "publishedDate": { "type": "string", "format": "date" }, "availableFrom": { "type": "string", "format": "date", "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 } } } } ````