> ## 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 concept commercial rent contracts filtered and paged > Get a paged list of existing concept commercial rent contracts, optionally filtered to the given parameters. ## OpenAPI ````json POST /api/v1/contracts/conceptcommercialrent/filter { "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/conceptcommercialrent/filter": { "post": { "tags": [ "Concept CommercialRent" ], "summary": "Get concept commercial rent contracts filtered and paged", "description": "Get a paged list of existing concept commercial rent contracts, optionally filtered to the given parameters.", "operationId": "GetConceptCommercialRentContractsFilteredPaged", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FilterConceptSalesContractRequestPagingModel" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FilterConceptSalesContractResponsePagingModel" } } } } }, "x-d360-narrative-url": "

Get concept commercial rent contracts filtered and paged (POST)

This endpoint retrieves a paged list of existing concept commercial lease contracts, optionally filtered by owner, tenant, indexation method or date ranges.

A concept commercial lease contract is a draft contract for stores, offices and other commercial spaces, created before the contract is finalised in the Bloxs application.

Use this endpoint when a caller needs to browse or search multiple draft contracts at once. To retrieve a single known contract, use the Get a concept commercial rent contract endpoint instead.

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 assigned to the contract by the calling system. This identifier is not generated by Bloxs.

filter.name

string

No

Filters on the free-text name of the contract, used for search purposes.

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.indexationMethod

string

No

Filters on the indexation method applied to the contract, for example a fixed yearly percentage or an inflation-linked method. The available methods are configured in Bloxs and can be retrieved through the indexation methods endpoint.

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.nextIndexDate.from

string (date-time)

No

Lower bound of the range for the next date on which indexation is applied. ISO 8601 format.

filter.nextIndexDate.to

string (date-time)

No

Upper bound of the range for the next date on which indexation is applied. ISO 8601 format.

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).

conceptSalesContracts.externalIdentifier

string

No

The identifier assigned to the contract by the calling system.

conceptSalesContracts.name

string

No

The free-text name of the contract.

conceptSalesContracts.ownerReference

string

No

The reference of the owner of the real estate object covered by the contract.

conceptSalesContracts.relationReference

string

No

The reference of the primary tenant who is financially responsible for the contract.

conceptSalesContracts.paymentTerm

string

No

The payment term agreed for the contract.

conceptSalesContracts.indexationMethod

string

No

The indexation method applied to the contract, for example a fixed yearly percentage or an inflation-linked method.

conceptSalesContracts.startDate

string (date)

No

The start date of the contract. ISO 8601 date format.

conceptSalesContracts.endDate

string (date)

No

The end date of the contract. ISO 8601 date format.

conceptSalesContracts.nextIndexDate

string (date)

No

The next date on which the indexation method is applied. Further indexations follow annually from this date. ISO 8601 date format.

" } } }, "components": { "schemas": { "FilterConceptSalesContractRequestPagingModel": { "type": "object", "properties": { "paging": { "$ref": "#/components/schemas/PagingInfo" }, "sorting": { "$ref": "#/components/schemas/SortingInfo" }, "filter": { "$ref": "#/components/schemas/FilterConceptSalesContractRequestDTO" } }, "additionalProperties": false }, "FilterConceptSalesContractResponsePagingModel": { "type": "object", "properties": { "paging": { "$ref": "#/components/schemas/PagingInfo" }, "sorting": { "$ref": "#/components/schemas/SortingInfo" }, "conceptSalesContracts": { "type": "array", "items": { "$ref": "#/components/schemas/FilterConceptSalesContractResponseDTO" }, "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 }, "FilterConceptSalesContractRequestDTO": { "type": "object", "properties": { "externalIdentifier": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "ownerReference": { "type": "string", "nullable": true }, "relationReference": { "type": "string", "nullable": true }, "indexationMethod": { "type": "string", "nullable": true }, "startDate": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "endDate": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "nextIndexDate": { "$ref": "#/components/schemas/CompareFilterModelDateTime" } }, "additionalProperties": false }, "FilterConceptSalesContractResponseDTO": { "type": "object", "properties": { "externalIdentifier": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "ownerReference": { "type": "string", "nullable": true }, "relationReference": { "type": "string", "nullable": true }, "paymentTerm": { "type": "string", "nullable": true }, "indexationMethod": { "type": "string", "nullable": true }, "startDate": { "type": "string", "format": "date", "nullable": true }, "endDate": { "type": "string", "format": "date", "nullable": true }, "nextIndexDate": { "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 } } } } ````