Get a paged list of existing private rent contracts, optionally filtered to the given parameters.
Get concept private rent contracts filtered and paged (POST)
This endpoint retrieves a paged, filterable list of concept residential lease contracts.
Developers call it to search across concept residential lease contracts for an administration, for example to build an overview screen of contracts still in preparation, or to locate a specific concept contract before it is finalized into a residential lease contract.
Paging and sorting can be combined with any of the available filters, and every field is optional, so a request with an empty filter returns every concept residential lease contract, paged according to the paging settings.
Request Fields
Field | Type | Required | Description |
|---|---|---|---|
paging.pageSize | Integer | Optional | Maximum number of concept residential lease contracts returned per page. Minimum 1, maximum 1000. |
paging.pageNumber | Integer | Optional | Page number to retrieve, starting at 1. Minimum 1, maximum 9999. |
sorting.columnName | String | Optional | Name of the field to sort the results by. |
sorting.order | Integer (enum) | Optional | Sort direction. Allowed values: 0 = Ascending, 1 = Descending. |
filter.externalIdentifier | String | Optional | Filters on the external identifier of the concept residential lease contract, as supplied by the caller on creation. |
filter.name | String | Optional | Filters on the name of the concept residential lease contract. |
filter.ownerReference | String | Optional | Filters on the owner, the administration the concept residential lease contract is drawn up for. |
filter.relationReference | String | Optional | Filters on the relation, the tenant on the concept residential lease contract. |
filter.indexationMethod | String | Optional | Filters on the indexation method used to adjust the base rent over time. |
filter.startDate.from | Datetime (ISO 8601) | Optional | Lower bound of the contract start date range to filter on, inclusive. |
filter.startDate.to | Datetime (ISO 8601) | Optional | Upper bound of the contract start date range to filter on, inclusive. |
filter.endDate.from | Datetime (ISO 8601) | Optional | Lower bound of the contract end date range to filter on, inclusive. |
filter.endDate.to | Datetime (ISO 8601) | Optional | Upper bound of the contract end date range to filter on, inclusive. |
filter.nextIndexDate.from | Datetime (ISO 8601) | Optional | Lower bound of the next indexation date range to filter on, inclusive. |
filter.nextIndexDate.to | Datetime (ISO 8601) | Optional | Upper bound of the next indexation date range to filter on, inclusive. |
Response Fields
Field | Type | Required | Description |
|---|---|---|---|
paging.pageSize | Integer | Optional | Maximum number of concept residential lease contracts returned per page, as applied to this result. |
paging.pageNumber | Integer | Optional | Page number returned, as applied to this result. |
sorting.columnName | String | Optional | Name of the field the results are sorted by, as applied to this result. |
sorting.order | Integer (enum) | Optional | Sort direction applied to this result. Allowed values: 0 = Ascending, 1 = Descending. |
conceptSalesContracts | Array of objects | Optional | The concept residential lease contracts matching the filter, for the requested page. |
conceptSalesContracts[].externalIdentifier | String | Optional | External identifier of the concept residential lease contract, as supplied by the caller on creation. |
conceptSalesContracts[].name | String | Optional | Name of the concept residential lease contract. |
conceptSalesContracts[].ownerReference | String | Optional | Reference to the owner, the administration the concept residential lease contract is drawn up for. |
conceptSalesContracts[].relationReference | String | Optional | Reference to the relation, the tenant on the concept residential lease contract. |
conceptSalesContracts[].paymentTerm | String | Optional | Payment term applied to the concept residential lease contract. |
conceptSalesContracts[].indexationMethod | String | Optional | Indexation method used to adjust the base rent over time. |
conceptSalesContracts[].startDate | Date (ISO 8601, format YYYY-MM-DD) | Optional | Start date of the concept residential lease contract. |
conceptSalesContracts[].endDate | Date (ISO 8601, format YYYY-MM-DD) | Optional | End date of the concept residential lease contract. |
conceptSalesContracts[].nextIndexDate | Date (ISO 8601, format YYYY-MM-DD) | Optional | Date of the next indexation of the base rent. |
Ascending = 0 Descending = 1
OK
Ascending = 0 Descending = 1