The AI Guru is a conversational assistant that answers Vedic astrology questions. When a profileId is provided, it has full access to the person's birth chart — making answers specific to their chart rather than generic.

Authenticated chat

POST /v1/guru

Cost: 20 credits per call

Request body

Field	Type	Required	Description
messages	array	Yes	Conversation history (1–30 messages)
profileId	string	No	Profile for personalized context
locale	string	No	en · hi · ne (default: en)

Each message in messages:

{ "role": "user" | "assistant", "content": "..." }

Example

curl -X POST https://api.askvedicguru.com/api/v1/guru \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "profileId": "683abc123def456",
    "messages": [
      { "role": "user", "content": "What does my Jupiter in the 7th house mean for marriage?" }
    ]
  }'

Response

{
  "success": true,
  "data": {
    "message": "With Jupiter transiting your 7th house from Moon (Scorpio), this is an auspicious period for partnerships and marriage. Jupiter's expansive energy here brings opportunities for meaningful long-term commitments...",
    "role": "assistant"
  }
}

---

Public chat (no auth)

POST /v1/guru-public

IP-limited to 5 messages per day. No API key required. Useful for demos or unauthenticated user flows.

Request body

Field	Type	Required	Description
messages	array	Yes	Conversation history (1–30 messages)
birthDetails	object	No	Inline birth details for chart context
conversationHistory	string	No	Compressed prior context (max 16,000 chars)
locale	string	No	en · hi · ne

Inline birth details

{
  "birthDetails": {
    "date": "1990-06-15",
    "time": "06:30",
    "latitude": 27.7172,
    "longitude": 85.3240,
    "timezone": "Asia/Kathmandu"
  }
}