KP Horary Prashna & Birth Time Rectification APIs

1. KP Horary Prashna (Seed 1–249)

1. Name

KP Stellar Horary Judgment Engine

2. Purpose

Computes the Krishnamurti Padhdhati (KP System) horary chart based on an integer seed number between 1 and 249. Uses the Placidus house system and KP Ayanamsha to evaluate query culmination via ruling planets and cusp sub-lords.

3. Endpoint

POST /api/v1/prashna

4. Auth

Type: None / API Key
Header Example: X-API-Key: sk_live_... or Authorization: Bearer <jwt>

5. Request Payload

{
  "seed_number": 142,
  "datetime": "1983-10-01T20:50:00",
  "timezone": "Asia/Kolkata",
  "latitude": 11.3410,
  "longitude": 77.7172,
  "location": "Erode",
  "query": "Will I achieve favorable career advancement?"
}

6. Success Response

Status: 200 OK

{
  "status": "success",
  "data": {
    "chart": {
      "lagna": {
        "sign": "Scorpio",
        "degree": 14.52,
        "sign_lord": "Mars",
        "star_lord": "Saturn",
        "sub_lord": "Venus"
      },
      "houses": [ ... ],
      "planets": { ... }
    }
  }
}

2. Birth Time Rectification Engine

1. Name

Algorithmic Birth Time Rectification

2. Purpose

Scans an approximate birth time window (10–60 minutes) at high resolution (1–5 minutes) to evaluate Tattva Shodhana, Kunda alignment, Navamsha Lagna transitions, and major life event transits to identify the optimal birth timestamp.

3. Endpoint

POST /api/v1/rectify

4. Request Payload

{
  "name": "Santhosh Murthy R",
  "datetime": "1983-10-01T20:50:00",
  "timezone": "Asia/Kolkata",
  "latitude": 11.3410,
  "longitude": 77.7172,
  "location": "Erode",
  "window_minutes": 30,
  "step_minutes": 2,
  "life_events": [
    { "type": "marriage", "date": "2012-06-15" },
    { "type": "career", "date": "2006-08-01" }
  ]
}

5. Success Response

Status: 200 OK

{
  "status": "success",
  "data": {
    "best_candidate": {
      "datetime": "1983-10-01T20:50:00",
      "offset_minutes": 0,
      "confidence_score": 94,
      "lagna_sign": "Taurus",
      "navamsha_lagna": "Scorpio"
    },
    "tattva_shodhana": {
      "element": "Prithvi",
      "gender_match": true
    },
    "candidates": [ ... ]
  }
}

3. Master Horoscope Report Data (JSON Format)

1. Name

Master Horoscope Structured Export

2. Purpose

Returns complete structured JSON chart data (planetary positions, bhavas, vargas, dashas) for rendering printable reports or external frontends.

3. Endpoint

POST /api/v1/horoscope/report-data

4. Request Payload

{
  "dob": "1983-10-01",
  "birth_time": "20:50:00",
  "birth_place": {
    "latitude": 11.3410,
    "longitude": 77.7172,
    "timezone": "Asia/Kolkata"
  },
  "gender": "male",
  "output_format": "json"
}

4. Authentication & Password Recovery

1. Request Password Reset

2. Complete Password Reset