Kundali Report¶
6 endpoint(s).
| Endpoint | Method | Summary | Auth |
|---|---|---|---|
/api/v1/kundali/basic |
POST |
Generate Basic Kundali | |
/api/v1/kundali/export/pdf |
POST |
Export Pdf | |
/api/v1/kundali/free-pdf |
POST |
Free Pdf | |
/api/v1/kundali/generate |
POST |
Generate Kundali | |
/api/v1/kundali/generate-part/{part_number} |
POST |
Generate Part | |
/api/v1/kundali/tiers |
GET |
Get Tiers |
POST /api/v1/kundali/basic¶
Generate Basic Kundali
Free basic kundali — D1 chart + key birth facts.
Returns lagna, planet positions, moon nakshatra, current mahadasha lord,
D9 navamsa, yogas/cancellations, and a small personalized remedy teaser
(remedy_teaser: 1 gemstone + 1 mantra for the native's single weakest
planet, from planet_remedies). No divisional charts beyond D9, no
narrative sections, and only a 2-item remedy preview (not the full
weak-planet/daan/vrat remedy set) — those are in /generate.
Always free, no signup required, no payment gate.
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 |
any |
no | Native's name (optional — unused by /basic) |
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/kundali/basic' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/kundali/export/pdf¶
Export Pdf
Generate and export Kundali report as PDF.
Uses WeasyPrint for PDF generation with proper Hindi font support.
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) |
tier |
TierLevel |
no | Product tier level (essential, standard, professional, premium, master) |
language |
LanguageChoice |
no | Report language (en, hi, hinglish) |
use_ai |
boolean |
no | Use AI interpretation for narrative text (requires API key) |
Response 422 — HTTPValidationError
Example
curl -X POST 'https://api.example.com/api/v1/kundali/export/pdf' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/kundali/free-pdf¶
Free Pdf
Download the FREE kundali as a PDF. The free report stays long/detailed (Essential tier — D1 + D9 North-Indian charts plus the full free analysis), but the download REQUIRES the visitor's email + phone, which we capture as a lead before returning the PDF. No payment and no paywall here — the contact details are the price of the free download.
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 |
string |
yes | Email (required for the free download) |
phone |
string |
yes | Phone (required for the free download) |
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) |
language |
LanguageChoice |
no | Report language (en, hi, hinglish) |
Response 422 — HTTPValidationError
Example
curl -X POST 'https://api.example.com/api/v1/kundali/free-pdf' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/kundali/generate¶
Generate Kundali
Generate complete professional Kundali report.
The report includes up to 20 parts covering: - Part 1-2: Foundation & Personality - Part 3-4: Wealth & Career - Part 5-7: Marriage, Children, Health - Part 8-11: Extended life areas - Part 12-16: Technical analysis (Yogas, Doshas, Dasha, Ashtakavarga) - Part 17-20: Remedies, Vargas, Special Topics, Appendix
Tier levels determine content depth: - Essential (Rs. 299): Basic analysis, D1 chart, 20-25 pages - Standard (Rs. 799): D1+D9, all core areas, 40-50 pages - Professional (Rs. 1,999): D1+D9+D10+D7, 80-100 pages - Premium (Rs. 3,999): 11 charts, detailed analysis, 120-150 pages - Master (Rs. 7,999): All 16 charts, complete 20-part analysis, 180+ pages
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) |
tier |
TierLevel |
no | Product tier level (essential, standard, professional, premium, master) |
language |
LanguageChoice |
no | Report language (en, hi, hinglish) |
use_ai |
boolean |
no | Use AI interpretation for narrative text (requires API key) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/kundali/generate' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/kundali/generate-part/{part_number}¶
Generate Part
Generate a single part of the kundali report (for preview).
Uses the MASTER tier's 21 sections (A-U) so every part_number is available. Part numbers: 1. Foundation & Birth Data 8. Education & Learning 15. Transit Analysis 2. Personality & Character 9. Family Relations 16. Ashtakavarga 3. Wealth & Finance 10. Travel & Foreign 17. Shadbala Strength 4. Career & Profession 11. Spiritual & Dharma 18. Remedies & Upaya 5. Marriage & Relationships 12. Yoga Analysis 19. Divisional Charts 6. Children & Progeny 13. Dosha Analysis 20. Special Topics 7. Health & Vitality 14. Dasha & Timing 21. Appendix & Reference
| Param | In | Type | Required | Description |
|---|---|---|---|---|
part_number |
path | integer | 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) |
language |
LanguageChoice |
no | Report language |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/kundali/generate-part/${part_number}' \
-H 'Authorization: Bearer <API_KEY>'
GET /api/v1/kundali/tiers¶
Get Tiers
Get information about available product tiers.
Returns pricing, features, and content included in each tier.
Response 200 — VedicApiResponse
Example
curl -X GET 'https://api.example.com/api/v1/kundali/tiers' \
-H 'Authorization: Bearer <API_KEY>'