---
title: "Gemstone (ratna) recommendation"
method: POST
path: "/vedic/gemstones"
tags: ["Vedic"]
---

# Gemstone (ratna) recommendation

`POST /vedic/gemstones`

Which of the nine gems to wear, from the sidereal lagna. Two schools are implemented: `lagna-lord` (default) prescribes the gems of the 1st, 9th and 5th lords as the life, lucky and benefic stones; `functional-benefic` classifies every graha by the houses it owns from the lagna, prescribes only for functional benefics led by the yogakaraka, and names the functional malefics as gems to avoid. Both reach the same three gems, because a functional benefic is a graha owning a trikona and the trikona lords are the 1st, 5th and 9th: the school changes the ordering, the role each gem carries, and the avoid list. The response always reports which one produced it. Coordinates are required, since the whole answer is derived from the lagna. Each gem carries its substitutes, day, finger, metal, weight range in ratti/grams/carats, and beeja mantra. Planet dignity is returned as context and does not change the list.

## Request body

- Gemstone — Birth data for a gemstone recommendation. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude. Coordinates do NOT default to 0 here as they do on other chart endpoints: the whole answer is derived from the lagna, so an omitted pair is a 400 rather than a confident set of gems for 0N 0E.
  - `date` string, required
  - `time` string, required
  - `timezoneOffset` number, nullable — Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC.
  - `latitude` number, required — Birth latitude. Required: the lagna is what both schools prescribe from.
  - `longitude` number, required — Birth longitude. Required: the lagna is what both schools prescribe from.
  - `houseSystem` string
  - `name` string
  - `city` string
  - `zodiacType` 'tropical' | 'sidereal'
  - `ayanamsaId` number, nullable
  - `ayanamsa` 'fagan-bradley' | 'lahiri' | 'de-luce' | 'raman' | 'krishnamurti' | 'kp' | 'yukteshwar' | 'jn-bhasin' | 'true-citra' | 'djwhal-khul' — Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
  - `cosmogram` boolean
  - `school` 'lagna-lord' | 'functional-benefic' — Prescription school. Both reach the same three gems (the trikona lords), and differ on what they withhold and on the ordering. The response always names the one used. Default: lagna-lord.

## Response `200`

Successful calculation

- object
  - `ok` boolean
  - `data` object
    - `type` string, nullable
    - `school` string, nullable
    - `lagna` object, nullable
      - `sign` number, nullable
      - `signName` string, nullable
      - `lord` number, nullable
      - `lordName` string, nullable
    - `recommended` object[], nullable
      - `role` string, nullable
      - `graha` number, nullable
      - `gem` string, nullable
      - `gemSanskrit` string, nullable
      - `housesOwned` number[], nullable
      - `basis` string, nullable
      - `substitutes` string[], nullable
      - `wearing` object, nullable
        - `day` string, nullable
        - `finger` string, nullable
        - `metals` string[], nullable
        - `minWeight` object, nullable
          - `ratti` number[], nullable
          - `carats` number[], nullable
        - `mantra` string, nullable
        - `japaCount` number, nullable
    - `avoid` unknown[], nullable
      - unknown
    - `cautions` unknown[], nullable
      - unknown
    - `condition` object, nullable
      - `Venus` object, nullable
        - `signName` string, nullable
        - `dignity` string, nullable
        - `isCombust` boolean, nullable
    - `disclaimer` string, nullable

## Other responses

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

---

[API](https://skmtc.net/astroway/apis/astroway-calculation-api.md) · [All operations](https://skmtc.net/astroway/apis/astroway-calculation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/astroway/astroway-calculation-api/revisions/6828e5609564/schema)