← All endpoints / Vastu

Comprehensive Plan Analysis

POST/api/v1/vastu/plan/analyze
POSThttps://vedintelastroapi.com/api/v1/vastu/plan/analyze

Highest-level Vastu analysis endpoint: geometry + room zones + 8-direction zone partitioning + Vastu Purusha Mandala summary + Brahmasthan + entrance + rule evaluation in one call. Supersedes /vastu/plot-analysis for new integrations. rule_evaluation findings include source_type, source_verification_status, and interpretive_confidence.

Request Body (application/json)

FieldRequiredTypeDescription
api_keyNostringVedIntel API key (or use X-API-Key header)
plotYesstringPlot polygon: array of {x, y} vertices (min 3; open or closed — a last vertex equal to the first is accepted)
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
roomsNostringRoom polygons: array of {name: string, polygon: Point[]}
entranceNostringEntrance descriptor: {bearing_deg: number (0–360)}
langNostringResponse language code. Default: en

Example Request

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

Example Response

{
  "status": 200,
  "response": {
    "calculation": {
      "plot": {
        "area": 200,
        "bounding_box": {
          "minX": 0,
          "maxX": 20,
          "minY": 0,
          "maxY": 10,
          "width": 20,
          "height": 10
        },
        "aspect_ratio": 2,
        "centroid": {
          "x": 10,
          "y": 5
        }
      },
      "brahmasthan": {
        "polygon": [
          {
            "x": 6.666667,
            "y": 3.333333
          }
        ],
        "area": 22.22,
        "is_obstructed": false,
        "room_obstructions": []
      },
      "zones": [
        {
          "direction_8": "N",
          "area": 10.36,
          "area_pct": 5.18
        }
      ],
      "mandala_summary": {
        "total_padas": 81,
        "padas_in_plot": 81,
        "brahmasthan_padas": 9
      },
      "rooms": []
    },
    "rule_evaluation": {
      "findings": [
        {
          "rule_id": "brahmasthan-clear-positive",
          "outcome": "positive",
          "severity": "major",
          "source_type": "classical",
          "source_verification_status": "tradition_dependent",
          "interpretive_confidence": "high"
        }
      ],
      "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
… response truncated for display. See the interactive docs for the full schema.
← Back to all endpointsInteractive Docs
Get a free API key →