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

Natal Transits Weekly

This API returns a list of transit relations between natal and transit planets for a given week, along with the start and end dates, natal ascendant, and transit details such as the transit planet, aspect type, start time, exact time, and end time.
POSThttps://json.astrologyapi.com/v1/natal_transits/weekly

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.

Body parameters

dayintrequired

Date of birth, eg: 10

monthintrequired

Month of birth, eg: 5

yearintrequired

Year of birth, eg: 1990

hourintrequired

Hour of birth, eg: 19

minintrequired

Minute of birth, eg: 55

latfloatrequired

Latitude, eg: 19.2056

lonfloatrequired

Longitude, eg: 25.2056

tzonefloatrequired

Timezone, eg: 5.5

house_typestringrequired

Default : placidus // koch/topocentric/poryphry/equal_house/whole_sign

curl --location 'https://json.astrologyapi.com/v1/natal_transits/weekly' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "day": 10,
    "month": 5,
    "year": 1990,
    "hour": 19,
    "min": 55,
    "lat": 19.2056,
    "lon": 25.2056,
    "tzone": 5.5,
    "house_type": "placidus"
}'
Try it

Runs with sample data β€” no API key needed

{
  "start_date": "1-25-2023",
  "end_date": "2-1-2023",
  "natal_ascendant": "Sagittarius",
  "transit_relation": [
    {
      "transit_planet": "Sun",
      "natal_planet": "Mercury",
      "aspect_type": "Conjunction",
      "start_time": "2023-01-23 05:57:47",
      "exact_time": "2023-01-25 05:08:14",
      "end_time": "2023-01-27 04:20:14"
    },
    {
      "transit_planet": "Moon",
      "natal_planet": "Neptune",
      "aspect_type": "Conjunction",
      "start_time": "2023-01-25 05:29:41",
      "exact_time": "2023-01-25 08:48:16",
      "end_time": "2023-01-25 12:07:46"
    },
    {
      "transit_planet": "Mercury",
      "natal_planet": "Uranus",
      "aspect_type": "Trine",
      "start_time": "2023-01-22 05:03:23",
      "exact_time": "2023-01-25 15:50:48",
      "end_time": "2023-01-28 03:10:36"
    },
    {
      "transit_planet": "Jupiter",
      "natal_planet": "Mercury",
      "aspect_type": "Sextile",
      "start_time": "2023-01-18 22:03:04",
      "exact_time": "2023-01-24 20:10:10",
      "end_time": "2023-01-30 09:36:16"
    },
    {
      "transit_planet": "Uranus",
      "natal_planet": "Sun",
      "aspect_type": "Trine",
      "start_time": "2022-11-16 13:59:51",
      "exact_time": "2022-12-13 11:45:19",
      "end_time": "2023-03-28 14:04:18"
    },
    {
      "transit_planet": "Sun",
      "natal_planet": "Mercury",
      "aspect_type": "Conjunction",
      "start_time": "2023-01-25 12:41:49",
      "exact_time": "2023-01-27 03:13:47",
      "end_time": "2023-01-28 17:47:07"
    },
    {
      "transit_planet": "Mercury",
      "natal_planet": "Uranus",
      "aspect_type": "Trine",
      "start_time": "2023-01-26 23:48:17",
      "exact_time": "2023-01-27 03:19:40",
      "end_time": "2023-01-27 06:52:09"
    },
    {
      "transit_planet": "Jupiter",
      "natal_planet": "Mercury",
      "aspect_type": "Sextile",
      "start_time": "2023-01-27 08:32:39",
      "exact_time": "2023-01-27 12:06:48",
      "end_time": "2023-01-27 15:42:03"
    },
    {
      "transit_planet": "Venus",
      "natal_planet": "Moon",
      "aspect_type": "Conjunction",
      "start_time": "2023-01-26 23:11:37",
      "exact_time": "2023-01-28 13:44:48",
      "end_time": "2023-01-30 04:19:26"
    },
    {
      "transit_planet": "Uranus",
      "natal_planet": "Sun",
      "aspect_type": "Trine",
      "start_time": "2023-01-28 10:11:41",
      "exact_time": "2023-01-28 13:53:38",
      "end_time": "2023-01-28 17:36:39"
    },
    {
      "transit_planet": "Moon",
      "natal_planet": "Sun",
      "aspect_type": "Square",
      "start_time": "2023-01-29 07:40:55",
      "exact_time": "2023-01-31 06:56:31",
      "end_time": "2023-02-02 06:13:57"
    },
    {
      "transit_planet": "Moon",
      "natal_planet": "Venus",
      "aspect_type": "Square",
      "start_time": "2023-01-29 06:34:48",
      "exact_time": "2023-01-29 10:22:20",
      "end_time": "2023-01-29 14:10:49"
    },
    {
      "transit_planet": "Mercury",
      "natal_planet": "Uranus",
      "aspect_type": "Trine",
      "start_time": "2023-01-28 22:30:21",
      "exact_time": "2023-01-30 23:17:52",
      "end_time": "2023-02-01 20:06:20"
    },
    {
      "transit_planet": "Jupiter",
      "natal_planet": "Mercury",
      "aspect_type": "Sextile",
      "start_time": "2023-01-30 09:41:39",
      "exact_time": "2023-01-30 13:35:19",
      "end_time": "2023-01-30 17:29:43"
    },
    {
      "transit_planet": "Venus",
      "natal_planet": "Moon",
      "aspect_type": "Conjunction",
      "start_time": "2023-01-30 20:37:12",
      "exact_time": "2023-02-01 19:54:13",
      "end_time": "2023-02-03 19:13:06"
    },
    {
      "transit_planet": "Venus",
      "natal_planet": "Jupiter",
      "aspect_type": "Conjunction",
      "start_time": "2023-01-31 10:37:24",
      "exact_time": "2023-01-31 14:35:14",
      "end_time": "2023-01-31 18:33:36"
    }
  ]
}