πŸ•°οΈ 15+ Muhurta APIs and βœ‹ Palmistry API are now live. Ship them in your app today.

Get Vastu ID

This is the starting API for the complete floor-plan Vastu analysis. You send the property layout image in layout_url and the entrance orientation in entrance_degree. The system reads the plan and creates one Vastu analysis record for that home.

The response gives a unique vastu_id and a processing status. The vastu_id is the most important value in the detailed flow because the same ID is used in Score, Findings, Remedies, Direction 8, Zone 16, Angular 32, Entrance Padas 32, Padas 81, and Devatas 45.

In Vastu terms, this step establishes the spatial base of the home. It lets the later APIs locate rooms, fixtures, the main entrance, directional zones, the Brahmasthan, Mandala Padas, and Devata fields from the same floor plan.
POSThttps://vision.astrologyapi.com/vastu/get-vastu-id

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

layout_urlstringrequired

Public image URL or base64 data URL (data:image/...;base64,...) of floor plan. Aliases: url, img_url, image. Accepted formats: jpeg, jpg, png, webp. Maximum size: 5MB.

entrance_degreefloat

Main entrance bearing. Send exactly one of entrance_degree or north_angle_deg.

curl --location 'https://vision.astrologyapi.com/vastu/get-vastu-id' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "layout_url": "https://assets.example.com/floor-plan.png",
    "entrance_degree": 330
}'
Try it

Runs with sample data β€” no API key needed

{
  "vastu_id": "vst_50c7a7d9695346f5",
  "status": "COMPLETED"
}