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:
Authorization: Bearer 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
{
"dateOfBirth": "1990-01-15",
"timeOfBirth": "14:30",
"placeOfBirth": "Mumbai, India",
"chartType": "D1"
}
{
"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 82% better accuracy than generic AI
POST /api/v1/astrology/query
{
"question": "What are my career prospects in 2026?",
"birthDetails": {
"datetime": "1990-01-15T14:30:00",
"latitude": 19.0760,
"longitude": 72.8777,
"timezone": "+05:30"
},
"responseFormat": "json"
}
| Parameter | Type | Required | Description |
|---|---|---|---|
question |
string | Yes | Natural language astrology question |
birthDetails |
object | Yes | Birth date/time and location (datetime, latitude, longitude, timezone) |
responseFormat |
string enum | No | "markdown" (default), "text", or "json". Use "json" to also receive a structuredResponse object with parsed sections |
language |
string | No | ISO 639-1 language code (default: "en"). Supports 30+ languages |
system |
string | No | "vedic" (default), "western", or "kp" |
conversationId |
string | No | For multi-turn conversations, pass the conversation ID from a previous response |
{
"success": true,
"response": "Based on your current Mahadasha...",
"followUpSuggestions": [
"Tell me about my next Antardasha",
"What are my lucky colors this year?"
],
"metadata": {
"model": "Vedika AI",
"processing_time_ms": 2340,
"cost": {"amount": 0.035, "currency": "USD"}
},
"birthChart": {...},
"conversationId": "conv_abc123def456"
}
structuredResponse (only when request used responseFormat=json)Machine-readable breakdown of the markdown answer. Use this for rendering sections individually without markdown parsing:
{
"title": "Career Path in 2026",
"preamble": "Namaste.",
"sections": [
{
"heading": "Current Trends",
"level": 2,
"paragraphs": ["Your Jupiter placement indicates..."],
"bullets": ["Career growth expected", "New opportunities in Q3"],
"numbered": []
}
],
"raw": "## Current Trends\n\nYour Jupiter placement..."
}
Calculate Ashtakoota matching score and detailed compatibility report
POST /api/v1/compatibility
{
"person1": {
"dateOfBirth": "1990-01-15",
"timeOfBirth": "14:30",
"placeOfBirth": "Mumbai, India"
},
"person2": {
"dateOfBirth": "1992-05-20",
"timeOfBirth": "09:15",
"placeOfBirth": "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