entities section shows which submitted object belongs to which direction, while the directions section groups all placements under North, North-East, East, South-East, South, South-West, West, and North-West.
This API creates a simple compass-style Vastu report from manually entered room and feature directions.https://vision.astrologyapi.com/vastu/basic-direction-8x-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.
main_entrancestringrequiredConfirmed main-entrance direction.
roomsarrayrequiredOne to fifty confirmed room type and direction pairs.
contextobjectOptional agency and concern context.
kitchen, master_bedroom, puja_room, toilet, bathroom, living_room, dining_room, staircase, storage, bedroom, kids_bedroom, guest_bedroom, study, office, foyer, gym, home_theatre, pantry, laundry, powder_room, servant_room, granary, treasury, lift, parking, balcony, verandah, terrace, garden, courtyard, and pool. Only these room types are supported in the Basic room input. context object adds practical information about the property and the user’s main concern. context.agency accepts exactly four values: OWN_CAN_REBUILD, OWN_CANNOT_REBUILD, RENT, and UNKNOWN. context.concern accepts exactly seven values: MONEY, HEALTH, HOME, WORK, MOOD, NONE, and UNKNOWN.curl --location 'https://vision.astrologyapi.com/vastu/basic-direction-8' \
--header 'Content-Type: application/json' \
--header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
--data '{
"main_entrance": "N",
"rooms": [
{
"type": "kitchen",
"direction": "SW"
},
{
"type": "master_bedroom",
"direction": "NE"
},
{
"type": "verandah",
"direction": "SW"
},
{
"type": "treasury",
"direction": "SW"
}
],
"context": {
"agency": "RENT",
"concern": "NONE"
}
}'
Runs with sample data — no API key needed
{
"reference": [
{
"direction_code": "N",
"element": "Water",
"ruling_deity": "Kubera",
"meaning": "Opportunity and new work. Kept cool, light and open."
},
{
"direction_code": "NE",
"element": "Water (Jal)",
"ruling_deity": "Ishana",
"meaning": "The corner the tradition wants emptiest. Clarity and calm."
},
{
"direction_code": "E",
"element": "Air / sunlight",
"ruling_deity": "Indra and Surya",
"meaning": "Morning light, health and social standing."
},
{
"direction_code": "SE",
"element": "Fire (Agni)",
"ruling_deity": "Agni",
"meaning": "The fire corner. Cooking and heat belong here."
},
{
"direction_code": "S",
"element": "Earth / fire",
"ruling_deity": "Yama",
"meaning": "Weight and structure. Few large openings."
},
{
"direction_code": "SW",
"element": "Earth (Prithvi)",
"ruling_deity": "Nirriti",
"meaning": "The heaviest corner. Mass, storage and rest."
},
{
"direction_code": "W",
"element": "Water / gains",
"ruling_deity": "Varuna",
"meaning": "Gains and consolidation. Study and dining sit well."
},
{
"direction_code": "NW",
"element": "Air (Vayu)",
"ruling_deity": "Vayu",
"meaning": "Movement and circulation. Guests, stores, transit."
}
],
"entities": [
{
"display_name": "Kitchen",
"category": "room",
"catalog_type": "kitchen",
"direction_code": "SW"
},
{
"display_name": "Master bedroom",
"category": "room",
"catalog_type": "master_bedroom",
"direction_code": "NE"
},
{
"display_name": "Treasury",
"category": "room",
"catalog_type": "treasury",
"direction_code": "SW"
},
{
"display_name": "Verandah",
"category": "room",
"catalog_type": "verandah",
"direction_code": "SW"
},
{
"display_name": "Main entrance",
"category": "entrance",
"catalog_type": "main_entrance",
"direction_code": "N"
}
],
"directions": [
{
"direction_code": "N",
"element": "Water",
"ruling_deity": "Kubera",
"meaning": "Opportunity and new work. Kept cool, light and open.",
"placements": [
{
"display_name": "Main entrance",
"category": "entrance",
"catalog_type": "main_entrance"
}
]
},
{
"direction_code": "NE",
"element": "Water (Jal)",
"ruling_deity": "Ishana",
"meaning": "The corner the tradition wants emptiest. Clarity and calm.",
"placements": [
{
"display_name": "Master bedroom",
"category": "room",
"catalog_type": "master_bedroom"
}
]
},
{
"direction_code": "E",
"element": "Air / sunlight",
"ruling_deity": "Indra and Surya",
"meaning": "Morning light, health and social standing.",
"placements": []
},
{
"direction_code": "SE",
"element": "Fire (Agni)",
"ruling_deity": "Agni",
"meaning": "The fire corner. Cooking and heat belong here.",
"placements": []
},
{
"direction_code": "S",
"element": "Earth / fire",
"ruling_deity": "Yama",
"meaning": "Weight and structure. Few large openings.",
"placements": []
},
{
"direction_code": "SW",
"element": "Earth (Prithvi)",
"ruling_deity": "Nirriti",
"meaning": "The heaviest corner. Mass, storage and rest.",
"placements": [
{
"display_name": "Kitchen",
"category": "room",
"catalog_type": "kitchen"
},
{
"display_name": "Treasury",
"category": "room",
"catalog_type": "treasury"
},
{
"display_name": "Verandah",
"category": "room",
"catalog_type": "verandah"
}
]
},
{
"direction_code": "W",
"element": "Water / gains",
"ruling_deity": "Varuna",
"meaning": "Gains and consolidation. Study and dining sit well.",
"placements": []
},
{
"direction_code": "NW",
"element": "Air (Vayu)",
"ruling_deity": "Vayu",
"meaning": "Movement and circulation. Guests, stores, transit.",
"placements": []
}
]
}