Get real estate objects of a private rent contracts

Prev Next
Get
/api/v1/contracts/privaterent/realestateobjects

Get all non-removed real estate objects used in the requested private rent contract. Either reference or externalIdentifier must have a value. If both are given, both are used for retrieving the real estate objects of the private rent contract.

Get real estate objects of a private rent contracts

Retrieves all real estate objects currently linked to a finalized residential lease contract, excluding any objects that have been removed from the contract.

A developer calls this endpoint to see which objects a contract applies to, for example when a single contract covers more than one unit.

Either the contract's reference or its external identifier must be supplied to identify the contract.


Request Fields

Field

Type

Required

Description

reference

string

No

The reference of the residential lease contract, as generated by Bloxs.

externalIdentifier

string

No

The external identifier of the residential lease contract, assigned by the requesting party. This identifier is not generated by Bloxs.


Response Fields

Field

Type

Required

Description

salesContractReference

string

No

The reference of the residential lease contract, as generated by Bloxs. Maximum length 100 characters.

salesContractExternalIdentifier

string

No

The external identifier of the residential lease contract, assigned by the requesting party. Maximum length 100 characters.

realEstateObjectReference

string

No

The reference of the real estate object linked to the contract, as generated by Bloxs. Maximum length 100 characters.

startDate

string (date-time)

Yes

The date from which this real estate object is linked to the contract. May fall within the contract's overall period, since an object can be active for the full contract period or only part of it. ISO 8601 date-time format.

endDate

string (date-time)

No

The date until which this real estate object is linked to the contract. Empty when the object remains linked for the remainder of the contract. ISO 8601 date-time format.

Security
Query parameters
reference
string

The internal identifier of the model (i.e. Reference, Code, Name, depends on model).

externalIdentifier
string

The external API identifier of the model.

Responses
200

OK

Array of object
object
salesContractReference
string | null
Min length0
Max length100
salesContractExternalIdentifier
string | null
Min length0
Max length100
realEstateObjectReference
string | null
Min length0
Max length100
startDate
string (date-time)
endDate
string (date-time) | null