AstrologyAPI
Sign in

Use access token to call astrology api.

Learn More

Personalized Astro Chat

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

Start a personalized conversation with an astrological assistant based on a single birth chart. This endpoint supports both Vedic and Western traditions with various expertise levels.

POST/api/chat
Copy
1curl --location 'https://json-chat.astrologyapi.com/api/chat' \
2  --header 'Content-Type: application/json' \
3  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
4  --data '{
5    "language": "en",
6    "name": "David",
7    "day": 1,
8    "month": 11,
9    "year": 2005,
10    "hour": 19,
11    "min": 45,
12    "place": "Mumbai",
13    "lat": "19.17",
14    "lon": "73.7",
15    "tzone": "5.5",
16    "gender": "male",
17    "country": "INDIA",
18    "ap": "KUNDLI",
19    "sid": "astro-6",
20    "ep": "STANDARD",
21    "ac": "VEDIC",
22    "q": "hi"
23}'
24
200Response
Copy
1{
2  "status": true,
3  "message": "Based on your birth details, your Sun is in Scorpio and Moon is in Libra. This indicates a deep, intuitive nature with a strong focus on balance and harmony...",
4  "response": {
5    "sid": "astro-6",
6    "timestamp": "2026-01-28T12:00:00Z"
7  }
8}

Request Headers

x-astrologyapi-key

string

required

API Access Token to authenticate requests. Send your access token in this custom header.

Accept-Language

string

Preferred language for the response content

Request Body (JSON)

language

string

required

Language code (e.g., "en")

name

string

required

Name of the person

day

number

required

Birth day

month

number

required

Birth month

year

number

required

Birth year

hour

number

required

Birth hour (24-hour format)

min

number

required

Birth minute

place

string

required

Birth city

lat

string

required

Latitude of birth place

lon

string

required

Longitude of birth place

tzone

string

required

Timezone offset (e.g., "5.5")

gender

string

required

Gender ("male" or "female")

Properties

malefemale
country

string

required

Country of birth

ap

string

required

Astro Profile. Options: "KUNDLI". For personalized chat, use "KUNDLI".

Properties

KUNDLI
sid

string

required

Assistant/Session ID. Use "astro-6" for standard personalized assistant.

ep

string

required

Expertise level. Options: "STANDARD", "ADVANCED", "EXPERT".

Properties

STANDARDADVANCEDEXPERT
ac

string

required

Astrological category. Options: "VEDIC", "WESTERN".

Properties

VEDICWESTERN
q

string

required

The astrological question or query.

Errors

400
Bad Request

Something is wrong with your request format or parameters.

401
Unauthorized

Your API key is missing or invalid.

403
Forbidden

You don't have permission to access this specific resource.

404
Not Found

The API endpoint you're trying to reach doesn't exist.

500
Internal Server Error

Our server is having a temporary glitch.