POSThttps://api.occultapi.com/api/astro/chat/

Astrology chat

Request bodyJSON

Paste an API key above to send.

Code snippet

curl -X POST https://api.occultapi.com/api/astro/chat/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"Which planet rules my ascendant, and what does it say about my career?","birth":{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"place":"Jaipur, India","name":"Asha","gender":"female"}}'

Ask a question about a birth chart and get an answer in plain language, grounded in the classical texts. Every answer comes back with the passages it drew on — each with its source and a relevance score — so the reasoning can be checked rather than taken on trust. Pass a second person in `compare_with` for compatibility questions. This endpoint is STATELESS. Nothing is stored between calls, and no account is involved: the birth details come from your request, so you can ask on behalf of any of your own users. To continue a conversation, keep the transcript in your application and pass it back in `history` — up to twenty earlier turns. It costs 25 credits per call rather than the usual 1, because each answer runs a language model over the computed chart. A failed or empty answer costs nothing, as with every other endpoint here.

Request fields

Field	Type	Required	Notes
birth	object	required	Whose chart the question is about.
question	string	required	What to ask about the chart.
compare_with	object	optional	A second person, for compatibility questions. Optional.
history	array	optional	Earlier turns, oldest first, at most 20. This endpoint stores nothing between calls, so pass back whatever context the answer should take account of.

Full reference for this endpoint