Get private rent contracts filtered and paged

Prev Next
Post
/api/v1/contracts/privaterent/filter

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.

Security
Body parameters
Expand All
object
paging
object (PagingInfo)
pageSize
integer (int32) | null
Minimum1
Maximum1000
pageNumber
integer (int32) | null
Minimum1
Maximum9999
sorting
object (SortingInfo)
columnName
string | null
order
integer (int32)

Ascending = 0 Descending = 1

filter
object (PrivateRentSalesContractSearchRequestFilter)
externalIdentifier
string | null
reference
string | null
ownerReference
string | null
relationReference
string | null
startDate
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
endDate
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
isStarted
boolean | null
isEnded
boolean | null
automaticExtends
boolean | null
noticeDate
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
noticePeriod
integer (int32) | null
depositTypeName
string | null
Responses
200

OK

Expand All
object
paging
object (PagingInfo)
pageSize
integer (int32) | null
Minimum1
Maximum1000
pageNumber
integer (int32) | null
Minimum1
Maximum9999
sorting
object (SortingInfo)
columnName
string | null
order
integer (int32)

Ascending = 0 Descending = 1

contracts
Array of object (PrivateRentSalesContractSearchResultFilter) | null
object
reference
string | null
externalIdentifier
string | null
ownerReference
string | null
relationReference
string | null
extraRelationReferences
Array of string | null
string
startDate
string (date-time)
endDate
string (date-time) | null
isStarted
boolean
isEnded
boolean
automaticExtends
boolean | null
noticeDate
string (date-time) | null
noticePeriod
integer (int32) | null
depositTypeName
string | null