---
title: "Room placement and score"
method: POST
path: "/vastu/rooms"
tags: ["Vastu Shastra"]
---

# Room placement and score

`POST /vastu/rooms`

## Request

- Base URL: `https://api.astroway.info/v1`
- URL: `https://api.astroway.info/v1/vastu/rooms`
- Auth: API key in header `X-Api-Key`

Up to 40 rooms by direction from the centre of the house (or a bearing from true north), each judged ideal, acceptable, avoid or no-rule, with whether a verse or modern practice stands behind it. The 0-100 score is a published weighted mean; no classical text defines one. Room types with no citable rule (dining, balcony, garage, overhead tank) are refused rather than guessed.

## Query parameters

- `fields` string
- `precision` integer

## Request body

- VastuRoomsInput
  - `rooms` object[], required
    - `type` string, required
    - `direction` union
      - 'N' | 'NE' | 'E' | 'SE' | 'S' | 'SW' | 'W' | 'NW'
      - 'C'
    - `bearing` number
    - `label` string

## Response `200`

Successful calculation

- object
  - `ok` boolean
  - `data` object
    - `rooms` object[], nullable
      - `type` string, nullable
      - `label` unknown
      - `placement` string, nullable
      - `verdict` string, nullable
      - `basis` string, nullable
      - `ideal` string[], nullable
      - `source` string, nullable
    - `score` number, nullable
    - `scoring` object, nullable
      - `points` object, nullable
        - `ideal` number, nullable
        - `acceptable` number, nullable
        - `avoid` number, nullable
      - `weights` object, nullable
        - `classical` number, nullable
        - `convention` number, nullable
      - `formula` string, nullable
    - `notes` string[], nullable

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key

## Changes

- **2026-10-20** `85702f4e35b0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/vastu/rooms/post.md)

---

[API](https://skmtc.dev/astroway/apis/astroway-calculation-api.md) · [All operations](https://skmtc.dev/astroway/apis/astroway-calculation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/astroway/apis/astroway-calculation-api/revisions/593d763ba9a5?raw)