latestOpenAPI 3.1.02026-08-237602082.8 MB

529d7d36d7d6

Core

Natal Chart

Calculate a full natal chart: planets, house cusps, aspects, sect, and angular data for a given birth moment. When the birth time is unknown, send timeUnknown: true instead of time and the response carries planets and aspects with houses, angles and sect set to null, plus a timeUnknown block giving the range the Moon covers that day.

post/chart

Request body

datestring required
timestring
timezoneOffsetnumber 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.

latitudenumber required
longitudenumber required
houseSystemstring
namestring
citystring
zodiacType'tropical' | 'sidereal'
ayanamsaIdnumber 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.

cosmogramboolean
timeUnknownboolean

Response

Successful calculation

okboolean

Example response

{
  "ok": true
}