GET
{BASE_URL}/getPropertyValuation/{id}
Get Property Valuation Status
Check the status and results of a submitted property valuation
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string | Required | Encrypted valuation ID returned from the valuation request |
Request Examples
curl -X GET "https://data-api.deskval.ai/api/v1/getPropertyValuation/3Qa3=" \
-H "X-API-Key: your-api-key" \
-H "Accept: application/json" \
-H "Content-Type: application/json"const valuationId = '3Qa3=';
const response = await fetch(`https://data-api.deskval.ai/api/v1/getPropertyValuation/${valuationId}`, {
method: 'GET',
headers: {
'X-API-Key': 'your-api-key',
'Accept': 'application/json',
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);import requests
valuation_id = "3Qa3="
url = f"https://data-api.deskval.ai/api/v1/getPropertyValuation/{valuation_id}"
headers = {
"X-API-Key": "your-api-key",
"Accept": "application/json",
"Content-Type": "application/json"
}
response = requests.get(url, headers=headers)
data = response.json()
print(data)Example Responses
Pending
200 OK
{
"success": true,
"status": "Pending",
"message": "Property valuation request has been received and is waiting to be processed.",
"data": null
}Processing
200 OK
{
"success": true,
"status": "Processing",
"message": "Property valuation is still in progress. Please check again later.",
"data": null
}Completed Valuation : Example Responses for Short Datapoints API
200 OK
{
"success": true,
"status": "Completed",
"message": "Property valuation has been successfully completed.",
"data": {
"postcode": "EN6 2DS",
"address": "131 Dugdale Hill Lane, Potters Bar, EN6 2DS",
"property_type": "Semi-Detached",
"market_sale_value": 371174,
"market_sale_confidence": 7,
"market_rent_value": 2100,
"market_rent_confidence": 10,
}
}Completed Valuation : Example Responses for Full Datapoints API
200 OK
{
"success": true,
"status": "Completed",
"message": "Property valuation has been successfully completed.",
"data": {
"postcode": "EN6 2DS",
"address": "131 Dugdale Hill Lane, Potters Bar, EN6 2DS",
"property_type": "Semi-Detached",
"market_sale_value": 439636,
"market_sale_confidence": 10,
"market_rent_value": 2074,
"market_rent_confidence": 10,
"property_condition_price_range": [
{
"property_condition": "Uninhabitable",
"epc_rating": "D",
"price": 377955
},
{
"property_condition": "Poor",
"epc_rating": "D",
"price": 402627
},
{
"property_condition": "Average",
"epc_rating": "D",
"price": 427300
},
{
"property_condition": "Good",
"epc_rating": "D",
"price": 439636
},
{
"property_condition": "Best",
"epc_rating": "D",
"price": 451972
}
],
"market_value_freehold_vacant_possession": {
"description": "Market Value of the Freehold interest with vacant possession, under the special assumption of a period to exchange contracts.",
"valuations": {
"90_days": 351709,
"180_days": 395673
}
},
"sold_lr_nearby": [
{
"property_address": "69 WINNINGTON ROAD",
"postcode": "EN3 5RL",
"bedrooms": 3,
"bathrooms": 1,
"property_type": "Terraced",
"lat": 51.671,
"lng": -0.047,
"price": 432000,
"sold_date": "2022-09-30",
"distance_from_property_in_miles": 0.002
},
{
"property_address": "96 Winnington Road",
"postcode": "EN3 5RL",
"bedrooms": 3,
"bathrooms": 1,
"property_type": "Terraced",
"lat": 51.671,
"lng": -0.047,
"price": 405000,
"sold_date": "2023-12-15",
"distance_from_property_in_miles": 0.002
},...
],
"sold_stc_nearby": [
{
"property_address": "Winnington Road, Enfield",
"postcode": "EN3 5RL",
"bedrooms": 3,
"bathrooms": 1,
"property_type": "Terraced house",
"lat": 51.671,
"lng": -0.047,
"price": 400000,
"distance_from_property_in_miles": 0.001
},
{
"property_address": "Goodwood Avenue, Enfield, EN3",
"postcode": "EN3 5RP",
"bedrooms": 3,
"bathrooms": 1,
"property_type": "Terraced house",
"lat": 51.671,
"lng": -0.046,
"price": 435000,
"distance_from_property_in_miles": 0.061
},...
],
"live_sale_nearby": [
{
"property_address": "Winnington Road, Enfield",
"postcode": "EN3 5RJ",
"bedrooms": 3,
"bathrooms": 1,
"property_type": "Terraced house",
"lat": 51.67,
"lng": -0.047,
"price": 460000,
"distance_from_property_in_miles": 0.065
},
{
"property_address": "Winnington Road, Enfield",
"postcode": "EN3 5RJ",
"bedrooms": 3,
"bathrooms": 1,
"property_type": "Terraced house",
"lat": 51.67,
"lng": -0.047,
"price": 460000,
"distance_from_property_in_miles": 0.068
},...
],
"live_rental_nearby": [
{
"property_address": "Dell Road, Enfield",
"postcode": "EN3 5RF",
"bedrooms": 3,
"bathrooms": 1,
"property_type": "Terraced house",
"lat": 51.668,
"lng": -0.045,
"price": 2350,
"distance_from_property_in_miles": 0.184
},
{
"property_address": "Mapleton Crescent, Enfield, EN3",
"postcode": "EN3 5RB",
"bedrooms": 3,
"bathrooms": 1,
"property_type": "Terraced house",
"lat": 51.667,
"lng": -0.047,
"price": 2300,
"distance_from_property_in_miles": 0.225
},...
],
"yield": [
{
"month": 1,
"year": 2025,
"val": 5.7
},
{
"month": 2,
"year": 2025,
"val": 5.9
},...
],
"demand": [
{
"month": 2,
"year": 2025,
"val": 67
},
{
"month": 3,
"year": 2025,
"val": 65
},...
],
"avg_asking_price": [
{
"month": 8,
"year": 2024,
"val": 457140.9
},
{
"month": 9,
"year": 2024,
"val": 456751.7
},...
],
"avg_asking_price_change": [
{
"month": 1,
"year": 2025,
"val": -0.267
},
{
"month": 2,
"year": 2025,
"val": 1.19
},...
],
"avg_asking_rent": [
{
"month": 8,
"year": 2024,
"val": 2251.9
},
{
"month": 9,
"year": 2024,
"val": 2261.2
},...
],
"avg_asking_rent_change": [
{
"month": 1,
"year": 2025,
"val": -2.393
},
{
"month": 2,
"year": 2025,
"val": 1.723
},...
],
"key_stats": {
"typical_yield": "0.6",
"sales_affordability": "10.9",
"avg_household_income": 42300,
"yield": "5.9"
},
"price_map_sale_properties": [
{
"property_address": "Winnington Road, Enfield",
"postcode": "EN3 5RJ",
"bedrooms": 3,
"bathrooms": 1,
"property_type": "Terraced house",
"lat": 51.67,
"lng": -0.047,
"price": 460000,
"distance_from_property_in_miles": 0.065
},
{
"property_address": "Winnington Road, Enfield",
"postcode": "EN3 5RJ",
"bedrooms": 3,
"bathrooms": 1,
"property_type": "Terraced house",
"lat": 51.67,
"lng": -0.047,
"price": 460000,
"distance_from_property_in_miles": 0.068
},...
],
"price_map_rent_properties": [
{
"property_address": "Dell Road, Enfield",
"postcode": "EN3 5RF",
"bedrooms": 3,
"bathrooms": 1,
"property_type": "Terraced house",
"lat": 51.668,
"lng": -0.045,
"price": 2350,
"distance_from_property_in_miles": 0.184
},
{
"property_address": "Mapleton Crescent, Enfield, EN3",
"postcode": "EN3 5RB",
"bedrooms": 3,
"bathrooms": 1,
"property_type": "Terraced house",
"lat": 51.667,
"lng": -0.047,
"price": 2300,
"distance_from_property_in_miles": 0.225
},...
]
}
}Failed
200 OK
{
"success": false,
"status": "Failed",
"message": "Property valuation could not be completed. Please try again or contact support.",
"data": null
}