POST/v1/astro/prashna

Prashna (Horary Chart)

Computes a Prashna (Horary) chart for the exact moment a question is asked. Returns lagna, Moon analysis, house lord condition, occupants of the relevant house, and a classical verdict (favourable / unfavourable / mixed) with confidence level. Question category determines which house is analysed; that house and its lord are taken by whole sign from the lagna, like the planets' houses.

Request parameters

latituderequired

number

Querent location latitude

longituderequired

number

Querent location longitude

questionrequired

string

Question category

target_dateoptional

string | null

YYYY-MM-DD. Defaults to now: the current date and time in target_timezone.

target_timeoptional

string | null

HH:MM (24h), with target_date. Defaults to the current time in target_timezone; ignored without target_date.

target_timezoneoptional

string | null

IANA timezone for input date/time

ayanamsaoptional

string

Ayanamsa system: lahiri (default), raman, kp, or tropical for a zero offset, as on every other chart endpoint

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.ayanamsa

string

data.question

string

data.primary_house

integer

data.ithsala_applying

boolean

Tajika Ithasala (applying) between the Lagna lord and the quesited house lord, by the Varshaphal rule: Tajika aspect by sign (same sign, 3rd/11th, 4th/10th, 5th/9th, 7th), the faster planet by mean motion (Moon, Mercury, Venus, Sun, Mars, Jupiter, Saturn) behind the slower in degrees within the mean of their Deeptamsas. Retrogression is not modelled. False when one planet rules both houses (always for 'self'; compare lagna.lord and house_analysis.lord).

data.ithsala_separating

boolean

Tajika Musaripha (separating): the two lords in Tajika aspect within the same orb but the faster planet already past the slower one's degree. False when one planet rules both houses.

data.query_utc

string

data.lagna

object

data.lagna.rashi_index

integer

data.lagna.rashi

string

data.lagna.longitude

number

data.lagna.lord

string

data.house_analysis

object

data.house_analysis.house

integer

data.house_analysis.rashi_index

integer

Sign of the quesited house, counted whole sign from the lagna sign (0 = Mesha).

data.house_analysis.rashi

string

data.house_analysis.lord

string

Lord of the quesited house by whole sign (lord of its sign), as BPHS and Jagannatha Hora read lordship.

data.house_analysis.lord_dignity

string

data.house_analysis.lord_house

integer

data.house_analysis.lord_longitude

number

data.house_analysis.occupants

array[string]

data.moon

object

data.moon.longitude

number

data.moon.rashi_index

integer

data.moon.rashi

string

data.moon.nakshatra

string

data.moon.phase

string

data.moon.dignity

string

data.moon.void_of_course

boolean

data.moon.afflicted_moon

boolean

data.moon.applying_to_benefic

boolean

data.verdict

object

data.verdict.verdict

string

data.verdict.confidence

string

data.verdict.score

integer

data.planets

object

data.house_cusps

object

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Gochar — Transit Analysis
• Muhurta — Auspicious Timing
• Personal Nakshatra Prediction (Tarabala)
• Planetary transits — Gochar
• Tarabala and Chandrabala
• Varshaphal — Solar Return Chart
• Varshaphal — Harsha Bala
• Varshaphal — Tajika Saham Points
• Vedic daily factors
• Vedic events over a date range

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/astro/prashna" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":19.076,"longitude":72.8777,"question":"career","target_date":"1985-11-12","target_time":"06:45","target_timezone":"Asia/Kolkata"}'

Python

import asterwise
from asterwise.api.prashna_api import PrashnaApi
from asterwise.models.prashna_request import PrashnaRequest

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

request = PrashnaRequest(
    latitude=19.076,
    longitude=72.8777,
    question="career",
    target_date="1985-11-12",
    target_time="06:45",
    target_timezone="Asia/Kolkata",
)

with asterwise.ApiClient(configuration) as client:
    api = PrashnaApi(client)
    result = api.prashna(prashna_request=request)
    print(result)

TypeScript

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

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

const result = await prashna({
  client,
  body: {
      "latitude": 19.076,
      "longitude": 72.8777,
      "question": "career",
      "target_date": "1985-11-12",
      "target_time": "06:45",
      "target_timezone": "Asia/Kolkata"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "ayanamsa": "lahiri",
    "question": "career",
    "primary_house": 10,
    "ithsala_applying": false,
    "ithsala_separating": true,
    "query_utc": "1985-11-12T01:15:00Z",
    "lagna": {
      "rashi_index": 6,
      "rashi": "Tula",
      "longitude": 205.3029,
      "lord": "Venus"
    },
    "house_analysis": {
      "house": 10,
      "rashi_index": 3,
      "rashi": "Karka",
      "lord": "Moon",
      "lord_dignity": "neutral",
      "lord_house": 1,
      "lord_longitude": 198.1821,
      "occupants": []
    },
    "moon": {
      "longitude": 198.1821,
      "rashi_index": 6,
      "rashi": "Tula",
      "nakshatra": "Swati",
      "phase": "waning",
      "dignity": "neutral",
      "void_of_course": false,
      "afflicted_moon": true,
      "applying_to_benefic": false
    },
    "verdict": {
      "verdict": "mixed",
      "confidence": "low",
      "score": 1
    },
    "planets": {
      "Sun": {
        "longitude": 205.9405,
        "rashi_index": 6,
        "rashi": "Tula",
        "house": 1,
        "is_retrograde": false,
        "dignity": "debilitated"
      },
      "Moon": {
        "longitude": 198.1821,
        "rashi_index": 6,
        "rashi": "Tula",
        "house": 1,
        "is_retrograde": false,
        "dignity": "neutral"
      },
      "Mars": {
        "longitude": 165.9962,
        "rashi_index": 5,
        "rashi": "Kanya",
        "house": 12,
        "is_retrograde": false,
        "dignity": "neutral"
      },
      "Mercury": {
        "longitude": 228.5229,
        "rashi_index": 7,
        "rashi": "Vrischika",
        "house": 2,
        "is_retrograde": false,
        "dignity": "neutral"
      },
      "Jupiter": {
        "longitude": 285.9597,
        "rashi_index": 9,
        "rashi": "Makara",
        "house": 4,
        "is_retrograde": false,
        "dignity": "debilitated"
      },
      "Venus": {
        "longitude": 189.3758,
        "rashi_index": 6,
        "rashi": "Tula",
        "house": 1,
        "is_retrograde": false,
        "dignity": "own"
      },
      "Saturn": {
        "longitude": 215.7471,
        "rashi_index": 7,
        "rashi": "Vrischika",
        "house": 2,
        "is_retrograde": false,
        "dignity": "neutral"
      },
      "Rahu": {
        "longitude": 14.809,
        "rashi_index": 0,
        "rashi": "Mesha",
        "house": 7,
        "is_retrograde": true,
        "dignity": "neutral"
      },
      "Ketu": {
        "longitude": 194.809,
        "rashi_index": 6,
        "rashi": "Tula",
        "house": 1,
        "is_retrograde": true,
        "dignity": "neutral"
      }
    },
    "house_cusps": {
      "1": {
        "rashi_index": 6,
        "rashi": "Tula",
        "lord": "Venus",
        "longitude": 205.3029
      },
      "2": {
        "rashi_index": 7,
        "rashi": "Vrischika",
        "lord": "Mars",
        "longitude": 234.5175
      },
      "3": {
        "rashi_index": 8,
        "rashi": "Dhanu",
        "lord": "Jupiter",
        "longitude": 264.8548
      },
      "4": {
        "rashi_index": 9,
        "rashi": "Makara",
        "lord": "Saturn",
        "longitude": 296.6886
      },
      "5": {
        "rashi_index": 10,
        "rashi": "Kumbha",
        "lord": "Saturn",
        "longitude": 328.8216
      },
      "6": {
        "rashi_index": 11,
        "rashi": "Meena",
        "lord": "Jupiter",
        "longitude": 358.7506
      },
      "7": {
        "rashi_index": 0,
        "rashi": "Mesha",
        "lord": "Mars",
        "longitude": 25.3029
      },
      "8": {
        "rashi_index": 1,
        "rashi": "Vrishabha",
        "lord": "Venus",
        "longitude": 54.5175
      },
      "9": {
        "rashi_index": 2,
        "rashi": "Mithuna",
        "lord": "Mercury",
        "longitude": 84.8548
      },
      "10": {
        "rashi_index": 3,
        "rashi": "Karka",
        "lord": "Moon",
        "longitude": 116.6886
      },
      "11": {
        "rashi_index": 4,
        "rashi": "Simha",
        "lord": "Sun",
        "longitude": 148.8216
      },
      "12": {
        "rashi_index": 5,
        "rashi": "Kanya",
        "lord": "Mercury",
        "longitude": 178.7506
      }
    }
  }
}