Loading...
Vedic astrology API powered by Swiss Ephemeris and Gemini AI. Generate birth charts, check compatibility, and retrieve AI-powered daily horoscopes.
https://jyotish.darshj.ai/api/v1All API requests require an X-API-Key header. Contact us to obtain an enterprise API key.
X-API-Key: your_enterprise_api_key_hereRate limit headers are included in every response:X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset. Daily limits reset at midnight UTC.
/api/v1/kundliComputes a full Vedic birth chart including planetary positions, houses, nakshatras, dashas, and yogas using Swiss Ephemeris.
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Required | Full name of the person |
| year | integer | Required | Birth year (e.g., 1995) |
| month | integer | Required | Birth month (1-12) |
| day | integer | Required | Birth day (1-31) |
| hour | integer | Required | Birth hour in 24h format (0-23) |
| minute | integer | Required | Birth minute (0-59) |
| second | integer | Optional | Birth second (0-59, default 0) |
| lat | number | Required | Latitude of birth place (-90 to 90) |
| lon | number | Required | Longitude of birth place (-180 to 180) |
| timezone_str | string | Optional | IANA timezone (default: Asia/Kolkata) |
curl -X POST https://jyotish.darshj.ai/api/v1/kundli \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"name": "Arjun",
"year": 1995,
"month": 3,
"day": 15,
"hour": 10,
"minute": 30,
"second": 0,
"lat": 28.6139,
"lon": 77.209,
"timezone_str": "Asia/Kolkata"
}'/api/v1/compatibilityPerforms Vedic compatibility analysis (Ashtakoot Guna Milan) between two birth charts. Returns guna score, mangal dosha status, and nadi analysis.
Request body requires person1 and person2 objects, each with the same birth data fields as the kundli endpoint.
curl -X POST https://jyotish.darshj.ai/api/v1/compatibility \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"person1": {
"name": "Arjun", "year": 1995, "month": 3, "day": 15,
"hour": 10, "minute": 30, "lat": 28.6139, "lon": 77.209
},
"person2": {
"name": "Priya", "year": 1997, "month": 8, "day": 22,
"hour": 14, "minute": 15, "lat": 19.076, "lon": 72.8777
}
}'/api/v1/horoscope?sign=ariesReturns an AI-generated daily horoscope for a given zodiac sign, powered by real planetary transit data and Gemini AI. Results are cached for 24 hours.
| Parameter | Type | Required | Description |
|---|---|---|---|
| sign | string | Required | Zodiac sign: English name (aries), Sanskrit (mesha), or index (0-11) |
curl "https://jyotish.darshj.ai/api/v1/horoscope?sign=aries" \
-H "X-API-Key: your_api_key"/api/v1/docsReturns the full OpenAPI specification as JSON. No authentication required. Useful for auto-generating client SDKs.
curl https://jyotish.darshj.ai/api/v1/docsAll endpoints return JSON with a consistent structure.
{
"success": true,
"data": { ... },
"api_version": "v1",
"timestamp": "2026-04-10T12:00:00.000Z"
}{
"success": false,
"error": "Description of what went wrong"
}| Code | Description |
|---|---|
| 400 | Missing or invalid request parameters |
| 401 | Missing, invalid, or revoked API key |
| 429 | Rate limit exceeded (daily or burst) |
| 502 | Upstream computation service error |
| 504 | Computation timed out (30 second limit) |