Complete endpoint documentation for Vedika API
Choose the server closest to your location for optimal latency:
https://api.vedika.io
https://api.vedika.io
All API requests require authentication via API key in the header:
X-API-Key: vk_live_your_api_key_here
Get your API key from the Dashboard
Generate complete Vedic birth chart with planetary positions, houses, and yogas
POST /api/v1/chart
{
"birthDetails": {
"date": "1990-01-15",
"time": "14:30",
"timezone": "Asia/Kolkata",
"location": {
"city": "Mumbai",
"country": "India",
"latitude": 19.0760,
"longitude": 72.8777
}
},
"options": {
"divisionalCharts": ["D1", "D9", "D10"],
"yogaDetection": true,
"doshaAnalysis": true
}
}
{
"success": true,
"data": {
"planets": [...],
"houses": [...],
"yogas": ["Gaja Kesari Yoga", "Budhaditya Yoga"],
"doshas": {
"manglik": false,
"kaal_sarp": false
},
"divisionalCharts": {...}
},
"credits_used": 2
}
Ask any astrology question and get AI-powered analysis with 97.2% accuracy
POST /api/v1/astrology/query
{
"question": "What is my career prospects in 2025?",
"birthDetails": {
"date": "1990-01-15",
"time": "14:30",
"location": "Mumbai, India"
}
}
{
"success": true,
"data": {
"prediction": "Based on your chart analysis...",
"confidence": 0.972,
"agents_consensus": "6/6 agree",
"followUpSuggestions": [...]
},
"credits_used": 1
}
Calculate Ashtakoota matching score and detailed compatibility report
POST /api/v1/compatibility
{
"person1": {
"date": "1990-01-15",
"time": "14:30",
"location": "Mumbai, India"
},
"person2": {
"date": "1992-05-20",
"time": "09:15",
"location": "Delhi, India"
}
}
{
"success": true,
"data": {
"totalScore": 28,
"maxScore": 36,
"percentage": 77.8,
"kootaBreakdown": {...},
"manglikAnalysis": {...},
"recommendation": "Highly compatible"
},
"credits_used": 2
}
Verify API availability and server status
GET /api/v1/health
{
"status": "healthy",
"uptime": 1234567,
"version": "1.0.0"
}
Get API version and capabilities information
GET /api/v1/info
{
"name": "Vedika API",
"version": "1.0.0",
"features": ["birth-chart", "ai-query", "compatibility"],
"models": ["Vedika Pro 1.0", "Vedika Standard 2.1", "Vedika Lite 0.9", "Vedika Express 1.5"]
}
| Code | Message | Description |
|---|---|---|
| 400 | Bad Request | Invalid request parameters |
| 401 | Unauthorized | Invalid or missing API key |
| 402 | Payment Required | Insufficient credits |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Internal Server Error | Server error (we'll fix it!) |
requests per month
requests per month
Custom SLA