✋ Palmistry API and 🎧 Audio Reports API are now live. Ship them in your app today.
Astro Chat API

Marriage Chat

A Vedic specialist for Marriage. Covers: Marriage timing, spouse nature, Manglik, Ashtakoot match. Set ap to "MARRIAGE" for focused answers with chart evidence and a date window.
POSThttps://json-chat.astrologyapi.com/api/chat

Marriage Chat Overview

Send a POST request to https://json-chat.astrologyapi.com/api/chat. Authenticate with your API access token. The request body accepts the following parameters:

Persona rules

  • Vedic only. Send ac: "VEDIC" or leave ac out. WESTERN returns 400 for specialist personas.
  • Partner chart. pd.partner is used by LOVE and MARRIAGE only.
  • One persona per session. Keep the same ap for a sid. Start a new session to switch personas. Off-topic questions get a redirect to the right persona.
  • Gender is strongly recommended. Include gender in pd. It changes marriage and matching readings.
ParameterTypeDescription
qrequiredstringThe astrological question or query.
aprequiredstringSet to "MARRIAGE". Keep this value for every message in the same sid.
pdrequiredobjectBirth profile with name, language, birth date, time, coordinates, timezone and place. gender is strongly recommended, especially for marriage and matching. pd.partner is used by LOVE and MARRIAGE only.
acstringUse "VEDIC" or omit. "WESTERN" returns 400 for specialist personas.
sidstringUnique identifier for the current chat session. Use the same session ID and ap to continue an existing conversation. Start a new session to switch personas.

API Details

Request

Example request body:

{
  "q": "What does my chart suggest about marriage timing and spouse nature?",
  "ap": "MARRIAGE",
  "pd": {
    "name": "Sita Devi",
    "gender": "female",
    "language": "en",
    "day": 15,
    "month": 8,
    "year": 1990,
    "hour": 10,
    "min": 30,
    "lat": 28.6139,
    "lon": 77.209,
    "tzone": 5.5,
    "place": "New Delhi"
  },
  "ac": "VEDIC",
  "sid": ""
}

Code samples

curl --location 'https://json-chat.astrologyapi.com/api/chat' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "q": "What does my chart suggest about marriage timing and spouse nature?",
    "ap": "MARRIAGE",
    "pd": {
        "name": "Sita Devi",
        "gender": "female",
        "language": "en",
        "day": 15,
        "month": 8,
        "year": 1990,
        "hour": 10,
        "min": 30,
        "lat": 28.6139,
        "lon": 77.209,
        "tzone": 5.5,
        "place": "New Delhi"
    },
    "ac": "VEDIC",
    "sid": ""
}'

Response

Illustrative response shape (answer varies by chart):

{
  "success": true,
  "response": "[Marriage answer with chart evidence and a date window]",
  "session_id": "5ec38d54-6f24-4efc-b8ba-30b36cdd6591",
  "message_id": 1,
  "query": "What does my chart suggest about marriage timing and spouse nature?"
}

Related guides

The Chat API authenticates with a wallet access token — see Access tokens vs. User ID and API key for how tokens work and Pay as you go with a wallet for funding one. To build your own conversational layer on raw chart data instead, read Ground an LLM on computed charts.