API Reference

The VedIntelAstroAPI is a REST API built on Swiss Ephemeris — the same engine used by professional astrologers worldwide. All computations run locally on our servers with zero external dependency.

Base URLhttps://api.vedintelastroapi.com

Authentication

Every request requires an api_key query parameter. Get your key from the dashboard.

example
GET /api/v1/horoscope/planet-details?api_key=vi_live_xxxxxxxxxxxxxxxx&...

Common Parameters

These parameters are required by all birth-data endpoints.

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp

Response Format

All responses share the same envelope structure.

{
  "status": 200,          // HTTP status code
  "response": { ... },   // Endpoint-specific data
  "remaining_api_calls": 498  // Calls left in your quota
}

Rate Limits

PlanCalls / MonthReq / Sec
Free50020 req/sec
Starter100,00050 req/sec
Professional1,000,000200 req/sec
EnterpriseUnlimited500 req/sec

Error Codes

CodeMeaning
400Bad Request — missing or invalid parameter
401Unauthorized — invalid or missing api_key
429Too Many Requests — rate limit exceeded
500Internal Server Error — contact support

Find Ascendant

GET/api/v1/extended-horoscope/find-ascendant

Returns the Lagna (Ascendant) sign, degree, and Nakshatra based on birth data.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
curl "https://api.vedintelastroapi.com/api/v1/extended-horoscope/find-ascendant?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5"

Find Moon Sign

GET/api/v1/extended-horoscope/find-moon-sign

Returns the Moon Rashi (sign), degree, and Nakshatra for the given birth data.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
curl "https://api.vedintelastroapi.com/api/v1/extended-horoscope/find-moon-sign?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5"

Find Sun Sign

GET/api/v1/extended-horoscope/find-sun-sign

Returns the Sun Rashi (sign) and degree. Useful for Western sun sign display alongside Vedic computation.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
curl "https://api.vedintelastroapi.com/api/v1/extended-horoscope/find-sun-sign?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5"

Planet Details

GET/api/v1/horoscope/planet-details

Returns all 9 Vedic planets with their sign, degree, house placement, Nakshatra, and retrograde status.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
curl "https://api.vedintelastroapi.com/api/v1/horoscope/planet-details?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5"

Divisional Charts

GET/api/v1/horoscope/divisional-charts

Returns planetary positions for all major divisional charts (D1 through D60). Specify a chart number or get all.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
chart_idnumberoptionalDivisional chart number 1–60. Omit for all charts.
curl "https://api.vedintelastroapi.com/api/v1/horoscope/divisional-charts?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5&chart_id=9"

Chart Image (SVG)

GET/api/v1/horoscope/chart-image

Returns a rendered SVG birth chart. Style can be north_indian or south_indian. Format can be base64 or utf8.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
stylestringoptionalnorth_indian (default) | south_indian | east_indian
formatstringoptionalbase64 (default) | utf8
curl "https://api.vedintelastroapi.com/api/v1/horoscope/chart-image?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5&style=north_indian&format=utf8"

Current Mahadasha Full

GET/api/v1/dashas/current-mahadasha-full

Returns the currently running Mahadasha with all active sub-dashas (Antardasha, Pratyantar) and their exact date ranges.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
curl "https://api.vedintelastroapi.com/api/v1/dashas/current-mahadasha-full?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5"

Current Mahadasha

GET/api/v1/dashas/current-mahadasha

Returns the currently active Mahadasha lord with start and end dates.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
curl "https://api.vedintelastroapi.com/api/v1/dashas/current-mahadasha?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5"

Mahadasha Table

GET/api/v1/dashas/mahadasha

Returns the complete Vimshottari Mahadasha table for the lifetime — all 9 dasha periods with start and end dates.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
curl "https://api.vedintelastroapi.com/api/v1/dashas/mahadasha?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5"

Antardasha

GET/api/v1/dashas/antardasha

Returns all Antardasha (sub-dasha) periods within the current Mahadasha.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
curl "https://api.vedintelastroapi.com/api/v1/dashas/antardasha?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5"

Char Dasha (Current)

GET/api/v1/dashas/char-dasha-current

Returns the currently running Jaimini Char Dasha sign period with start and end dates.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
curl "https://api.vedintelastroapi.com/api/v1/dashas/char-dasha-current?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5"

Yogini Dasha (Main)

GET/api/v1/dashas/yogini-dasha-main

Returns the complete Yogini Dasha sequence — 8 Yogini periods with their ruling planet and exact date ranges.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
curl "https://api.vedintelastroapi.com/api/v1/dashas/yogini-dasha-main?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5"

Kaal Sarp Dosha

GET/api/v1/dosha/kaalsarp-dosh

Detects the presence of Kaal Sarp Dosha and identifies the specific type (Anant, Kulik, Vasuki, etc.).

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
curl "https://api.vedintelastroapi.com/api/v1/dosha/kaalsarp-dosh?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5"

Mangal Dosha

GET/api/v1/dosha/mangal-dosh

Analyses Mars placement for Mangal Dosha across all relevant houses and returns severity level.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
curl "https://api.vedintelastroapi.com/api/v1/dosha/mangal-dosh?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5"

Manglik Dosha

GET/api/v1/dosha/manglik-dosh

Returns detailed Manglik status with house analysis, cancellation factors, and compatibility implications.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
curl "https://api.vedintelastroapi.com/api/v1/dosha/manglik-dosh?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5"

Pitra Dosha

GET/api/v1/dosha/pitra-dosh

Analyses the chart for Pitra Dosha indicators — Sun-Rahu/Ketu conjunctions and 9th house afflictions.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
curl "https://api.vedintelastroapi.com/api/v1/dosha/pitra-dosh?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5"

Daily Panchang

GET/api/v1/panchang/panchang

Returns complete Panchang data for the given date and location — Tithi, Vara, Nakshatra, Yoga, Karana, Sunrise, Sunset.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
datestringrequiredDate for Panchang — DD/MM/YYYY
curl "https://api.vedintelastroapi.com/api/v1/panchang/panchang?api_key=YOUR_KEY&date=17/04/2026&lat=28.61&lon=77.20&tz=5.5"

Choghadiya Muhurta

GET/api/v1/panchang/choghadiya-muhurta

Returns day and night Choghadiya muhurta time slots for the given date and location with auspicious/inauspicious classification.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
datestringrequiredDate for muhurta — DD/MM/YYYY
curl "https://api.vedintelastroapi.com/api/v1/panchang/choghadiya-muhurta?api_key=YOUR_KEY&date=17/04/2026&lat=28.61&lon=77.20&tz=5.5"

AI Chart Interpretation

Phase 3 · Q3 2026
GET/api/v1/ai/interpret/chart

Generates a full human-quality narrative chart reading using Claude AI. Covers Ascendant, key planetary placements, prominent yogas, and current dasha period.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
# Phase 3 — Q3 2026
curl "https://api.vedintelastroapi.com/api/v1/ai/interpret/chart?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5"

AI Dasha Narrative

Phase 3 · Q3 2026
GET/api/v1/ai/dasha/narrative

Returns a plain-language story of the current Mahadasha and Antardasha period — what to expect, key themes, and time windows.

Parameters

NameTypeRequiredDescription
api_keystringrequiredYour VedIntelAstroAPI key
dobstringrequiredDate of birth — DD/MM/YYYY
tobstringrequiredTime of birth — HH:MM (24-hour)
latnumberrequiredLatitude with decimals (e.g. 28.6139)
lonnumberrequiredLongitude with decimals (e.g. 77.2090)
tznumberrequiredTimezone offset from UTC (e.g. 5.5 for IST)
langstringoptionalLanguage code — default: en. Options: hi, ta, te, kn, ml, gu, mr, bn, or, pa, ur, es, fr, de, it, pt, ar, ru, ja, zh
ayanamsastringoptionalAyanamsa system — lahiri (default) | raman | kp
# Phase 3 — Q3 2026
curl "https://api.vedintelastroapi.com/api/v1/ai/dasha/narrative?api_key=YOUR_KEY&dob=01/10/1990&tob=08:30&lat=28.61&lon=77.20&tz=5.5"