vastu_id, and the response gives score_percentage, performance_band, result, and result_label.grade_score_scale and finding_count_by_grade. These fields explain how placements are grouped as ideal, preferred, acceptable, neutral, caution, or avoid, and how many findings fall into each grade. score_breakdown gives item-level scores for rooms, fixtures, the main entrance, and important areas such as the Brahmasthan.https://vision.astrologyapi.com/vastu/scorex-astrologyapi-keystringrequiredAPI access token used to authenticate requests. Send your access token in this custom header.
Accept-LanguagestringPreferred language for the response content. Supported: English - en.
vastu_idstringrequiredUnique Vastu ID returned by get-vastu-id
curl --location 'https://vision.astrologyapi.com/vastu/score' \
--header 'Content-Type: application/json' \
--header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
--data '{
"vastu_id": "vst_50c7a7d9695346f5"
}'
Runs with sample data — no API key needed
{
"vastu_id": "vst_50c7a7d9695346f5",
"overall_assessment": {
"score_percentage": 45.2,
"performance_band": "poor",
"result": "needs_attention",
"result_label": "Needs correction"
},
"grade_score_scale": {
"ideal": 100,
"preferred": 90,
"acceptable": 70,
"neutral": 50,
"caution": 30,
"avoid": 10
},
"finding_count_by_grade": {
"acceptable": 3,
"avoid": 2,
"caution": 4,
"ideal": 1,
"neutral": 2
},
"score_breakdown": [
{
"display_name": "Main entrance",
"category": "entrance",
"catalog_type": "main_entrance",
"score_percentage": 100,
"performance_band": "good",
"result": "working_for_you",
"result_label": "Working for you"
},
{
"display_name": "Bed in Bedroom 1",
"category": "fixture",
"catalog_type": "bed",
"score_percentage": 30,
"performance_band": "poor",
"result": "needs_attention",
"result_label": "Needs correction"
},
{
"display_name": "WC in Bath",
"category": "fixture",
"catalog_type": "wc",
"score_percentage": 50,
"performance_band": "fair",
"result": "neutral",
"result_label": "Mixed or neutral"
},
{
"display_name": "WC in Toilet",
"category": "fixture",
"catalog_type": "wc",
"score_percentage": 50,
"performance_band": "fair",
"result": "neutral",
"result_label": "Mixed or neutral"
},
{
"display_name": "The centre (Brahmasthan)",
"category": "centre",
"catalog_type": "brahmasthan",
"score_percentage": 30,
"performance_band": "poor",
"result": "needs_attention",
"result_label": "Needs correction"
},
{
"display_name": "Bath",
"category": "room",
"catalog_type": "bathroom",
"score_percentage": 30,
"performance_band": "poor",
"result": "needs_attention",
"result_label": "Needs correction"
},
{
"display_name": "Bedroom 1",
"category": "room",
"catalog_type": "master_bedroom",
"score_percentage": 10,
"performance_band": "poor",
"result": "needs_attention",
"result_label": "Needs correction"
},
{
"display_name": "Kitchen",
"category": "room",
"catalog_type": "kitchen",
"score_percentage": 10,
"performance_band": "poor",
"result": "needs_attention",
"result_label": "Needs correction"
},
{
"display_name": "Living Room",
"category": "room",
"catalog_type": "living_room",
"score_percentage": 70,
"performance_band": "good",
"result": "working_for_you",
"result_label": "Working for you"
},
{
"display_name": "Study",
"category": "room",
"catalog_type": "study",
"score_percentage": 30,
"performance_band": "poor",
"result": "needs_attention",
"result_label": "Needs correction"
},
{
"display_name": "Toilet",
"category": "room",
"catalog_type": "toilet",
"score_percentage": 70,
"performance_band": "good",
"result": "working_for_you",
"result_label": "Working for you"
},
{
"display_name": "W/D",
"category": "room",
"catalog_type": "laundry",
"score_percentage": 70,
"performance_band": "good",
"result": "working_for_you",
"result_label": "Working for you"
}
]
}