POST/v1/astro/pitra-dosha

Pitru Dosha (Pitru Shapa)

Detects and analyses Pitru Dosha (Pitru Shapa — Ancestral Curse) from the natal chart using all five classical combinations that indicate Pitru Dosha presence. Returns presence flag, severity (mild/moderate/severe), which of the 5 classical combinations are triggered, Sun and 9th lord analysis, afflicting planets, cancellation conditions (Jupiter protective), classical symptoms, and classical remedies. Primary classical symptom: denial of progeny or difficulties with children. The 9th, 5th and lagna lords are taken by whole sign from the lagna; aspects are full Parashari graha drishti (Mars 4/7/8, Jupiter 5/7/9, Saturn 3/7/10, Rahu and Ketu 7). This is a standalone endpoint providing deeper analysis than the pitru_dosha field in /v1/astro/doshas.

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

timerequired

string

Birth time in HH:MM 24-hour format. Required: this endpoint has no sunrise 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 (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_offsetoptional

string | null

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.

ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.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.

data.present

boolean

data.severity

string | null

data.severity_note

string | null

data.combinations_triggered

array[string]

Names of the BPHS Ch.83 combinations that formed; details in combinations_detail.

data.combinations_detail

array[object]

One entry per formed combination, in the order of combinations_triggered.

data.combinations_detail[].combination

string

Name, e.g. 'Purvajanma Shapa Combination 2' (BPHS Ch.83).

data.combinations_detail[].description

string

What formed the combination in this chart.

data.combinations_detail[].factors

array[string]

The chart factors that met the combination's conditions.

data.combinations_detail[].weight

integer

Severity weight this combination adds (2 or 3).

data.combinations_count

integer

data.sun_analysis

object

data.sun_analysis.house

integer | null

data.sun_analysis.sign_index

integer | null

data.sun_analysis.debilitated

boolean

data.sun_analysis.afflictions

array[string]

data.ninth_lord_analysis

object

data.ninth_lord_analysis.planet

string | null

data.ninth_lord_analysis.house

integer | null

data.ninth_lord_analysis.sign_index

integer | null

data.ninth_lord_analysis.debilitated

boolean

data.ninth_lord_analysis.afflictions

array[string]

data.all_factors

array[string]

data.cancellations

array[string]

data.interpretation

string

data.classical_symptoms

array[string]

data.remedies

array[string]

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

• Calculate dosha report
• Ghat Chakra
• Sade Sati periods
• Calculate yoga combinations

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/astro/pitra-dosha" \
  -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.pitru_dosha_request import PitruDoshaRequest

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

request = PitruDoshaRequest(
    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.pitra_dosha(pitru_dosha_request=request)
    print(result)

TypeScript

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

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

const result = await pitraDosha({
  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": {
    "present": true,
    "severity": "moderate",
    "severity_note": "Classical Pitru Shapa indicators present. Ancestral rites and remediation are recommended.",
    "combinations_triggered": [],
    "combinations_detail": [],
    "combinations_count": 0,
    "sun_analysis": {
      "house": 1,
      "sign_index": 6,
      "debilitated": true,
      "afflictions": [
        "aspected by Rahu",
        "conjunct Saturn",
        "... and 1 more item"
      ]
    },
    "ninth_lord_analysis": {
      "planet": "Mercury",
      "house": 2,
      "sign_index": 7,
      "debilitated": false,
      "afflictions": []
    },
    "all_factors": [
      "Sun debilitated",
      "aspected by Rahu",
      "... and 2 more items"
    ],
    "cancellations": [],
    "interpretation": "Pitru Shapa (ancestral curse) operates as karma unresolved within the family lineage expressing itself in the current ge…",
    "classical_symptoms": [
      "Denial of progeny or difficulties with children (primary Pitru Dosha indicator)",
      "End of family lineage",
      "... and 2 more items"
    ],
    "remedies": [
      "Pitru Tarpan on Amavasya (new moon) every month",
      "Shradh ceremonies during Pitru Paksha (16-day ancestral fortnight)",
      "... and 4 more items"
    ]
  }
}