VastuVerdict API

Deterministic Vastu compliance scoring for real-estate listing and floor-plan pipelines — a pre-launch audit or portal filter, not a rendered report. Every score comes from the same codified rule base as the consumer product (see /api/rules for the loaded rule set), so results are reproducible and explainable, not an LLM guess. No vastu tool today offers this as an API; if you run a property portal, listing platform, or floor-plan pre-launch pipeline and want to filter or flag by Vastu compliance at scale, this is for you.

Authentication

Every request needs an X-API-Key header. Keys are issued directly by the founder — there is no self-serve signup. A key that is missing, wrong, or deactivated returns 401.

Endpoint: score a single premises

Compact score for one structured premises — the primary endpoint for portal filtering: run it per listing and store the score alongside the listing.

POST /api/score
X-API-Key: vv_live_...
Content-Type: application/json

{
  "type": "HOUSE",
  "facing": "E",
  "rooms": [
    { "type": "KITCHEN", "direction": "SE" },
    { "type": "TOILET", "direction": "NE" }
  ]
}

200 OK

{
  "id": null,
  "premises_type": "HOUSE",
  "score": 66.7,
  "potential_score": 100.0,
  "grade": "Needs Attention (critical defects present)",
  "critical_count": 1,
  "dosha_count": 1,
  "facing": "E",
  "top_actions": [
    "North-East (Ishanya) Dosha",
    "Toilet / WC placement"
  ]
}

Endpoint: batch score (up to 500 premises)

The same scoring, batched — suited to a nightly pre-launch audit or a bulk import job. Each item carries your own id back in the response so results line up with your records.

POST /api/analyze/batch
X-API-Key: vv_live_...
Content-Type: application/json

{
  "items": [
    {
      "id": "listing-101",
      "premises": {
        "type": "HOUSE",
        "facing": "E",
        "rooms": [
          { "type": "KITCHEN", "direction": "SE" },
          { "type": "TOILET", "direction": "NE" }
        ]
      }
    }
  ]
}

200 OK

{
  "count": 1,
  "results": [
    {
      "id": "listing-101",
      "premises_type": "HOUSE",
      "score": 66.7,
      "potential_score": 100.0,
      "grade": "Needs Attention (critical defects present)",
      "critical_count": 1,
      "dosha_count": 1,
      "facing": "E",
      "top_actions": [
        "North-East (Ishanya) Dosha",
        "Toilet / WC placement"
      ]
    }
  ]
}

Rate limits & quota

Each pilot key has a monthly call quota agreed with you at issuance (a sensible default, higher on request). Once exhausted for the month, requests return 429 until the quota resets on the 1st. There is no published self-serve tier or per-endpoint pricing — pilot access is negotiated directly.

Get a key

Partnerships: support@vastuverdict.com — pilot keys are free.