---
title: "Add an initial cost with the amount for concept commercial rent contracts"
slug: "preview-add-an-initial-cost-with-the-amount-for-concept-commercial-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 an initial cost with the amount for concept commercial rent contracts

Post/api/v1/contracts/conceptcommercialrent/initialcosts

Add an initial cost with the amount for concept commercial rent contracts.

		
			

**Description**

Adds an initial cost to concept commercial rent contracts. This refers to the initial contract costs (e.g., nameplates for an apartment complex or keys).

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.

Commercial rent contracts pertains to contracts concerning stores, offices, and commercial spaces (commercial real estate). 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 an initial cost to a concept commercial rent contract. For instance, The user wishes to include an additional initial cost component due to the implementation of extra facilities for the tenant.

**Request fields**

The request contains the following fields:

| Field | Description |
| --- | --- |
| contractExternalIdentifier | The unique identifier within the system of the requesting party. This identifier is not generated by the Bloxs system. This field should contain the externalIdentifier of the estate agent to which the bank accounts belongs. |
| 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. |
| initialCostItemName | The description (name) of the initial cost component (e.g., key deposit, nameplates). |
| amountExcl | Amount of the invoice line item, excluding VAT. Decimals are separated with a period (.) |

**Response fields**

The response contains the fields in the request with the additional fields belowtable 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='a394ba20-4c4c-4c4a-9d5b-b2e69600b028'>application/json</option>
</select>object  contractExternalIdentifierstring    RequiredMin length1
objectReferencestring    RequiredMin length1
initialCostsItemNamestring    RequiredMin length0Max length256
amountExclnumber  (double)    Required

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='54c399e3-1098-49e7-93b6-e6042ebc8a10'>application/json</option>
</select>object  contractExternalIdentifierstring    Min length1
objectReferencestring   | null  
initialCostsItemNamestring    Min length0Max length256
amountExclnumber  (double)    
amountVATnumber  (double)    
amountInclnumber  (double)