← All endpoints / Vastu

Entrance Analysis

POST/api/v1/vastu/entrance
POSThttps://vedintelastroapi.com/api/v1/vastu/entrance

Classifies an entrance bearing into the 8-direction system with deity and auspiciousness metadata, then evaluates applicable Vastu rules. Returns calculation, rule_evaluation, and metadata.

Request Body (application/json)

FieldRequiredTypeDescription
api_keyNostringVedIntel API key (or use X-API-Key header)
entranceYesstringEntrance descriptor: {bearing_deg: number (0–360)}
north_angleNonumberTrue North bearing (degrees clockwise) of your plan +Y axis. Every bearing is converted with true bearing = bearing + north_angle, and polygons are rotated into a True North frame. Default: 0
plotNostringOptional plot polygon: array of {x, y} vertices (min 3; open or closed — a last vertex equal to the first is accepted)
langNostringResponse language code. Default: en

Example Request

curl -X POST "https://vedintelastroapi.com/api/v1/vastu/entrance" \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_API_KEY",
  "entrance": "VALUE",
  "north_angle": 0,
  "plot": "VALUE",
  "lang": "en"
}'

Example Response

{
  "status": 200,
  "response": {
    "calculation": {
      "entrance": {
        "direction_8": "NE",
        "direction_4": "E",
        "bearing_deg": 45,
        "deity": "Ishana (Shiva)",
        "label_en": "North-East",
        "label_hi": "Ishan",
        "label_sa": "Ishana"
      }
    },
    "rule_evaluation": {
      "findings": [
        {
          "rule_id": "entrance-ne-positive",
          "subject": "main-entrance",
          "category": "entrance",
          "predicate": "entrance-direction",
          "outcome": "positive",
          "severity": "minor",
          "source_type": "consensus",
          "source_text": null,
          "source_verification_status": "consensus_only",
          "interpretive_confidence": "moderate",
          "description": "Main entrance facing North-East (Ishana corner) is frequently cited as auspicious in modern Vastu practice as an alternative to pure East or North.",
          "trigger": "Main entrance faces NE"
        }
      ],
      "positive_count": 1,
      "negative_count": 0,
      "critical_count": 0,
      "rules_version": "1.0.0"
    },
    "interpretation": null,
    "metadata": {
      "geometry_engine_version": "1.0.0",
      "vastu_rules_version": "1.0.0",
      "coordinate_system": "cartesian_true_north",
      "north_reference": "true_north",
      "north_angle_applied_deg": 0,
      "precision": {
        "bearing_dp": 2,
        "area_dp": 2,
        "overlap_pct_dp": 2,
        "units": "same as input polygon coordinates",
        "rounding_method": "round half away from zero",
        "internal_precision": "double"
      },
      "ayanamsa": null
    }
  },
  "remaining_api_calls": 4998
}
← Back to all endpointsInteractive Docs
Get a free API key →