---
title: "Personal Nakshatra Prediction (Tarabala)"
method: POST
path: "/v1/astro/nakshatra/prediction"
tags: ["Astrology"]
---

# Personal Nakshatra Prediction (Tarabala)

`POST /v1/astro/nakshatra/prediction`

## Request

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

Returns a personalised daily prediction using Tarabala and Chandrabala for the day at the birth place (sunrise to next sunrise). The top-level tara is the one at sunrise; transit_nakshatras lists every nakshatra the Moon passes through that day with its tara. The tara names the round of nine: the first tara is Janma at count 1 (Moon in the birth nakshatra), Anujanma at 10 and Trijanma at 19. Tarabala measures the auspiciousness of the current day for an individual by assessing the relationship between their natal Moon nakshatra and the daily transit Moon nakshatra. Nine Taras from Janma (birth) to Ati-Mitra (great friend). Chandrabala measures the transit Moon's house from natal Moon. Also returns the transit nakshatra's quality type (Dhruva/Chara/ Ugra/Tikshna/Kshipra/Mridu/Mishra) with auspicious and inauspicious activities for today.

## Request body

- NakshatraPredictionRequest: Nakshatra daily prediction — extends BirthInput with optional target_date.
  - `location` string, nullable: City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.
  - `name` string: Person name associated with the birth record
  - `date` string, required: Birth date in YYYY-MM-DD format
  - `time` string, required: Birth time in HH:MM 24-hour format. Required: this endpoint has no sunrise fallback.
  - `latitude` number, nullable: Latitude. Required if location not provided.
  - `longitude` number, nullable: Longitude. Required if location not provided.
  - `timezone` string, nullable: IANA timezone. Required if location not provided (unless utc_offset is given). For dates before the zone adopted a standard time, the birthplace's local mean time (longitude / 15 hours) is used.
  - `utc_offset` string, nullable: Optional explicit UTC offset of the birth time, as ±HH:MM or ±HH:MM:SS (e.g. '+04:51:31' for Bombay mean time). Overrides the offset `timezone` would give. Use it when the birth record states the offset, or for historical local times the IANA database cannot represent.
  - `ayanamsa` 'lahiri' | 'raman' | 'kp' | 'tropical': Sidereal ayanamsa mode used in calculations
  - `target_date` string, date, nullable: Date for the prediction day; defaults to today

## Response `200`

Successful Response

- ApiResponseNakshatraPredictionResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` NakshatraPredictionResponse, required
    - `birth_time_provided` boolean: True when a birth time was supplied. False when it was not: house, Ascendant and Moon-dependent results then carry the accuracy limits of an unknown birth time.
    - `target_date` string, required
    - `transit_moon` TransitMoonRef, required
      - `nakshatra` string, required
      - `nakshatra_index` integer, required
      - `rashi_index` integer, required
    - `tarabala` TarabalaDetail, required
      - `tara_number` integer, required: 1-9: Janma, Sampat, Vipat, Kshema, Pratyak, Sadhana, Naidhana, Mitra, Ati-Mitra.
      - `count_from_birth` integer, required: 1-27, counting the birth nakshatra as 1.
      - `cycle` integer, nullable: Round of nine the count falls in: 1, 2 or 3.
      - `cycle_name` string, nullable: Janma (counts 1-9), Anujanma (10-18) or Trijanma (19-27).
      - `name` string, required: Tara name; the first tara of rounds 2 and 3 is Anujanma and Trijanma.
      - `meaning` string, required
      - `is_favorable` boolean, required
      - `is_moon_in_birth_nakshatra` boolean, nullable: True only for count 1.
      - `interpretation` string, required
    - `chandrabala` ChandrabalaDetail, required
      - `moon_house_from_natal` integer, required
      - `is_favorable` boolean, required
      - `favorable_houses` integer[], required
    - `daily_score` DailyScore, required
      - `score` integer, required
      - `max_score` integer, required
      - `label` string, required
    - `transit_nakshatra_quality` TransitNakshatraQuality, required
      - `nakshatra` string, required
      - `quality_type` string, required
      - `english` string, required
      - `auspicious_for` string[], required
      - `inauspicious_for` string[], required
    - `nakshatra_activities` NakshatraActivities, required
      - `favorable` string[], required
      - `unfavorable` string[], required
    - `birth_nakshatra` BirthNakshatraRef, required
      - `name` string, required
      - `index` integer, required
    - `natal_moon_sign_index` integer, required
    - `transit_nakshatras` TransitNakshatraTara[], nullable: Every nakshatra the Moon passes through from sunrise to the next sunrise at the birth place, each with its tara.
      - `nakshatra` string, required
      - `nakshatra_index` integer, required
      - `start` string, required: ISO 8601 local time.
      - `end` string, required: ISO 8601 local time.
      - `tara` TarabalaDetail, required
        - `tara_number` integer, required: 1-9: Janma, Sampat, Vipat, Kshema, Pratyak, Sadhana, Naidhana, Mitra, Ati-Mitra.
        - `count_from_birth` integer, required: 1-27, counting the birth nakshatra as 1.
        - `cycle` integer, nullable: Round of nine the count falls in: 1, 2 or 3.
        - `cycle_name` string, nullable: Janma (counts 1-9), Anujanma (10-18) or Trijanma (19-27).
        - `name` string, required: Tara name; the first tara of rounds 2 and 3 is Anujanma and Trijanma.
        - `meaning` string, required
        - `is_favorable` boolean, required
        - `is_moon_in_birth_nakshatra` boolean, nullable: True only for count 1.
        - `interpretation` string, required

## 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)