---
title: "Vedic significations (BPHS)"
method: GET
path: "/v1/astro/significations"
tags: ["Vedic Reference"]
---

# Vedic significations (BPHS)

`GET /v1/astro/significations`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/astro/significations`
- Auth: HTTP bearer

What each house and planet signifies in Brihat Parashara Hora Shastra, as a fixed list with stable ids. Houses: chapter 11, verses 2-13. Planets: chapter 3, verses 12-13 and the karaka verses of chapters 8 and 14 (Santhanam edition). Rahu and Ketu are left out because BPHS gives them no such verse. Two levels: a domain (relationships, work, wealth …) and the signification itself. Ids are stable: never renamed, removed or reused; a retired entry stays with deprecated=true and replaced_by. The list says what the texts say; it does not decide what counts as love, work or energy for an app, so each app keeps its own mapping. Cacheable for a day.

## Response `200`

Successful Response

- ApiResponseSignificationsResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` SignificationsResponse, required
    - `tradition` 'vedic' | 'western', required
    - `version` integer, required: List version; goes up when entries are added or retired.
    - `source` string, required
    - `id_policy` string, required
    - `notes` string[], required
    - `domains` SignificationDomain[], required: The first level: broad areas of life shared by both lists.
      - `id` string, required: Domain id, e.g. relationships.
      - `label` string, required
    - `houses` HouseSignifications[], required
      - `house` integer, required
      - `id` string, required
      - `name` string, required
      - `label` string, required
      - `source` string, required
      - `significations` Signification[], required
        - `id` string, required: Stable id, e.g. bphs.house.7.spouse. Never renamed or reused.
        - `label` string, required: Plain-English label, close to the source wording.
        - `domain` string, required: Domain id from the domains list.
        - `source` string, required: Verse or page the entry comes from.
        - `deprecated` boolean: True when retired; the id stays so old mappings do not break.
        - `replaced_by` string, nullable: Id of the entry that replaces a deprecated one.
    - `planets` PlanetSignifications[], required
      - `planet` string, required
      - `id` string, required
      - `significations` Signification[], required
        - `id` string, required: Stable id, e.g. bphs.house.7.spouse. Never renamed or reused.
        - `label` string, required: Plain-English label, close to the source wording.
        - `domain` string, required: Domain id from the domains list.
        - `source` string, required: Verse or page the entry comes from.
        - `deprecated` boolean: True when retired; the id stays so old mappings do not break.
        - `replaced_by` string, nullable: Id of the entry that replaces a deprecated one.

## Other responses

- `401`: Authentication failed
- `403`: Authorization failed
- `404`: Resource not found
- `413`: Payload too large
- `422`: Validation error
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream provider error
- `503`: Service unavailable

---

[API](https://skmtc.dev/asterwise/apis/asterwise-api.md) · [All operations](https://skmtc.dev/asterwise/apis/asterwise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asterwise/apis/asterwise-api/revisions/3c4bbb1194e2?raw)