šŸŒ Astrocartography API, šŸ”· Human Design API and āœ‹ Palmistry API are now live. Ship them in your app today.

Planetary Line Report

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.
POSThttps://json.astrologyapi.com/v1/acg/planetary-line/:category/:planet

Authentication

x-astrologyapi-keystringrequired

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

Accept-Languagestring

Preferred language for the response content. Supported: English - en.

Path parameters

categorystringrequired

The angle/line type to compute.

  • MC
  • IC
  • AC
  • DC
planetstringrequired

The celestial body whose line to compute.

  • SUN
  • MOON
  • MERCURY
  • VENUS
  • MARS
  • JUPITER
  • SATURN
  • URANUS
  • NEPTUNE
  • PLUTO
  • NORTH_NODE

Body parameters

daynumberrequired

Day of birth (1-31).

monthnumberrequired

Month of birth (1-12).

yearnumberrequired

Year of birth.

hournumberrequired

Hour of birth (0-23).

minnumberrequired

Minute of birth (0-59).

secondnumber

Second of birth (0-59).

tzonenumberrequired

Timezone offset from UTC in hours.

latnumberrequired

Latitude of birth place.

lonnumberrequired

Longitude of birth place.

include_paransboolean

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

curl --location 'https://json.astrologyapi.com/v1/acg/planetary-line/IC/SUN' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "day": 22,
    "month": 8,
    "year": 1999,
    "hour": 18,
    "min": 50,
    "second": 0,
    "tzone": 5.5,
    "lat": 19.0759837,
    "lon": 72.8776559,
    "include_parans": "false"
}'
Try it

Runs with sample data — no API key needed

{
  "line": {
    "kind": "meridian",
    "line_type": "MC",
    "longitude_deg": 107.259319,
    "object": "Moon",
    "zenith_latitude_deg": -20.166033
  }
}