---
title: "Add a contract line with the amount for concept private rent contracts"
slug: "preview-add-a-contract-line-with-the-amount-for-concept-private-rent-contracts"
updated: 2025-11-07T20:01:42Z
published: 2026-02-10T12:51:19Z
---

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

# Add a contract line with the amount for concept private rent contracts

Post/api/v1/contracts/conceptprivaterent/contractlines

Add a contract line with the amount for concept private rent contracts.

		
			

**Description**

Adds a contract line with the amount for concept private rent contracts. This pertains to the particular contract terms associated with the agreement. These include costs for the tenant, such as rent, furniture, and rent discounts (negative costs). It is a generic list.

Either ObjectReference or ContractExternalIdentifier 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 ObjectReference.

Private rent contracts pertains to contracts concerning real estate objects in the private sector. It is generated for each prospect, with the remaining details to be filled in in the Bloxs application. The draft contract can (optionally) be signed digitally. Once signed, the first invoice can be issued immediately. Please note that the concept contract is not a template; it is a draft with only one mandatory field.

**Use Case**

This operation enables the user to add a contract line to the Blox application.

**Request fields**

The request contains the following fields:

| Field | Description |
| --- | --- |
| ObjectReference | The reference of the existing object that should be linked to this contract line. The reference should be identical to the reference such as registered in the Bloxs application. Only real estate object references that have also been entered as 'RealEstateObjects' for this specific contract can be used here. |
| ContractExternalIdentifier | The unique identifier within the system of the requesting party. This identifier is not generated by the Bloxs system. |
| lineItemName | This pertains to the reference name of the contract line item. A GET operation is available to retrieve the reference name. |
| description | This is the description of the invoice line item that appears on the invoice. |
| amountExcl | Amount of the invoice line item, excluding VAT. Decimals are separated with a period (.) |
| startDate | Start date of the contract line item. |
| endDate | End date of the contract line item |

**Response fields**

The response contains the fields in the request with the aditional fields in the table below.

| Field | Description |
| --- | --- |
| amountVAT | VAT amount of the invoice line item. Decimals are separated with a period (.) |
| amountIncl | Amount of the invoice line item, including VAT. Decimals are separated with a period (.) |

		
		
SecurityHTTPType Bearer

Please enter a valid token

Body parameters<select class='api-response-data' aria-label='Media type'><option value='2234aa05-4d3c-40d4-98a4-fca15c4c40b7'>application/json</option>
</select>object  contractExternalIdentifierstring    RequiredMin length1
objectReferencestring    RequiredMin length1
lineItemNamestring    RequiredMin length0Max length256
descriptionstring   | null  
amountExclnumber  (double)    Required
startDatestring  (date)   | null  
endDatestring  (date)   | null  

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='fbfdbbcf-e7f0-4fff-ad38-3ecdbb591556'>application/json</option>
</select>object  contractExternalIdentifierstring    Min length1
objectReferencestring   | null  
lineItemNamestring    Min length0Max length256
descriptionstring   | null  Min length0Max length512
amountExclnumber  (double)    
amountVATnumber  (double)    
amountInclnumber  (double)    
startDatestring  (date)   | null  
endDatestring  (date)   | null