Astro Chat API

Compatibility Astro Chat

Start a compatibility-focused conversation between two people. This endpoint analyzes the synergy between two birth charts for marriage, relationship, or partnership insights.

POSThttps://json-chat.astrologyapi.com/api/chat

Compatibility Astro 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:

Parameter	Type	Description
languagerequired	string	Language code (e.g., "en")
f_first_namerequired	string	Female first name
f_last_namerequired	string	Female last name
f_dayrequired	number	Female birth day
f_monthrequired	number	Female birth month
f_yearrequired	number	Female birth year
f_hourrequired	number	Female birth hour
f_minuterequired	number	Female birth minute
f_latituderequired	number	Female birth latitude
f_longituderequired	number	Female birth longitude
f_timezonerequired	number	Female birth timezone
f_placerequired	string	Female birth place
m_first_namerequired	string	Male first name
m_last_namerequired	string	Male last name
m_dayrequired	number	Male birth day
m_monthrequired	number	Male birth month
m_yearrequired	number	Male birth year
m_hourrequired	number	Male birth hour
m_minuterequired	number	Male birth minute
m_latituderequired	number	Male birth latitude
m_longituderequired	number	Male birth longitude
m_timezonerequired	number	Male birth timezone
m_placerequired	string	Male birth place
aprequired	string	Astro Profile. Set to "MATCHING" for compatibility chat.
eprequired	string	Expertise level. Options: "STANDARD", "ADVANCED", "EXPERT".
sidrequired	string	Unique identifier for the current chat session. Use the same session ID to continue an existing conversation.
qrequired	string	The compatibility question (e.g., "how is the compatibility for marriage?").

API Details

Request

Example request body:

{
  "language": "en",
  "f_first_name": "Sakshi",
  "f_last_name": "",
  "f_day": 22,
  "f_month": 6,
  "f_year": 2001,
  "f_hour": 17,
  "f_minute": 22,
  "f_latitude": 19.14,
  "f_longitude": 72.52,
  "f_timezone": 5.5,
  "f_place": "Mumbai, INIDIA",
  "m_first_name": "Hema",
  "m_last_name": "",
  "m_day": 22,
  "m_month": 7,
  "m_year": 1989,
  "m_hour": 10,
  "m_minute": 10,
  "m_latitude": 25.7464,
  "m_longitude": 82.6837,
  "m_timezone": 5.5,
  "m_place": "Jaunpur, Uttar Pradesh",
  "ap": "MATCHING",
  "ep": "STANDARD",
  "sid": "astro-1",
  "q": "how is the compatibility for marriage?"
}

Code samples

curl --location 'https://json-chat.astrologyapi.com/api/chat' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "language": "en",
    "f_first_name": "Sakshi",
    "f_last_name": "",
    "f_day": 22,
    "f_month": 6,
    "f_year": 2001,
    "f_hour": 17,
    "f_minute": 22,
    "f_latitude": 19.14,
    "f_longitude": 72.52,
    "f_timezone": 5.5,
    "f_place": "Mumbai, INIDIA",
    "m_first_name": "Hema",
    "m_last_name": "",
    "m_day": 22,
    "m_month": 7,
    "m_year": 1989,
    "m_hour": 10,
    "m_minute": 10,
    "m_latitude": 25.7464,
    "m_longitude": 82.6837,
    "m_timezone": 5.5,
    "m_place": "Jaunpur, Uttar Pradesh",
    "ap": "MATCHING",
    "ep": "STANDARD",
    "sid": "astro-1",
    "q": "how is the compatibility for marriage?"
}'

Response

Example response:

{
  "status": true,
  "message": "The compatibility between Sakshi and Hema shows strong emotional syncing (Guna Milan: 28/36). Both partners share complementary moon signs...",
  "response": {
    "sid": "astro-1",
    "timestamp": "2026-01-28T12:05:00Z"
  }
}