Residential Valuation Full

Request Parameters

Parameter	Type	Required	Description
`postcode`	string	Required	UK postcode
`address`	string	Required	Full property address
`property_type`	string	Required	Studio, Flat, Detached, Semi-Detached, Terraced, End of Terrace House, Town House, Bungalow
`bedrooms`	integer	Required	Number of bedrooms (1-6)
`bathrooms`	integer	Required	Number of bathrooms (1-6)
`receptions`	integer	Required	Number of receptions rooms (1-6)
`estimated_current_value`	string	Required	Current estimated value (e.g., "250000")
`tenure`	string	Required	Freehold or Leasehold
`leasehold_tenure`	string	Required if tenure is Leasehold	(0-20, 20-40, 40-60, 60-80, 80+)
`floor_area`	integer	Required	Floor area of the unit in square metres (sqm)
`property_condition`	string	Required	Uninhabitable, Poor, Average, Good, Best
`epc_rating`	string	Required	A, B, C, D, E, F, G
`attributes`	string	Optional	Pass attribute's `slug` Comma seperated e.g. (additional-toilet,conservatory,driveway,etc)

Request Examples

curl -X POST "https://data-api.deskval.ai/api/v1/residentialValuationFullReport" \
  -H "X-API-Key: your-api-key" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "postcode": "SW1A 1AA",
    "address": "10 Downing Street, Westminster, London",
    "property_type": "Terraced",
    "bedrooms": 4,
    "bathrooms": 3,
    "receptions": 2,
    "estimated_current_value": "2500000",
    "tenure": "Freehold",
    "floor_area": 120,
    "property_condition": "Good",
    "epc_rating": "C",
    "attributes": "additional-toilet,conservatory,driveway"
  }'

const data = {
    postcode: "SW1A 1AA",
    address: "10 Downing Street, Westminster, London",
    property_type: "Terraced",
    bedrooms: 4,
    bathrooms: 3,
    receptions: 2,
    estimated_current_value: "2500000",
    tenure: "Freehold",
    "floor_area": 120,
    property_condition: "Good",
    epc_rating: "C",
    attributes: "additional-toilet, conservatory, driveway"
};

const response = await fetch('https://data-api.deskval.ai/api/v1/residentialValuationFullReport', {
    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/residentialValuationFullReport"
data = {
    "postcode": "SW1A 1AA",
    "address": "10 Downing Street, Westminster, London",
    "property_type": "Terraced",
    "bedrooms": 4,
    "bathrooms": 3,
    "receptions": 2,
    "estimated_current_value": "2500000",
    "tenure": "Freehold",
    "floor_area": 120,
    "property_condition": "Good",
    "epc_rating": "C",
    "attributes": "additional-toilet,conservatory,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 property valuation request has been received and is being processed.",
    "id": "3Qa3="
}

Error Response

400 Bad Request

{
    "success": false,
    "errors": {
        {
            "field": "postcode",
            "messages": "Required"
        },
        {
            "field": "address",
            "messages": "Required"
        }
    }
}

Submit Property Valuation Request to Get a Full Datapoints

Request Parameters

Request Examples

Example Response

Error Response