🌍 Astrocartography API and ✋ Palmistry API are now live. Ship them in your app today.Get Started

Planetary Line Report

POSThttps://json.astrologyapi.com/v1/acg/planetary-line/:category/:planet
Copy

Returns the geometry of one single planet-and-angle astrocartography line. Computes just one line: a specific planet on a specific angle (its Midheaven, IC, Ascendant, or Descendant line). For MC/IC the line is a meridian with a single longitude_deg. For AC/DC it comes back as a curve with a points array of {latitude_deg, longitude_deg} samples tracing the rising/setting line.

POST/acg/planetary-line/:category/:planet
Copy
1curl --location 'https://json.astrologyapi.com/v1/acg/planetary-line/:category/:planet' \
2  --header 'Content-Type: application/json' \
3  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
4  --data '{
5    "day": 22,
6    "month": 8,
7    "year": 1999,
8    "hour": 18,
9    "min": 50,
10    "second": 0,
11    "tzone": 5.5,
12    "lat": 19.0759837,
13    "lon": 72.8776559,
14    "include_parans": "false"
15}'
16
200Response
Copy
1{
2  "line": {
3    "kind": "meridian",
4    "line_type": "MC",
5    "longitude_deg": 107.259319,
6    "object": "Moon",
7    "zenith_latitude_deg": -20.166033
8  }
9}

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

Properties

English - en

Request Body (JSON)

day

number

required

Day of birth (1-31).

month

number

required

Month of birth (1-12).

year

number

required

Year of birth.

hour

number

required

Hour of birth (0-23).

min

number

required

Minute of birth (0-59).

second

number

Second of birth (0-59).

tzone

number

required

Timezone offset from UTC in hours.

lat

number

required

Latitude of birth place.

lon

number

required

Longitude of birth place.

include_parans

boolean

Set to true to also return paran latitude-crossing lines. Default: false.

Path Parameters

category

string

required

The angle/line type to compute.

Properties

MCICACDC
planet

string

required

The celestial body whose line to compute.

Properties

SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTONORTH_NODE

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.