Get a paged list of existing commercial rent contracts, optionally filtered to the given parameters.
Get commercial rent contracts filtered and paged (POST)
This endpoint retrieves a paged list of existing finalised commercial lease contracts, optionally filtered by owner, tenant, dates, or renewal terms.
A developer calls this endpoint to browse or search multiple finalised contracts at once, rather than retrieving a single known contract. This endpoint only returns contracts that have already been finalised in the Bloxs application.
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. |
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). |
contracts.reference | string | No | The reference of the contract as generated by Bloxs. |
contracts.externalIdentifier | string | No | The identifier of the contract within the system of the requesting party. |
contracts.ownerReference | string | No | The reference of the owner of the real estate object covered by the contract. |
contracts.relationReference | string | No | The reference of the primary tenant who is financially responsible for the contract. |
contracts.extraRelationReferences | array of string | No | The references of co-tenants on the contract. |
contracts.startDate | string (date-time) | Yes | Start date of the contract. ISO 8601 format. |
contracts.endDate | string (date-time) | No | End date of the contract. ISO 8601 format. |
contracts.isStarted | boolean | Yes | Whether the contract's start date has passed. |
contracts.isEnded | boolean | Yes | Whether the contract's end date has passed. |
contracts.automaticExtends | boolean | No | Whether the contract is subject to automatic renewal. |
contracts.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. |
contracts.noticePeriod | integer (int32) | No | Notice period of the contract in months. Relevant when automaticExtends is true. |
contracts.depositTypeName | string | No | The name of the deposit type applied to the contract. |
Ascending = 0 Descending = 1
OK
Ascending = 0 Descending = 1