---
title: "Surya Siddhanta chart"
method: POST
path: "/surya-siddhanta"
tags: ["Birth charts & matching"]
---

# Surya Siddhanta chart

`POST /surya-siddhanta`

## Request

- Base URL: `https://jagannatha-hora-359167915530.europe-west1.run.app`
- URL: `https://jagannatha-hora-359167915530.europe-west1.run.app/surya-siddhanta`
- Auth: none declared

A natal chart computed by the Surya Siddhanta method: the lagna, planetary positions and panchanga, with the ayanamsa it implies compared against the mode you choose.

Rate limit: 60 requests a minute per IP.

## Request body

- object
  - `date` string, required: Birth date, YYYY-MM-DD. Years 1800 to 2100.
  - `time` string, required: Birth time, HH:MM:SS on a 24-hour clock.
  - `latitude` number, required: Decimal degrees, north positive. Places beyond 66° north or south are rejected with 400.
  - `longitude` number, required: Decimal degrees, -180 to 180, east positive.
  - `timezone` number, required: UTC offset in hours at birth, -12 to 14 (5.5 for India). By default the API works out the historically correct offset, including daylight saving, from the coordinates and date; see timezone_mode.
  - `place` string: Place name, echoed in the response. Coordinates decide the calculation.
  - `elevation` number: Metres above sea level. Echoed only.
  - `timezone_mode` 'auto' | 'file': auto works out the historical offset from the coordinates and date, falling back to timezone where no zone is known. file uses timezone exactly as sent. The response reports the offset used.
  - `ayanamsa_mode` 'LAHIRI' | 'TRUE_CITRA' | 'TRUE_LAHIRI' | 'KP' | 'FAGAN' | 'RAMAN' | 'USHASHASHI' | 'YUKTESHWAR' | 'SURYASIDDHANTA' | 'SURYASIDDHANTA_MSUN' | 'ARYABHATA' | 'ARYABHATA_MSUN' | 'SS_CITRA' | 'TRUE_REVATI' | 'SS_REVATI' | 'TRUE_PUSHYA' | 'TRUE_MULA' | 'KP-SENTHIL' | 'SENTHIL' | 'SIDM_USER': The ayanamsa to compare the Surya Siddhanta result against.
  - `ayanamsa_value` number: Your own ayanamsa in degrees, -30 to 30. Required with ayanamsa_mode SIDM_USER, which is refused with 422 without it.

## Response `200`

Success

- object
  - `birth_details` object: The inputs as used, including the UTC offset applied. Keys: date, time, place, latitude, longitude, elevation, timezone, timezone_used, timezone_derived, timezone_source.
  - `surya_siddhanta` object: The chart. Keys: method, epoch, ayanamsa, lagna, planets, panchanga.

## Other responses

- `400`: The input cannot be used for this calculation. The detail says why.
- `422`: A field is missing or out of range. The detail says which.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/jagannathahora/apis/vedic-astrology-calculation-api.md) · [All operations](https://skmtc.dev/jagannathahora/apis/vedic-astrology-calculation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jagannathahora/apis/vedic-astrology-calculation-api/revisions/bb90e41e2ba1?raw)