POST/v1/astro/gochar

Gochar — Transit Analysis

Computes planetary transits against a natal chart using classical Vedic rules. Returns house positions from Moon and Lagna, Vedha obstruction checks, Ashtakavarga Bhinna scores, Sade Sati and Chandra Ashtama flags, and classical transit interpretations for all 9 planets. Request JSON follows BirthInput plus optional transit fields target_date, target_time, target_timezone: name, date, time, location or latitude/longitude/timezone, ayanamsa.

Request parameters

locationoptional

string | null

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

nameoptional

string

Person name associated with the birth record

daterequired

string

Birth date in YYYY-MM-DD format

timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.

latitudeoptional

number | null

Latitude. Required if location not provided.

longitudeoptional

number | null

Longitude. Required if location not provided.

timezoneoptional

string | null

IANA timezone. Required if location not provided.

ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

target_dateoptional

string | null

YYYY-MM-DD. Defaults to today IST.

target_timeoptional

string | null

HH:MM. Defaults to noon.

target_timezoneoptional

string | null

Timezone for target_date/time.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.natal

object

data.natal.moon_sign

string

data.natal.moon_sign_index

integer

data.natal.ascendant_sign

string

data.natal.ascendant_sign_index

integer

data.target_date

string

data.transits

array[object]

data.transits[].planet

string

data.transits[].transit_sign

string

data.transits[].transit_sign_index

integer

data.transits[].transit_degree

number

data.transits[].is_retrograde

boolean

data.transits[].nakshatra

string | null

data.transits[].nakshatra_pada

integer | null

data.transits[].house_from_moon

integer

data.transits[].house_from_lagna

integer

data.transits[].is_favorable_from_moon

boolean

data.transits[].is_favorable_from_lagna

boolean

data.transits[].vedha_active

boolean

data.transits[].vedha_blocking_planet

string | null

data.transits[].ashtakavarga_score

integer | null

data.transits[].interpretation

string

data.transits[].themes

array[string]

data.transits[].quality

string

data.summary

object

data.summary.favorable_count

integer

data.summary.unfavorable_count

integer

data.summary.vedha_blocked_count

integer

data.summary.overall_score

integer

data.summary.sade_sati_active

boolean

data.summary.sade_sati_phase

string | null

data.summary.sade_sati_interpretation

object | null

Phase-specific Sade Sati interpretation when active. Contains name, duration, saturn_position, and interpretation text for the current phase (rising, peak, or setting).

data.summary.chandra_ashtama_active

boolean

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

API key tier does not include this endpoint.

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

• Muhurta — Auspicious Timing
• Personal Nakshatra Prediction (Tarabala)
• Planetary transits — Gochar
• Prashna (Horary Chart)
• Varshaphal — Solar Return Chart
• Varshaphal — Harsha Bala
• Varshaphal — Tajika Saham Points

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/astro/gochar" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata"}'

Python

import asterwise
from asterwise.api.astrology_api import AstrologyApi
from asterwise.models.gochar_request import GocharRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = GocharRequest(
    date="1985-11-12",
    time="06:45",
    latitude=19.076,
    longitude=72.8777,
    timezone="Asia/Kolkata",
)

with asterwise.ApiClient(configuration) as client:
    api = AstrologyApi(client)
    result = api.gochar(gochar_request=request)
    print(result)

TypeScript

import { createClient, createConfig, gochar } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await gochar({
  client,
  body: {
      "date": "1985-11-12",
      "time": "06:45",
      "latitude": 19.076,
      "longitude": 72.8777,
      "timezone": "Asia/Kolkata"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "natal": {
      "moon_sign": "Tula",
      "moon_sign_index": 6,
      "ascendant_sign": "Tula",
      "ascendant_sign_index": 6
    },
    "target_date": "2026-05-28",
    "transits": [
      {
        "planet": "Sun",
        "transit_sign": "Vrishabha",
        "transit_sign_index": 1,
        "transit_degree": 12.7365,
        "is_retrograde": false,
        "nakshatra": "Rohini",
        "nakshatra_pada": 1,
        "house_from_moon": 8,
        "house_from_lagna": 8,
        "is_favorable_from_moon": false,
        "is_favorable_from_lagna": false,
        "bindu_override": true,
        "vedha_active": false,
        "vedha_blocking_planet": null,
        "ashtakavarga_score": 1,
        "interpretation": "Fear, diseases, quarrel, royal displeasure, suffering from excessive heat",
        "themes": [
          "fear",
          "health challenges",
          "... and 2 more items"
        ],
        "quality": "unfavorable"
      },
      {
        "planet": "Moon",
        "transit_sign": "Tula",
        "transit_sign_index": 6,
        "transit_degree": 8.6178,
        "is_retrograde": false,
        "nakshatra": "Swati",
        "nakshatra_pada": 1,
        "house_from_moon": 1,
        "house_from_lagna": 1,
        "is_favorable_from_moon": false,
        "is_favorable_from_lagna": false,
        "bindu_override": true,
        "vedha_active": false,
        "vedha_blocking_planet": null,
        "ashtakavarga_score": 0,
        "interpretation": "Dawning of fortune",
        "themes": [
          "fresh start",
          "fortunate opening",
          "... and 2 more items"
        ],
        "quality": "favorable"
      },
      "... and 7 more items"
    ],
    "summary": {
      "favorable_count": 1,
      "unfavorable_count": 8,
      "vedha_blocked_count": 0,
      "overall_score": 0,
      "sade_sati_active": false,
      "sade_sati_phase": null,
      "sade_sati_interpretation": null,
      "chandra_ashtama_active": false
    }
  }
}