This endpoint is coming soon. The documentation is provided for planning purposes. Until it ships, the AI query endpoint answers the same question.
Birth chart aspects
The AI query endpoint answers this question today. The planned dedicated endpoint will return structured data.
curl -X POST "https://api.vedika.io/api/v1/astrology/query" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"question": "Which aspects are formed between the planets in my natal chart?",
"birthDetails": {
"datetime": "1990-06-15T10:30:00",
"latitude": 28.6139,
"longitude": 77.209,
"timezone": "Asia/Kolkata"
}
}'
| Parameter | Type | Required | Description |
|---|---|---|---|
datetime |
string | Yes | Birth date/time in ISO 8601 format |
latitude |
number | Yes | Birth location latitude (-90 to 90) |
longitude |
number | Yes | Birth location longitude (-180 to 180) |
{
"success": true,
"data": {
// Endpoint-specific response data
},
"metadata": {
"requestId": "req_123456",
"timestamp": "2026-01-07T00:00:00Z",
"cost": 0.048
}
}
{
"success": false,
"error": {
"code": "INVALID_DATETIME",
"message": "Invalid datetime format. Use ISO 8601.",
"details": { ... }
}
}
const { VedikaClient } = require('@vedika-io/sdk');
const client = new VedikaClient({ apiKey: 'YOUR_API_KEY' });
async function main() {
const result = await client.post('/api/v1/astrology/query', {
question: 'Which aspects are formed between the planets in my natal chart?',
birthDetails: {
datetime: '1990-06-15T10:30:00',
latitude: 28.6139,
longitude: 77.209,
timezone: 'Asia/Kolkata'
}
});
console.log(result);
}
main().catch(console.error);
from vedika import VedikaClient
client = VedikaClient(api_key="YOUR_API_KEY")
result = client.request("POST", "/api/v1/astrology/query", json={
"question": "Which aspects are formed between the planets in my natal chart?",
"birthDetails": {
"datetime": "1990-06-15T10:30:00",
"latitude": 28.6139,
"longitude": 77.209,
"timezone": "Asia/Kolkata"
}
})
print(result)
Get your API key and start building astrology features today.