POST
{BASE_URL}/multiUnitBlockValuationFullReport
Submit Multi Unit Block Valuation Request to Get Full Datapoints
Submit a multi unit block property valuation request containing block-level information and details for each individual property unit.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
postcode
|
string | Required | UK postcode of the multi unit block |
address
|
string | Required | Full property address |
estimated_current_value
|
integer | Required |
Current estimated value of the multi unit block (e.g. 1250000)
|
year_build
|
integer | Optional | Year in which the property/block was built |
units
|
array | Required | Array containing details of each individual property unit |
units.*.no_of_unit
|
integer | Required | Enter number of same unit in that building. |
units.*.property_type
|
string | Required | Studio, Flat, Detached, Semi-Detached, Terraced, End of Terrace House, Town House, Bungalow |
units.*.property_condition
|
string | Required | Uninhabitable, Poor, Average, Good, Best |
units.*.bedrooms
|
integer | Required | Number of bedrooms (1-6) |
units.*.bathrooms
|
integer | Required | Number of bathrooms (1-6) |
units.*.floor_area
|
integer | Optional | Floor area of the unit in square metres (sqm) |
units.*.epc_rating
|
string | Required | A, B, C, D, E, F, G |
units.*.tenure
|
string | Required | Freehold or Leasehold |
units.*.leasehold_tenure
|
string |
Required if tenure is Leasehold |
(0-20, 20-40, 40-60, 60-80, 80+) |
units.*.attributes
|
string | Optional |
Comma-separated attribute slugs, e.g.
additional-toilet,conservatory,driveway
|
Request Examples
curl -X POST "https://data-api.deskval.ai/api/v1/multiUnitBlockValuationFullReport" \
-H "X-API-Key: your-api-key" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"postcode": "SW1A 1AA",
"address": "123 Example Street, London",
"estimated_current_value": 1250000,
"year_build": 1990,
"units": [
{
"no_of_unit": 2,
"property_type": "Flat",
"property_condition": "Good",
"bedrooms": 2,
"bathrooms": 1,
"floor_area": 65,
"epc_rating": "C",
"tenure": "Leasehold",
"leasehold_tenure": "80+",
"attributes": "additional-toilet,driveway"
},
{
"no_of_unit": 1,
"property_type": "Flat",
"property_condition": "Average",
"bedrooms": 1,
"bathrooms": 1,
"floor_area": 48,
"epc_rating": "D",
"tenure": "Leasehold",
"leasehold_tenure": "60-80",
"attributes": "conservatory"
},
{
"no_of_unit": 3,
"property_type": "Studio",
"property_condition": "Good",
"bedrooms": 1,
"bathrooms": 1,
"floor_area": 35,
"epc_rating": "C",
"tenure": "Leasehold",
"leasehold_tenure": "80+",
"attributes": "driveway"
}
]
}'const data = {
postcode: "SW1A 1AA",
address: "123 Example Street, London",
estimated_current_value: 1250000,
year_build: 1990,
units: [
{
property_type: "Flat",
property_condition: "Good",
bedrooms: 2,
bathrooms: 1,
floor_area: 65,
epc_rating: "C",
tenure: "Leasehold",
leasehold_tenure: "80+",
attributes: "additional-toilet,driveway"
},
{
property_type: "Flat",
property_condition: "Average",
bedrooms: 1,
bathrooms: 1,
floor_area: 48,
epc_rating: "D",
tenure: "Leasehold",
leasehold_tenure: "60-80",
attributes: "conservatory"
},
{
property_type: "Studio",
property_condition: "Good",
bedrooms: 1,
bathrooms: 1,
floor_area: 35,
epc_rating: "C",
tenure: "Leasehold",
leasehold_tenure: "80+",
attributes: "driveway"
}
]
};
const response = await fetch(
'https://data-api.deskval.ai/api/v1/multiUnitBlockValuationFullReport',
{
method: 'POST',
headers: {
'X-API-Key': 'your-api-key',
'Accept': 'application/json',
'Content-Type': 'application/json'
},
body: JSON.stringify(data)
}
);
const result = await response.json();
console.log(result);import requests
import json
url = "https://data-api.deskval.ai/api/v1/multiUnitBlockValuationFullReport"
data = {
"postcode": "SW1A 1AA",
"address": "123 Example Street, London",
"estimated_current_value": 1250000,
"year_build": 1990,
"units": [
{
"property_type": "Flat",
"property_condition": "Good",
"bedrooms": 2,
"bathrooms": 1,
"floor_area": 65,
"epc_rating": "C",
"tenure": "Leasehold",
"leasehold_tenure": "80+",
"attributes": "additional-toilet,driveway"
},
{
"property_type": "Flat",
"property_condition": "Average",
"bedrooms": 1,
"bathrooms": 1,
"floor_area": 48,
"epc_rating": "D",
"tenure": "Leasehold",
"leasehold_tenure": "60-80",
"attributes": "conservatory"
},
{
"property_type": "Studio",
"property_condition": "Good",
"bedrooms": 1,
"bathrooms": 1,
"floor_area": 35,
"epc_rating": "C",
"tenure": "Leasehold",
"leasehold_tenure": "80+",
"attributes": "driveway"
}
]
}
headers = {
"X-API-Key": "your-api-key",
"Accept": "application/json",
"Content-Type": "application/json"
}
response = requests.post(
url,
json=data,
headers=headers
)
result = response.json()
print(json.dumps(result, indent=2))Example Response
200 OK
{
"success": true,
"message": "Your multi unit block valuation request has been received and is being processed.",
"id": "3Qa3="
}Validation Error Response
422 Unprocessable Entity
{
"success": false,
"message": "Validation failed. Please check the errors below.",
"errors": [
{
"unit": 1,
"field": "leasehold_tenure",
"field_name": "Leasehold Tenure",
"message": "Please select a valid leasehold tenure."
},
{
"unit": 2,
"field": "epc_rating",
"field_name": "EPC Rating",
"message": "Please select a valid EPC rating."
}
]
}Multiple Unit Structure
The units parameter accepts an array of individual
property units. Each object in the array represents one unit
within the multi unit block.
"units": [
{
"property_type": "Flat",
"property_condition": "Good",
"bedrooms": 2,
"bathrooms": 1,
"floor_area": 65,
"epc_rating": "C",
"tenure": "Leasehold",
"leasehold_tenure": "80+"
},
{
"property_type": "Flat",
"property_condition": "Average",
"bedrooms": 1,
"bathrooms": 1,
"floor_area": 48,
"epc_rating": "D",
"tenure": "Leasehold",
"leasehold_tenure": "60-80"
}
]