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

Basic Vastu Score

The Basic Score API gives a quick Vastu score from manually supplied direction data. You can send values such as Main Entrance = N, Kitchen = SW, Master Bedroom = NE without uploading a floor plan.

The response gives overall_assessment, score percentage, performance band, result, grade scale, grade counts, and a score_breakdown for each submitted room or feature.

This API powers quick Vastu forms and direction-based assessments where the user already knows the room directions. It is simpler than the detailed flow because it works from submitted direction data and does not calculate fine Mandala geometry.
POSThttps://vision.astrologyapi.com/vastu/basic-score

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.
Next →
Basic Vastu Findings
curl --location 'https://vision.astrologyapi.com/vastu/basic-score' \
  --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

{
  "overall_assessment": {
    "score_percentage": 15,
    "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": {
    "avoid": 3,
    "neutral": 1
  },
  "score_breakdown": [
    {
      "display_name": "Kitchen",
      "category": "room",
      "catalog_type": "kitchen",
      "score_percentage": 10,
      "performance_band": "poor",
      "result": "needs_attention",
      "result_label": "Needs correction"
    },
    {
      "display_name": "Master bedroom",
      "category": "room",
      "catalog_type": "master_bedroom",
      "score_percentage": 10,
      "performance_band": "poor",
      "result": "needs_attention",
      "result_label": "Needs correction"
    },
    {
      "display_name": "Powder room",
      "category": "room",
      "catalog_type": "powder_room",
      "score_percentage": 50,
      "performance_band": "fair",
      "result": "neutral",
      "result_label": "Mixed or neutral"
    },
    {
      "display_name": "Verandah",
      "category": "room",
      "catalog_type": "verandah",
      "score_percentage": 10,
      "performance_band": "poor",
      "result": "needs_attention",
      "result_label": "Needs correction"
    }
  ]
}