---
title: "Get a list of theoretical rents for units"
slug: "get-a-list-of-theoretical-rents-for-units"
updated: 2026-02-10T10:57:56Z
published: 2026-02-10T10:59:05Z
---

> ## 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 a list of theoretical rents for units

Get/api/v1/realestateobjects/units/theoreticalrents

Get a list of theoretical rents for units

		
			

**Description**

Retrieve the list with theoretical rents costs currently known in the Bloxs database for a specific unit. This refers to the initial costs (e.g., nameplates for an apartment complex or keys).

Either reference or externalIdentifier must have a value. Please note that if both identifiers are given, both must match; otherwise, an error message will be generated. It is recommended that the user utilizes only one identifier, with a preference for the reference.

The response provides the full list of theoretical rents for the specific unit as an array.

**Use Case**

This operation enables the user to view a list of theoretical rents currently recorded in the Bloxs database for a specific unit. For instance, the user can review all known initial rents to determine which one is appropiate and identify any that need to be added or modified.

**Request fields**

The request contains the following fields:

| Field | Description |
| --- | --- |
| reference | The relationship number within Bloxs. This is unique (per client specific environment) for all objects. The relationship number is generated by the Bloxs system. |
| externalIdentifier | The unique identifier within the system of the requesting party. This identifier is not generated by the Bloxs system. |

**Response fields**

The response contains the fields in the table below:

| Field | Description |
| --- | --- |
| contractType | Type of contract, either Private or Commercial Rent |
| contractItemName | The name of the theoretical rent entry |
| description | The description of the theoretical rent entry. |
| amountExcl | Default amount of the initial cost, excluding VAT. Decimals are separated with a period (.) |

		
		
SecurityHTTPType Bearer

Please enter a valid token

Query parametersreferencestring

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

externalIdentifierstring

The external API identifier of the model.

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='f3f51cbb-36ae-4052-88bf-0d6f93125b47'>application/json</option>
</select>Array of object   object  contractTypeinteger  (int32)    Valid values[
  33,
  65
]
contractItemNamestring   | null  
descriptionstring   | null  
amountExclnumber  (double)