← AI Astrologer engine/AI Astrologer
GET/v1/conversations

Conversations API

List past chat conversations for the active key.

Get free API keyTry in playgroundFull schema in docs

About the engine

Part of the AI Astrologer engine

A conversational layer over the astrology engine. Every response is anchored in a deterministic chart context - not a generic chatbot - and gated by a defense-in-depth safety layer that intercepts medical, financial, and self-harm prompts. Multi-turn memory keyed on caller-owned conversation_id; tone + confidence labels; a structured `practices` array on every reply. Streaming variant available for token-by-token UI.

Request

Try it from the command line

curl -X GET 'https://api.astronode.dev/v1/conversations?limit=20' \
  -H 'Authorization: Bearer aie_test_REPLACE_WITH_YOUR_API_KEY' \
  -H 'Accept: application/json'

Every AstroNode endpoint needs a bearer token from your dashboard. Test keys (aie_test_*) work on the free tier - 1,000 requests / month, no card.

Response

What you get back

Every AstroNode response uses the same envelope: request_id, data (the endpoint-specific payload), interpretation (optional narrative block), and meta (engine version + computed_at timestamp). This endpoint documents 200, 401, 429, 500.

Fields inside data

Response data fields for GET /v1/conversations
FieldTypeNotes
conversationsrequiredobject[]-
conversations[].idrequiredstring-
conversations[].statusrequiredenum

ACTIVE | CLOSED | BLOCKED

conversations[].created_atrequiredstring-
conversations[].updated_atrequiredstring-
conversations[].message_countrequiredinteger

0..9007199254740991

conversations[].last_user_message_previewrequiredobject-
conversations[].last_message_atrequiredobject-

Engine highlights

What the AI Astrologer engine ships

  • Bounded reasoning - every reply grounded in the user's deterministic chart context
  • Multi-turn memory keyed on caller-owned `conversation_id`
  • Defense-in-depth safety layer on input + output (medical / financial / self-harm)
  • Structured `practices` array on every response (planet, kind, summary)
  • Tone (supportive | reflective | grounded | calm | neutral) and confidence (low | moderate | high) labels
  • Optional `partner` block triggers compatibility-aware reasoning
  • Strict JSON-schema response enforcement on Gemini + Groq + OpenAI providers
  • Streaming variant for token-by-token UI
  • Conversation history endpoints for resume + per-user transcripts

Related endpoints

Other AI Astrologer endpoints

POST/v1/chat/respond

Generate an emotionally intelligent, astrology-grounded response.

POST/v1/chat/respond/stream

Streaming variant - Server-Sent Events of LLM tokens.

GET/v1/conversations/:id

Fetch a single conversation's messages.

Ready to call GET /v1/conversations?

Free tier covers 1,000 requests / month. Razorpay-billed, GST-compliant invoices when you upgrade.

Get free API keyTry in playground

Informational, not predictive. Not medical, legal, or financial advice.