POST/api/astro/trimsamsa/1 credit

Trimsamsa (D30)

The trimsamsa, the thirtieth divisional chart: each sign divided into thirty parts of 1° each. Read for misfortune, hardship and character. Note the classical trimsamsa divisions are unequal and exclude the luminaries in some traditions, so compare against your own reference before relying on it. Returns the same flat shape as /api/astro/planet-positions/: the planets as a list in traditional order with `name`, longitude, sign, nakshatra, pada and house on each, plus the ascendant and the ayanamsa applied. Send a date and a place; `ayanamsa` defaults to LAHIRI and all 48 are accepted. The chart is fixed by the route, so a `chart_name` in the body is ignored - this endpoint cannot return anything but the chart it is named for. /api/astro/chart/ is where to go for the other 24 divisions.

https://yogataraapi.prahlad.app/api/astro/trimsamsa/

Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Request fields

Field	Type	Required	Notes
chart_name	string	required
datetime	string (date-time)	required	The moment to calculate for, ISO 8601. ALWAYS include an offset or a trailing Z - a value with no zone is read as Asia/Kolkata (UTC+05:30), not UTC. Same meaning as date_time, which other endpoints call the same thing by a different name.
latitude	number (double)	required	Latitude of the place, in decimal degrees. Positive is north, negative is south. Example: 26.9124 for Jaipur, 40.7128 for New York. Minutes and seconds are not accepted - convert first. min -89.9 · max 89.9
longitude	number (double)	required	Longitude of the place, in decimal degrees. Positive is east, negative is west. Example: 75.7873 for Jaipur, -74.0060 for New York. Note the sign: a missing minus puts New York in China. min -180 · max 180
aberration	boolean	optional
apply_correction	boolean	optional
ascendant_pos	string	optional	`cuspstartend`
ayanamsa	string	optional
correction_deg	integer	optional	min 0
correction_direction	string	optional	`addsubtract`
correction_min	integer	optional	min 0 · max 59
correction_sec	integer	optional	min 0 · max 59
extended_bodies	array	optional	Body groups to include: 'asteroids', 'planetary_moons', 'fictitious_bodies'.
notation	string	optional	`astrologicaldegree`
nutation	boolean	optional
rahu	string	optional	Node type to include. 'true' returns true nodes only, 'mean' returns mean nodes only, 'both' returns both. `truemeanboth`
refraction	boolean	optional
true_mean	string	optional	`TrueMean`
use_28_nakshatras	boolean	optional

Example request

curl -X POST https://yogataraapi.prahlad.app/api/astro/trimsamsa/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2026-09-01T06:00:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"ayanamsa":"LAHIRI"}'

Response

{
  "data": {
    "planets": [
      {
        "name": "sun",
        "longitude": 251.425,
        "latitude": 0,
        "nakshatra": "Moola",
        "pada": 4,
        "kakshya": "sun",
        "zodiac_name": "Sagittarius",
        "house": 1
      },
      {
        "name": "moon",
        "longitude": 14.333333333333336,
        "latitude": 4.37,
        "nakshatra": "Bharani",
        "pada": 1,
        "kakshya": "sun",
        "zodiac_name": "Aries",
        "house": 5
      },
      {
        "name": "mars",
        "longitude": 65.24166666666667,
        "latitude": 0.535,
        "nakshatra": "Mrigasira",
        "pada": 4,
        "kakshya": "jupiter",
        "zodiac_name": "Gemini",
        "house": 7
      },
      {
        "name": "mercury",
        "longitude": 75.23333333333335,
        "latitude": 1.574,
        "nakshatra": "Aardra",
        "pada": 3,
        "kakshya": "venus",
        "zodiac_name": "Gemini",
        "house": 7
      },
      {
        "name": "jupiter",
        "longitude": 344.1583333333333,
        "latitude": 0.529,
        "nakshatra": "Uttaraabhaadra",
        "pada": 4,
        "kakshya": "sun",
        "zodiac_name": "Pisces",
        "house": 4
      },
      {
        "name": "venus",
        "longitude": 238.67499999999995,
        "latitude": -3.391,
        "nakshatra": "Jyeshtha",
        "pada": 4,
        "kakshya": "ascendant",
        "zodiac_name": "Scorpio",
        "house": 12
      },
      {
        "name": "saturn",
        "longitude": 343.4083333333333,
        "latitude": -2.651,
        "nakshatra": "Uttaraabhaadra",
        "pada": 4,
        "kakshya": "sun",
        "zodiac_name": "Pisces",
        "house": 4
      },
      {
        "name": "northtruenode",
        "longitude": 316.975,
        "latitude": 0,
        "nakshatra": "Satabhishak",
        "pada": 4,
        "kakshya": "venus",
        "zodiac_name": "Aquarius",
        "house": 3
      },
      {
        "name": "southtruenode",
        "longitude": 316.975,
        "latitude": 0,
        "nakshatra": "Satabhishak",
        "pada": 4,
        "kakshya": "venus",
        "zodiac_name": "Aquarius",
        "house": 3
      },
      {
        "name": "uranus",
        "longitude": 162.71666666666664,
        "latitude": -0.154,
        "nakshatra": "Hasta",
        "pada": 1,
        "kakshya": "sun",
        "zodiac_name": "Virgo",
        "house": 10
      },
      {
        "name": "neptune",
        "longitude": 162.98333333333335,
        "latitude": -1.412,
        "nakshatra": "Hasta",
        "pada": 1,
        "kakshya": "sun",
        "zodiac_name": "Virgo",
        "house": 10
      },
      {
        "name": "pluto",
        "longitude": 158.36666666666667,
        "latitude": -4.3,
        "nakshatra": "Uttara Phalguni",
        "pada": 4,
        "kakshya": "mars",
        "zodiac_name": "Virgo",
        "house": 10
      }
    ],
    "ascendant": {
      "longitude": 245.63333333333335,
      "zodiac_name": "Sagittarius",
      "nakshatra": "Makha",
      "pada": 4
    },
    "ayanamsa": {
      "name": "LAHIRI",
      "corrected": false,
      "value_degrees": 24.229599,
      "formatted": "24°13'47\""
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Captured from a real call using the exact request above. Results sit under data.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.