Natal Aspects

Birth chart aspects

🚧

This endpoint is coming soon. The documentation is provided for planning purposes. Until it ships, the AI query endpoint answers the same question.

POST Planned: /v2/western/natal-aspects $0.130

Overview

Birth chart aspects

Request (available today)

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"
    }
  }'

Parameters

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)

Planned response

{
  "success": true,
  "data": {
    // Endpoint-specific response data
  },
  "metadata": {
    "requestId": "req_123456",
    "timestamp": "2026-01-07T00:00:00Z",
    "cost": 0.048
  }
}

Error Handling

{
  "success": false,
  "error": {
    "code": "INVALID_DATETIME",
    "message": "Invalid datetime format. Use ISO 8601.",
    "details": { ... }
  }
}

Rate Limits

  • Free Sandbox: Mock data for testing (no auth required)
  • Starter ($12/mo): 300 credits/month
  • Pro ($60/mo): 1,500 credits/month
  • Business ($120/mo): 3,000 credits/month
  • Enterprise ($240/mo): 6,000 credits/month
  • Enterprise ($240/mo): 6,000 credits + custom limits

SDKs

JavaScript/Node.js

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);

Python

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)

Ready to Build with Vedika?

Get your API key and start building astrology features today.