Vastu Entrance (Door Pada) API

Which of the 32 padas a door falls on, the text's effect and verse, and the better stretches of wall

POST/v1/vastu/entrance

1 credit · Secret key (test or live) · getVastuEntrance

On grid 81 each wall has nine squares and its last is the corner, the first pada of the next side (verses 43-45). On grid 64 each wall has eight equal stretches. Obstructions opposite the door are judged against twice the house height (verse 76).

Request body

plot object required
- width_m number required
  Along the front, in metres.
  > 0 · ≤ 100000
- depth_m number required
  From the front to the back, in metres.
  > 0 · ≤ 100000
- facing_deg number required
  The compass bearing a person looks along when facing out through the front: 0 north, 90 east.
  ≥ 0 · ≤ 360
No other fields are accepted.
door object required
- wall string required
  Left and right as seen from outside, looking at the front.
  one of front, left, back, right
- from_left_m number required
  The door's centre, from the left end of that wall as seen from outside it.
  ≥ 0
- width_m number
  > 0 · ≤ 100
No other fields are accepted.
grid integer
The mandala: 81 squares (verse 42) or 64 (verse 55).
one of 81, 64 · default 81
lang string
one of en, hi · default "en"
house_height_m number
Needed to judge obstructions (verse 76).
> 0 · ≤ 1000
obstructions array of object
What stands opposite the door.
at most 12 items
- type string required
  one of road, tree, street_corner, well, pillar, gutter
- distance_m number required
  ≥ 0
No other fields are accepted.

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

grid integer required
one of 81, 64
plot object required
- width_m number required
- depth_m number required
- facing_deg number required
- front string required
  The compass direction nearest to facing_deg: each side of the plot is named this way.
  one of north, east, south, west
- skew_deg number required
  How far facing_deg is from front, in degrees.
- east_west_m number required
- north_south_m number required
- area_m2 number required
door object required
- wall string required
- compass string required
- from_left_m number required
- width_m number or null required
  One of:
  1. number
  2. null
pada integer required
Clockwise from the north-east corner.
≥ 1 · ≤ 32
side string required
one of east, south, west, north
ordinal_on_side integer required
≥ 1 · ≤ 8
devata object required
- id string required
- name string required
also_known_as array of string required
verdict string required
one of favourable, mixed, unfavourable
effect string required
spans array of object required
Each pada a wide door touches; empty when it stays in one.
- pada integer required
  Clockwise from the north-east corner.
  ≥ 1 · ≤ 32
- side string required
  one of east, south, west, north
- ordinal_on_side integer required
  ≥ 1 · ≤ 8
- devata object required
  Fields
  - id string required
  - name string required
- also_known_as array of string required
- verdict string required
  one of favourable, mixed, unfavourable
- effect string required
basis string required
one of classical, convention
source object or null required
One of:
1. object
  Fields
  - text string required
  - author string required
  - chapter integer required
  - verses string required
  - translation string required
2. null
recommended object required
- on_this_wall array of object required
  Fields
  - wall string required
    one of front, left, back, right
  - compass string required
  - from_left_m number required
    From the left end of this wall, seen from outside it.
  - to_left_m number required
  - distance_m number or null required
    One of:
    1. number
    2. null
  - devata object required
    Fields
    id string required
    name string required
  - verdict string required
    one of favourable, mixed, unfavourable
  - effect string required
- on_other_walls array of object required
  Fields
  - wall string required
    one of front, left, back, right
  - compass string required
  - from_left_m number required
    From the left end of this wall, seen from outside it.
  - to_left_m number required
  - distance_m number or null required
    One of:
    1. number
    2. null
  - devata object required
    Fields
    id string required
    name string required
  - verdict string required
    one of favourable, mixed, unfavourable
  - effect string required
findings array of object required
- topic string required
- subject string required
- verdict string required
  one of favourable, neutral, unfavourable
- text string required
- basis string required
  one of classical, convention
- source object or null required
  One of:
  1. object
    Fields
    - text string required
    - author string required
    - chapter integer required
    - verses string required
    - translation string required
  2. null
disclaimer string required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/vastu/entrance' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"plot":{"width_m":18,"depth_m":27,"facing_deg":90},"door":{"wall":"front","from_left_m":10,"width_m":1.2},"house_height_m":7,"obstructions":[{"type":"tree","distance_m":30}]}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/vastu/entrance", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "plot": {
      "width_m": 18,
      "depth_m": 27,
      "facing_deg": 90
    },
    "door": {
      "wall": "front",
      "from_left_m": 10,
      "width_m": 1.2
    },
    "house_height_m": 7,
    "obstructions": [
      {
        "type": "tree",
        "distance_m": 30
      }
    ]
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "plot": {
        "width_m": 18,
        "depth_m": 27,
        "facing_deg": 90,
    },
    "door": {
        "wall": "front",
        "from_left_m": 10,
        "width_m": 1.2,
    },
    "house_height_m": 7,
    "obstructions": [
        {
            "type": "tree",
            "distance_m": 30,
        },
    ],
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/vastu/entrance",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/vastu/entrance');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"plot":{"width_m":18,"depth_m":27,"facing_deg":90},"door":{"wall":"front","from_left_m":10,"width_m":1.2},"house_height_m":7,"obstructions":[{"type":"tree","distance_m":30}]}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 4,972 characters

{
  "data": {
    "grid": 81,
    "plot": {
      "width_m": 18,
      "depth_m": 27,
      "facing_deg": 90,
      "front": "east",
      "skew_deg": 0,
      "east_west_m": 27,
      "north_south_m": 18,
      "area_m2": 486
    },
    "door": {
      "wall": "front",
      "compass": "east",
      "from_left_m": 10,
      "width_m": 1.2
    },
    "pada": 5,
    "side": "east",
    "ordinal_on_side": 5,
    "devata": {
      "id": "surya",
      "name": "Surya"
    },
    "also_known_as": [],
    "verdict": "unfavourable",
    "effect": "Increase of anger.",
    "spans": [
      {
        "pada": 5,
        "side": "east",
        "ordinal_on_side": 5,
        "devata": {
          "id": "surya",
          "name": "Surya"
        },
        "also_known_as": [],
        "verdict": "unfavourable",
        "effect": "Increase of anger."
      },
      {
        "pada": 4,
        "side": "east",
        "ordinal_on_side": 4,
        "devata": {
          "id": "indra",
          "name": "Indra"
        },
        "also_known_as": [
          "Mahendra"
        ],
        "verdict": "favourable",
        "effect": "Friendship of the ruler."
      }
    ],
    "basis": "classical",
    "source": {
      "text": "Brihat Samhita",
      "author": "Varahamihira",
      "chapter": 53,
      "verses": "43, 72, 71",
      "translation": "N. Chidambaram Iyer, 1884"
    },
    "recommended": {
      "on_this_wall": [
        {
          "wall": "front",
          "compass": "east",
          "from_left_m": 10,
          "to_left_m": 12,
          "distance_m": 0,
          "devata": {
            "id": "indra",
            "name": "Indra"
          },
          "verdict": "favourable",
          "effect": "Friendship of the ruler."
        },
        {
          "wall": "front",
          "compass": "east",
          "from_left_m": 12,
          "to_left_m": 14,
          "distance_m": 2,
          "devata": {
            "id": "jayanta",
            "name": "Jayanta"
          },
          "verdict": "favourable",
          "effect": "Gain of great wealth."
        },
        {
          "wall": "front",
          "compass": "east",
          "from_left_m": 14,
          "to_left_m": 16,
          "distance_m": 4,
          "devata": {
            "id": "parjanya",
            "name": "Parjanya"
          },
          "verdict": "mixed",
          "effect": "Birth of daughters."
        }
      ],
      "on_other_walls": [
        {
          "wall": "back",
          "compass": "west",
          "from_left_m": 10,
          "to_left_m": 12,
          "distance_m": null,
          "devata": {
            "id": "kusumadanta",
            "name": "Kusumadanta"
          },
          "verdict": "favourable",
          "effect": "More sons, wealth and strength."
        },
        {
          "wall": "back",
          "compass": "west",
          "from_left_m": 8,
          "to_left_m": 10,
          "distance_m": null,
          "devata": {
            "id": "varuna",
            "name": "Varuna"
          },
          "verdict": "favourable",
          "effect": "Opulence."
        },
        {
          "wall": "right",
          "compass": "north",
          "from_left_m": 18,
          "to_left_m": 21,
          "distance_m": null,
          "devata": {
            "id": "mukhya",
            "name": "Mukhya"
          },
          "verdict": "favourable",
          "effect": "Gain of wealth and sons."
        },
        {
          "wall": "right",
          "compass": "north",
          "from_left_m": 15,
          "to_left_m": 18,
          "distance_m": null,
          "devata": {
            "id": "bhallata",
            "name": "Bhallata"
          },
          "verdict": "favourable",
          "effect": "Possession of all virtues."
        },
        {
          "wall": "right",
          "compass": "north",
          "from_left_m": 12,
          "to_left_m": 15,
          "distance_m": null,
          "devata": {
            "id": "soma",
            "name": "Soma"
          },
          "verdict": "favourable",
          "effect": "Gain of sons and wealth."
        }
      ]
    },
    "findings": [
      {
        "topic": "obstruction",
        "subject": "tree",
        "verdict": "neutral",
        "text": "A tree faces the door, beyond twice the house height (14 m); the text says no harm follows.",
        "basis": "classical",
        "source": {
          "text": "Brihat Samhita",
          "author": "Varahamihira",
          "chapter": 53,
          "verses": "76",
          "translation": "N. Chidambaram Iyer, 1884"
        }
      }
    ],
    "disclaimer": "Traditional statements from the cited text, reported as the text gives them. They are not predictions or professional building advice."
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 1
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON)

{
  "plot": {
    "width_m": 18,
    "depth_m": 27,
    "facing_deg": 90
  },
  "door": {
    "wall": "front",
    "from_left_m": 10,
    "width_m": 1.2
  },
  "house_height_m": 7,
  "obstructions": [
    {
      "type": "tree",
      "distance_m": 30
    }
  ]
}

Vastu Entrance (Door Pada) API

Request body

Response

Example request

Example response

More in Vastu