Developer API
API Documentation
VSOP87 precision Vedic astrology API. Free during beta.
Base URL:
https://astro-saas-iota.vercel.appPOST
/api/chartGenerate Birth Chart
Complete Vedic birth chart with planets, houses, dashas, yogas, KP, Shadbala, AI predictions.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| year | number | * | Birth year (e.g. 1995) |
| month | number | * | Birth month (1-12) |
| day | number | * | Birth day (1-31) |
| hour | number | * | Birth hour (0-23, 24h format) |
| minute | number | * | Birth minute (0-59) |
| latitude | number | * | Birth latitude (-90 to 90) |
| longitude | number | * | Birth longitude (-180 to 180) |
| timezone | number | * | UTC offset in hours (e.g. 5.5 for IST) |
| name | string | - | Person name |
| ayanamshaSystem | string | - | lahiri (default), raman, krishnamurti |
| divisionalCharts | string[] | - | Array of D1-D60 (default: D1, D9, D10) |
| dashaLevels | number | - | 1, 2, or 3 (default: 2) |
Example
{
"year": 1995, "month": 3, "day": 15,
"hour": 10, "minute": 30,
"latitude": 28.6139, "longitude": 77.2090,
"timezone": 5.5, "name": "Test"
}Response
{ success: true, data: ChartData, ai: AIAnalysis }POST
/api/doshaDosha Detection
7-dosha analysis with BPHS cancellation rules: Manglik, Kaal Sarp, Pitra, Kemdrum, Guru Chandal, Grahan, Shani.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| year/month/day/hour/minute | number | * | Birth date/time |
| latitude/longitude/timezone | number | * | Birth location |
Example
{ "year": 1995, "month": 3, "day": 15, "hour": 10, "minute": 30, "latitude": 28.6139, "longitude": 77.2090, "timezone": 5.5 }Response
{ success: true, data: DoshaReport }POST
/api/matchKundli Matching
Ashtakoota 36-guna compatibility: Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| person1 | BirthData | * | First person birth data object |
| person2 | BirthData | * | Second person birth data object |
Example
{ "person1": { "year": 1995, ... }, "person2": { "year": 1997, ... } }Response
{ success: true, data: MatchResult, score: number, maxScore: 36 }GET
/api/rashifalDaily Rashifal
Transit-based daily horoscope for all 12 Moon signs with Panchang data.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| rashi | number | - | 0 (Aries) to 11 (Pisces). Omit for all 12. |
| date | string | - | YYYY-MM-DD (default: today) |
Example
/api/rashifal?rashi=0&date=2026-04-14
Response
{ success: true, data: RashiPrediction | DailyRashifal }GET
/api/panchangPanchang
Full Panchang (5-limb Vedic calendar) with planetary positions for 30+ Indian cities.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| city | string | - | City slug (delhi, mumbai, etc.). Default: delhi |
| date | string | - | YYYY-MM-DD (default: today) |
Example
/api/panchang?city=mumbai&date=2026-04-14
Response
{ success: true, data: { panchang, planets, moon, sun } }Rate Limits & Pricing
Free (Beta)
$0
Unlimited
Starter
$29/mo
10K req/day
Pro
$99/mo
100K req/day
Enterprise
Contact us
Unlimited