Get a paged list of existing commercial rent contract objects, optionally filtered to the given parameters.
Get commercial rent contract objects filtered and paged (POST)
This endpoint retrieves a paged list of finalised commercial lease contracts, optionally filtered to a specific real estate object as well as owner, tenant, dates or renewal terms.
A developer calls this endpoint to browse or search contracts from the perspective of a real estate object, for example to find all finalised contracts linked to a specific store or office.
Request Fields
Field | Type | Required | Description |
|---|---|---|---|
paging.pageSize | integer (int32) | No | The number of results to return per page. Minimum 1, maximum 1000. |
paging.pageNumber | integer (int32) | No | The page of results to return. Minimum 1, maximum 9999. |
sorting.columnName | string | No | The name of the field to sort the results by, for example name. |
sorting.order | integer (int32) | No | The sort direction for the field named in sorting.columnName. Allowed values: 0 (ascending), 1 (descending). |
filter.externalIdentifier | string | No | Filters on the identifier of the contract within the system of the requesting party. This identifier is not generated by Bloxs. |
filter.reference | string | No | Filters on the reference of the contract as generated by Bloxs. |
filter.ownerReference | string | No | Filters on the reference of the owner of the real estate object covered by the contract. |
filter.relationReference | string | No | Filters on the reference of the primary tenant who is financially responsible for the contract. |
filter.startDate.from | string (date-time) | No | Lower bound of the contract start date range. ISO 8601 format. |
filter.startDate.to | string (date-time) | No | Upper bound of the contract start date range. ISO 8601 format. |
filter.endDate.from | string (date-time) | No | Lower bound of the contract end date range. ISO 8601 format. |
filter.endDate.to | string (date-time) | No | Upper bound of the contract end date range. ISO 8601 format. |
filter.isStarted | boolean | No | Filters on whether the contract's start date has passed. |
filter.isEnded | boolean | No | Filters on whether the contract's end date has passed. |
filter.automaticExtends | boolean | No | Filters on whether the contract is subject to automatic renewal. Default value false. |
filter.noticeDate.from | string (date-time) | No | Lower bound of the range for the latest cancellation date before automatic renewal takes effect. Relevant only when automaticExtends is true. ISO 8601 format. |
filter.noticeDate.to | string (date-time) | No | Upper bound of the range for the latest cancellation date before automatic renewal takes effect. Relevant only when automaticExtends is true. ISO 8601 format. |
filter.noticePeriod | integer (int32) | No | Filters on the notice period of the contract in months. Relevant when automaticExtends is true. |
filter.depositTypeName | string | No | Filters on the name of the deposit type applied to the contract. |
filter.realEstateObjectReference | string | No | Filters on the reference of the real estate object linked to the contract. |
Response Fields
Field | Type | Required | Description |
|---|---|---|---|
paging.pageSize | integer (int32) | No | The number of results returned per page, echoed back from the request. |
paging.pageNumber | integer (int32) | No | The page number returned, echoed back from the request. |
sorting.columnName | string | No | The field the results were sorted by, echoed back from the request. |
sorting.order | integer (int32) | No | The sort direction applied, echoed back from the request. Allowed values: 0 (ascending), 1 (descending). |
contractObjects.reference | string | No | The reference of the contract as generated by Bloxs. |
contractObjects.externalIdentifier | string | No | The identifier of the contract within the system of the requesting party. |
contractObjects.ownerReference | string | No | The reference of the owner of the real estate object covered by the contract. |
contractObjects.relationReference | string | No | The reference of the primary tenant who is financially responsible for the contract. |
contractObjects.extraRelationReferences | array of string | No | The references of co-tenants on the contract. |
contractObjects.startDate | string (date-time) | Yes | Start date of the contract. ISO 8601 format. |
contractObjects.endDate | string (date-time) | No | End date of the contract. ISO 8601 format. |
contractObjects.isStarted | boolean | Yes | Whether the contract's start date has passed. |
contractObjects.isEnded | boolean | Yes | Whether the contract's end date has passed. |
contractObjects.automaticExtends | boolean | No | Whether the contract is subject to automatic renewal. |
contractObjects.noticeDate | string (date-time) | No | The latest date on which the contract can be cancelled before automatic renewal takes effect. Only relevant when automaticExtends is true. ISO 8601 format. |
contractObjects.noticePeriod | integer (int32) | No | Notice period of the contract in months. Relevant when automaticExtends is true. |
contractObjects.depositTypeName | string | No | The name of the deposit type applied to the contract. |
contractObjects.realEstateObjectReference | string | No | The reference of the real estate object linked to the contract. |
Ascending = 0 Descending = 1
OK
Ascending = 0 Descending = 1