> ## 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 general sales contract objects filtered and paged > Get a paged list of existing general sales contract objects, optionally filtered to the given parameters. ## OpenAPI ````json POST /api/v1/contracts/general/contractobjectsfilter { "openapi": "3.0.4", "info": { "title": "Concept SalesContracts V1", "description": "Welcome to BETA version of the new Sales Concept Contracts 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": "CommercialRentContracts" }, { "name": "Concept CommercialRent" }, { "name": "Concept PrivateRent" }, { "name": "GeneralSalesContracts" }, { "name": "Metadata" }, { "name": "PrivateRentContracts" }, { "name": "SupplierContracts" } ], "paths": { "/api/v1/contracts/general/contractobjectsfilter": { "post": { "tags": [ "GeneralSalesContracts" ], "summary": "Get general sales contract objects filtered and paged", "description": "Get a paged list of existing general sales contract objects, optionally filtered to the given parameters.", "operationId": "GetGeneralSalesContractObjectsFilteredPaged", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SalesContractObjectSearchRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SalesContractObjectSearchResult" } } } } }, "x-d360-narrative-url": "

Get general sales contract objects filtered and paged (POST)

This endpoint returns a paged list of the object-level links between real estate objects and existing, finalized general sales contracts, optionally filtered by the given parameters, with sorting support.

Integrators use it to search across contract-to-object relationships directly, for example to find every contract linked to a specific real estate object, rather than retrieving a contract first and then its objects separately.

Request Fields

Field

Type

Required

Description

paging.pageSize

integer

No

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

sorting.order

integer

No

Sort direction for columnName. Valid values are 0 (Ascending) or 1 (Descending).

filter.reference

string

No

Filters results on the internal identifier of the contract.

filter.externalIdentifier

string

No

Filters results on the external identifier of the contract.

filter.ownerReference

string

No

Filters results on the reference of the owner of the object subject to the contract.

filter.relationReference

string

No

Filters results on the reference of the primary tenant financially responsible for the contract.

filter.realEstateObjectReference

string

No

Filters results on the reference of the real estate object linked to the contract.

filter.startDate.from

string (date-time)

No

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

filter.startDate.to

string (date-time)

No

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

filter.endDate.from

string (date-time)

No

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

filter.endDate.to

string (date-time)

No

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

filter.isStarted

boolean

No

Filters results on whether the contract has started.

filter.isEnded

boolean

No

Filters results on whether the contract has ended.

filter.automaticExtends

boolean

No

Filters results on whether the contract renews automatically.

filter.noticeDate.from

string (date-time)

No

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

filter.noticeDate.to

string (date-time)

No

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

filter.noticePeriod

integer

No

Filters results on the notice period, in months.

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.

contractObjects

array of object

No

The list of contract-to-object links matching the filter, for the requested page. Empty or omitted when none match.

contractObjects.salesContractReference

string

No

Internal identifier of the contract, generated by Bloxs.

contractObjects.salesContractExternalIdentifier

string

No

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

contractObjects.ownerReference

string

No

Reference of the owner of the object subject to the contract.

contractObjects.relationReference

string

No

Reference of the primary tenant financially responsible for the contract.

contractObjects.realEstateObjectReference

string

No

Reference of the real estate object linked to the contract.

contractObjects.startDate

string (date-time)

Yes

Start date of the contract for this object.

contractObjects.endDate

string (date-time)

No

End date of the contract for this object, if set.

contractObjects.isStarted

boolean

Yes

Indicates whether the contract has started.

contractObjects.isEnded

boolean

Yes

Indicates whether the contract has ended.

contractObjects.automaticExtends

boolean

No

Indicates whether the contract renews automatically.

contractObjects.noticeDate

string (date-time)

No

Latest date the contract can be cancelled before an automatic extension takes effect.

contractObjects.noticePeriod

integer

No

Notice period of the contract, in months.

" } } }, "components": { "schemas": { "SalesContractObjectSearchRequest": { "type": "object", "properties": { "paging": { "$ref": "#/components/schemas/PagingInfo" }, "sorting": { "$ref": "#/components/schemas/SortingInfo" }, "filter": { "$ref": "#/components/schemas/SalesContractObjectSearchRequestFilter" } }, "additionalProperties": false }, "SalesContractObjectSearchResult": { "type": "object", "properties": { "paging": { "$ref": "#/components/schemas/PagingInfo" }, "sorting": { "$ref": "#/components/schemas/SortingInfo" }, "contractObjects": { "type": "array", "items": { "$ref": "#/components/schemas/SalesContractObjectSearchResultFilter" }, "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 }, "SalesContractObjectSearchRequestFilter": { "type": "object", "properties": { "externalIdentifier": { "type": "string", "nullable": true }, "reference": { "type": "string", "nullable": true }, "ownerReference": { "type": "string", "nullable": true }, "relationReference": { "type": "string", "nullable": true }, "startDate": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "endDate": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "isStarted": { "type": "boolean", "nullable": true }, "isEnded": { "type": "boolean", "nullable": true }, "automaticExtends": { "type": "boolean", "nullable": true }, "noticeDate": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "noticePeriod": { "type": "integer", "format": "int32", "nullable": true }, "realEstateObjectReference": { "type": "string", "nullable": true } }, "additionalProperties": false }, "SalesContractObjectSearchResultFilter": { "type": "object", "properties": { "reference": { "type": "string", "nullable": true }, "externalIdentifier": { "type": "string", "nullable": true }, "ownerReference": { "type": "string", "nullable": true }, "relationReference": { "type": "string", "nullable": true }, "extraRelationReferences": { "type": "array", "items": { "type": "string" }, "nullable": true }, "startDate": { "type": "string", "format": "date-time" }, "endDate": { "type": "string", "format": "date-time", "nullable": true }, "isStarted": { "type": "boolean" }, "isEnded": { "type": "boolean" }, "automaticExtends": { "type": "boolean", "nullable": true }, "noticeDate": { "type": "string", "format": "date-time", "nullable": true }, "noticePeriod": { "type": "integer", "format": "int32", "nullable": true }, "realEstateObjectReference": { "type": "string", "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 } } } } ````