Update an energy label of existing real estate object.
Update an energy label
This endpoint updates the energy label of an existing real estate object, optionally replacing its supporting document.
The object to update is identified by its internal reference, its external identifier, or both. If both are given, they must refer to the same object, otherwise the request fails.
Request Fields
Field | Type | Required | Description |
|---|---|---|---|
reference | string | Conditional | Internal identifier of the object. Either reference or externalIdentifier must be provided. If both are given, the object must match both values. |
externalIdentifier | string | Conditional | External identifier of the object, as set by the integrating system. Either reference or externalIdentifier must be provided. If both are given, the object must match both values. |
energyLabelName | string | Yes | Energy label of the object, expressed as a letter grade. Values are configurable in the Bloxs application. Maximum length 6 characters. |
energyLabelValidUntilDate | string (date) | No | Date until which the energy label is valid. ISO 8601 format. |
document.fileName | string | Yes (within document) | Name of the supporting document being uploaded. Maximum length 512 characters. |
document.mimeType | string | Yes (within document) | MIME type of the supporting document, for example application/pdf or image/png. Maximum length 100 characters. |
document.base64 | string | Yes (within document) | Base64-encoded content of the supporting document. |
Response Fields
Field | Type | Required | Description |
|---|---|---|---|
energyLabelName | string | No | Energy label of the object, expressed as a letter grade. |
energyLabelValidUntilDate | string (date) | No | Date until which the energy label is valid. ISO 8601 format. |
document.fileName | string | No | Name of the supporting document linked to the object. |
document.fileSize | integer (int64) | Yes | Size, in bytes, of the supporting document linked to the object. |
The energy label was updated
The energy label has validation issues