PDAE¶
10 endpoint(s).
| Endpoint | Method | Summary | Auth |
|---|---|---|---|
/api/v1/pdae/analyze |
POST |
Analyze Day | |
/api/v1/pdae/analyze-ai |
POST |
Analyze Day With Ai | |
/api/v1/pdae/ashtakavarga |
POST |
Get Ashtakavarga | |
/api/v1/pdae/best-days |
POST |
Find Best Days | |
/api/v1/pdae/monthly-calendar |
POST |
Monthly Calendar | |
/api/v1/pdae/range |
POST |
Analyze Date Range | |
/api/v1/pdae/score |
POST |
Get Day Score | |
/api/v1/pdae/tarabala |
POST |
Get Tarabala | |
/api/v1/pdae/today |
POST |
Analyze Today | |
/api/v1/pdae/transit/complete |
POST |
Get Complete Transit |
POST /api/v1/pdae/analyze¶
Analyze Day
Complete Personal Day Analysis.
Returns comprehensive analysis including: - Overall day score (0-100) - Category scores (career, finance, relationship, etc.) - Panchang details - COMPLETE 5-LAYER DASHA with exact dates and balance - TRANSIT analysis with entry/exit dates - Tarabala & Chandrabala - Muhurta timings - Daily yogas (Amrit Siddhi, etc.) - Recommendations and remedies
Format Options:
- json (default): Raw JSON data
- text_hi: Formatted Hindi text for users
- text_en: Formatted English text for users
| Param | In | Type | Required | Description |
|---|---|---|---|---|
target_date |
query | string | yes | Target date YYYY-MM-DD |
format |
query | string | no | Output format: json, text_hi, text_en |
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/pdae/analyze' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/pdae/analyze-ai¶
Analyze Day With Ai
Personal Day Analysis with AI-Generated Interpretation.
Uses Claude Haiku 3.5 to generate personalized Hindi interpretations based on all calculated data (dasha, transit, doshas, yogas, etc.).
Returns everything from /analyze PLUS: - ai_summary: Personalized daily summary in Hindi (200-250 words) - ai_tokens: Number of AI tokens used - ai_cost_estimate: Estimated cost in INR
Note: This endpoint costs ~₹0.15-0.25 per call.
| Param | In | Type | Required | Description |
|---|---|---|---|---|
target_date |
query | string | yes | Target date YYYY-MM-DD |
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/pdae/analyze-ai' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/pdae/ashtakavarga¶
Get Ashtakavarga
Calculate complete Ashtakavarga (BAV + SAV).
Returns: - Bhinnashtakavarga for 7 planets - Sarvashtakavarga totals - Strength classification per sign - Moorti Nirnaya
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/pdae/ashtakavarga' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/pdae/best-days¶
Find Best Days
Find best days in a date range for specific activities.
Categories: career, finance, relationship, health, education, travel, spirituality, legal
| Param | In | Type | Required | Description |
|---|---|---|---|---|
start_date |
query | string | yes | |
end_date |
query | string | yes | |
category |
query | any | no | Filter by category |
min_score |
query | integer | no | Minimum score threshold |
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/pdae/best-days' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/pdae/monthly-calendar¶
Monthly Calendar
Monthly calendar with categorized days.
Categories: - Best Days (70+): Highly auspicious for important work - Good Days (50-69): Favorable for most activities - Normal Days (35-49): Routine work only - Avoid Days (20-34): Avoid important decisions - Danger Days (<20): Highly inauspicious
| Param | In | Type | Required | Description |
|---|---|---|---|---|
month |
query | integer | yes | Month (1-12) |
year |
query | integer | yes | Year |
format |
query | string | no | Output format: json, text_hi, text_en |
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/pdae/monthly-calendar' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/pdae/range¶
Analyze Date Range
Analyze a date range (max 31 days).
Returns daily scores for the entire range.
| Param | In | Type | Required | Description |
|---|---|---|---|---|
start_date |
query | string | yes | Start date YYYY-MM-DD |
end_date |
query | string | yes | End date YYYY-MM-DD |
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/pdae/range' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/pdae/score¶
Get Day Score
Get just the scores (faster response).
Returns: - Overall score - Category scores - Quick recommendations
| Param | In | Type | Required | Description |
|---|---|---|---|---|
target_date |
query | string | yes | Target date YYYY-MM-DD |
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/pdae/score' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/pdae/tarabala¶
Get Tarabala
Get Tarabala and Chandrabala for a specific date.
Returns: - Tara number and name (1-9) - Tara nature (shubh/ashubh) - Chandrabala (house from Moon) - Combined assessment
| Param | In | Type | Required | Description |
|---|---|---|---|---|
target_date |
query | string | yes |
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/pdae/tarabala' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/pdae/today¶
Analyze Today
Analyze TODAY for the native.
Quick endpoint that uses current date. Includes COMPLETE 5-layer dasha and transit with dates.
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/pdae/today' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/pdae/transit/complete¶
Get Complete Transit
Complete transit analysis with Vedha and Ashtakavarga.
Returns: - Transit positions from Moon and Lagna - Vedha (obstruction) analysis - SAV scores for transit signs - Sade Sati status - Dhaiya status - Double Transit analysis
| Param | In | Type | Required | Description |
|---|---|---|---|---|
target_date |
query | string | yes |
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/pdae/transit/complete' \
-H 'Authorization: Bearer <API_KEY>'