> ## 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 new value for the object
> Add a new value for existing real estate object.
## OpenAPI
````json POST /api/v1/realestateobjects/propertyvaluations
{
"openapi": "3.0.4",
"info": {
"title": "RealEstateObjects V1",
"description": "Welcome to BETA version of the new RealEstateObjects API - intended for client public testing before the launch of the final version. During this BETA phase, we'll be improving the API based on specific client's feedbacks.",
"version": "v1"
},
"security": [
{}
],
"tags": [
{
"name": "Admin"
},
{
"name": "Buildings"
},
{
"name": "Complexes"
},
{
"name": "Generic"
},
{
"name": "Metadata"
},
{
"name": "PublishObjects"
},
{
"name": "ScoringPointTotals"
},
{
"name": "Sections"
},
{
"name": "Units"
}
],
"paths": {
"/api/v1/realestateobjects/propertyvaluations": {
"post": {
"tags": [
"Generic"
],
"summary": "Add a new value for the object",
"description": "Add a new value for existing real estate object.",
"operationId": "InsertObjectValue",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PropertyValuationValueInsertAPIModel"
}
}
}
},
"responses": {
"200": {
"description": "The value was added",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PropertyValuationValueAPIModel"
}
}
}
},
"400": {
"description": "The value has validation issues",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIErrorMessageModel"
}
}
}
}
},
"x-d360-narrative-url": "Add a new value for the object
This endpoint adds a new property valuation entry to an existing real estate object, such as its taxation value or WOZ value for a given year. It applies to any object type.
The object can be identified by its internal reference, its external identifier, or both.
This endpoint does not check for existing entries with the same valueTypeName and year. Calling it again with the same combination adds a duplicate entry rather than replacing the existing one. To correct a value, first delete the outdated entry using the Delete a value endpoint, then add the corrected one.
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. |
valueTypeName | string | Yes | Type of value, for example sales value or rent value. Maximum length 30 characters. |
year | integer | Yes | Calendar year the value applies to. Minimum 1900, maximum 2100. |
amount | number (double) | Yes | Value amount. Decimals are separated with a period. Minimum 0. |
measureDate | string (date) | No | Date the value was measured or assessed, if different from the calendar year alone. ISO 8601 format. |
Response Fields
Field | Type | Required | Description |
|---|
valueTypeName | string | Yes | Type of value that was added. |
year | integer | Yes | Calendar year the value applies to. |
amount | number (double) | Yes | Value amount that was added. |
measureDate | string (date) | No | Date the value was measured or assessed, if provided. |