Medical Astrology¶
8 endpoint(s).
| Endpoint | Method | Summary | Auth |
|---|---|---|---|
/api/v1/medical/ai-reading |
POST |
Generate Ai Medical Reading | |
/api/v1/medical/analyze |
POST |
Analyze Medical | |
/api/v1/medical/constitution |
POST |
Get Constitution | |
/api/v1/medical/disease-risk |
POST |
Get Disease Risk | |
/api/v1/medical/remedies |
POST |
Get Health Remedies | |
/api/v1/medical/strong-planets |
POST |
Get Strong Planets | |
/api/v1/medical/timeline-reading |
POST |
Generate Timeline Reading | |
/api/v1/medical/weak-planets |
POST |
Get Weak Planets |
POST /api/v1/medical/ai-reading¶
Generate Ai Medical Reading
Generate AI-powered personalized medical reading using Claude Haiku 3.5.
Takes the medical analysis data and transforms it into a conversational Hindi/Hinglish interpretation in the style of a caring Vedic astrologer.
Features: - Personalized health interpretation - Explanation of weak/strong planets effect on health - Practical remedies and advice - Reassuring, warm tone
Cost: ~₹0.02-0.05 per reading (Haiku is very economical)
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
medical_data |
object |
yes | Medical analysis result data |
style |
string |
no | Reading style: astrologer or quick |
language |
string |
no | Language: hinglish or hindi |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/medical/ai-reading' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/medical/analyze¶
Analyze Medical
Complete Medical Astrology Analysis.
Performs 5-layer analysis: 1. Foundation - Planet positions (Whole Sign houses) 2. Planetary Weakness - Debilitation, combustion, functional malefics 3. Disease Indication - Body parts and diseases from weak planets 4. Timing Analysis - Dasha and transit effects on health 5. Output - Risk level, concerns, remedies
Returns comprehensive health vulnerability report.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
mahadasha_lord |
any |
no | Mahadasha lord (MD) - Years level |
antardasha_lord |
any |
no | Antardasha lord (AD) - Months level |
pratyantardasha_lord |
any |
no | Pratyantardasha lord (PD) - Weeks level |
sookshma_lord |
any |
no | Sookshma lord (SD) - Days level |
prana_lord |
any |
no | Prana lord (PAD) - Hours level |
analysis_date |
any |
no | Date for transit analysis (YYYY-MM-DD) |
include_transits |
boolean |
no | Include transit analysis |
include_remedies |
boolean |
no | Include remedies in response |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/medical/analyze' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/medical/constitution¶
Get Constitution
Get Ayurvedic health constitution from planetary positions.
Analyzes: - Lagna lord's element and humour - Moon lord's element and humour - Dominant element (Fire, Water, Earth, Air, Ether) - Dominant humour (Vata, Pitta, Kapha) - Body type (Bilious, Phlegmatic, Windy)
Based on classical planet constituents.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/medical/constitution' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/medical/disease-risk¶
Get Disease Risk
Get disease risk indications from planetary weaknesses.
Maps weak planets to: - Vulnerable body parts - Disease indications with probability scores - Severity levels - Protected body parts (from strong planets/Neecha Bhanga)
Based on classical diseases_by_planet and illness_timing principles.
NOTE: Planets with Neecha Bhanga Raja Yoga PROTECT their body parts!
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
top_n |
integer |
no | Number of top disease indications to return |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/medical/disease-risk' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/medical/remedies¶
Get Health Remedies
Get health remedies based on weak planets.
Returns remedies including: - Mantras with timing - Gemstones - Donations - Worship recommendations
Prioritized by planet weakness score.
NOTE: Planets with Neecha Bhanga Raja Yoga don't need remedies - they're already powerful!
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
max_remedies |
integer |
no | Maximum number of remedies to return |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/medical/remedies' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/medical/strong-planets¶
Get Strong Planets
Get planetary strength analysis including Neecha Bhanga Raja Yoga!
IMPORTANT: Planets with Neecha Bhanga Raja Yoga are STRONG, not weak! Classical texts say: "Native becomes ruler of Earth", "King of Kings"
Analyzes for: - Neecha Bhanga Raja Yoga (5 classical conditions) - Exaltation - Own sign placement - Digbala (directional strength) - Vargottama
Returns strength score and health protection level.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/medical/strong-planets' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/medical/timeline-reading¶
Generate Timeline Reading
Generate Timeline-based Medical Reading using Claude Haiku 3.5.
This combines Option 3 (कब क्या होगा - Timeline View) with Option 4 (Astrologer-Style Reading).
Features: - Time-based health predictions (अभी, 6 months, 1 year, 2-5 years, long-term) - Dasha-wise health forecasting - Body parts vulnerability calendar - Personalized remedies with timing - Caring astrologer tone in Hinglish
Output: Structured JSON for easy frontend rendering
Cost: ~₹0.03-0.06 per reading
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
medical_data |
object |
yes | Complete medical analysis data |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/medical/timeline-reading' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/medical/weak-planets¶
Get Weak Planets
Get planetary weakness analysis only.
Analyzes each planet for: - Debilitation (with Neecha Bhanga check!) - Combustion (with cancellation factors) - Enemy sign placement - Functional malefic status - Dusthana lordship (6th/8th/12th) - Placement in dusthanas - Lack of directional strength
NOTE: Planets with Neecha Bhanga Raja Yoga are NOT weak - they're STRONG! Use /strong-planets endpoint to see Raja Yoga planets.
Returns weakness score and types for each weak planet.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/medical/weak-planets' \
-H 'Authorization: Bearer <API_KEY>'