🕰️ 15+ Muhurta APIs and ✋ Palmistry API are now live. Ship them in your app today.

Basic Vastu Findings

The Basic Findings API explains the Vastu meaning of the room and feature directions sent in the request. It does not need a vastu_id because the placement data is already included directly in the request body.

Each finding gives the placement name, category, catalog type, grade, result, and a readable interpretation. This can explain issues or supportive placements for a kitchen, bedroom, treasury, verandah, borewell, entrance, or other submitted object.
POSThttps://vision.astrologyapi.com/vastu/basic-findings

Authentication

x-astrologyapi-keystringrequired

API access token used to authenticate requests. Send your access token in this custom header.

Accept-Languagestring

Preferred language for the response content. Supported: English - en.

Body parameters

main_entrancestringrequired

Confirmed main-entrance direction.

roomsarrayrequired

One to fifty confirmed room type and direction pairs.

contextobject

Optional agency and concern context.

The Basic APIs accept a fixed set of room types. The supported room values are: 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.

The 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-findings' \
  --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"
    }
}'
Try it

Runs with sample data — no API key needed

{
  "total_findings": 4,
  "findings": [
    {
      "finding_title": "Kitchen in the south-west of the home",
      "display_name": "Kitchen",
      "category": "room",
      "catalog_type": "kitchen",
      "grade": "avoid",
      "result": "needs_attention",
      "interpretation": "Your kitchen is in the south-west. This corner keeps your home steady. Heat does not belong in it. Friction between partners will rise over small things. Money will pass through the house without ever settling."
    },
    {
      "finding_title": "Master bedroom in the north-east of the home",
      "display_name": "Master bedroom",
      "category": "room",
      "catalog_type": "master_bedroom",
      "grade": "avoid",
      "result": "needs_attention",
      "interpretation": "Your main bedroom is in the north-east. This corner should stay light and open, and a bedroom fills it. You will wake without feeling rested. Your next step will stay unclear. Your authority at home will feel weaker than it is."
    },
    {
      "finding_title": "Treasury in the south-west of the home",
      "display_name": "Treasury",
      "category": "room",
      "catalog_type": "treasury",
      "grade": "avoid",
      "result": "needs_attention",
      "interpretation": "Your safe is in the south-west. Money will go in and sit there. Savings will stay idle instead of growing into anything. Move the safe to the north and open it facing north."
    },
    {
      "finding_title": "Verandah in the south-west of the home",
      "display_name": "Verandah",
      "category": "room",
      "catalog_type": "verandah",
      "grade": "avoid",
      "result": "needs_attention",
      "interpretation": "Your verandah opens off your heaviest corner. Openness is sitting where the plan wanted weight. Stability at home will feel less solid than it looks. Keep heavy pots and screens there."
    }
  ]
}