Monthly Transit

Explore our Transit API's Monthly Transit feature, delivering monthly analyses of planetary movements against natal charts, identifying major astrological patterns and their potential monthly impacts.

Allowed Transit Planets

Use one of the following values in transit_planet.

Step by Step Monthly Transit API Postman Testing Integration

https://support.divineapi.com/western-astrology-apis/testing-western-api-monthly-transit-api-using-postman

Supported Language Codes

Support Article URL: Translating a Natal API into a Different Language

Guide: These languages are supported by this API. You can use them by passing "lan" in the body with the corresponding value.

House System Codes

Support Article URL: How to Change the House System Code in Natal Astrology

Note: The default house system used is P – Placidus.

API Endpoint

POST https://astroapi-8.divineapi.com/western-api/v1/transit/monthly 

Response: Returns Monthly Transit in response.

Headers

Request Body

Aspects Selection (aspects_type)

You can control which astrological aspects are included by using the aspects_type parameter.
It can take one of four kinds of values only:

ALL

All supported aspects (major + minor) are calculated and returned.

MAJOR_ASPECTS

Only major aspects are calculated and returned:
Conjunction, Sextile, Square, Trine, Opposition.

MINOR_ASPECTS

Only minor aspects are calculated and returned:
Semisextile, Semisquare, Sesquiquadrate, Quincunx, Quintile, Biquintile, Novile, Septile.

Custom Aspect List (comma-separated)

You may pass one or more individual aspect names, separated by commas.

Only the selected aspects will be calculated and returned.

Allowed values in the custom list:

Examples:

Single aspect:
aspects_type = "CONJUNCTION"

Multiple aspects:
aspects_type = "SEXTILE,TRINE,QUINTILE"
aspects_type = "SEMISQUARE,SEMISEXTILE,QUINCUNX"

Whatever you select in the custom list must be one or more of the allowed aspect tokens above, separated by commas. Only those aspects will be shown in the response.

Aspect Orb Settings 

The aspect_orbs_type parameter defines how the orb values are interpreted. It supports two modes:

1. FIXED

When aspect_orbs_type = FIXED, the orb range (0°30' to 15°00') is applied based on the degree group:

1. 0°30' to 3°00':  Applies to All Aspects

2. 3°30' to 4°00': Applies to Major Aspects Only

3. 4°30' to 15°00': Applies to Major Aspects Except Sextile

Example values:
0_30, 1_00, 5_00, 12_00, 15_00
(Use underscore to represent degrees_minutes format)

2. PERCENTAGE

When using PERCENTAGE, the aspect_orbs_value represents a percentage adjustment applied to the default orb.

Allowed percentage range: -90% - +100%

Example values:
-20%, -10%, 0%, +20%, +50%, +100%

3. BOTH

You may also support both modes, allowing the user to choose either FIXED or PERCENTAGE based on their preference.

200: OK Monthly Transit fetched successfully

{
    "status": "success",
    "code": 200,
    "message": "Request successful",
    "data": {
        "transit": [
            {
                "natal_planet": "Sun",
                "transit_planet": "Moon",
                "aspect": "Sextile",
                "start_time": "2025-10-17 06:26:00",
                "peak_time": "2025-10-18 00:00:00",
                "end_time": "2025-10-18 20:59:00"
            },
            {
                "natal_planet": "Sun",
                "transit_planet": "Moon",
                "aspect": "Quintile",
                "start_time": "2025-09-30 21:58:00",
                "peak_time": "2025-10-01 17:04:00",
                "end_time": "2025-10-02 11:46:00"
            },
            {
                "natal_planet": "Sun",
                "transit_planet": "Moon",
                "aspect": "Square",
                "start_time": "2025-10-14 22:46:00",
                "peak_time": "2025-10-15 00:00:00",
                "end_time": "2025-10-16 11:32:00"
            },
            {
                "natal_planet": "Sun",
                "transit_planet": "Moon",
                "aspect": "Trine",
                "start_time": "2025-10-04 13:53:00",
                "peak_time": "2025-10-05 06:59:00",
                "end_time": "2025-10-05 23:43:00"
            },
            {
                "natal_planet": "Sun",
                "transit_planet": "Moon",
                "aspect": "Sesquiquadrate",
                "start_time": "2025-10-05 15:24:00",
                "peak_time": "2025-10-06 08:00:00",
                "end_time": "2025-10-07 00:19:00"
            },     
                 ........
        ]
    }
}

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-8.divineapi.com/western-api/v1/transit/monthly' \
--header 'Authorization: Bearer divine auth token' \
--form 'api_key="Enter your divine api key"' \
--form 'full_name="Robin Kamboj"' \
--form 'day="6"' \
--form 'month="11"' \
--form 'year="2025"' \
--form 'hour="0"' \
--form 'min="0"' \
--form 'sec="0"' \
--form 'gender="female"' \
--form 'place="Bareilly"' \
--form 'lat="28.644800"' \
--form 'lon="77.216721"' \
--form 'tzone="5.5"' \
--form 'transit_month="10"' \
--form 'transit_year="2025"' \
--form 'transit_lat="25.321684"' \
--form 'transit_lon="82.987289"' \
--form 'transit_tzone="5.5"' \
--form 'transit_place="New Delhi"' \
--form 'transit_planet="moon"' \
--form 'aspects_type="ALL"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-8.divineapi.com/western-api/v1/transit/monthly',
  'headers': {
    'Authorization': 'Bearer divine auth token'
  },
  formData: {
    'api_key': 'Enter your divine api key',
    'full_name': 'Robin Kamboj',
    'day': '6',
    'month': '11',
    'year': '2025',
    'hour': '0',
    'min': '0',
    'sec': '0',
    'gender': 'female',
    'place': 'Bareilly',
    'lat': '28.644800',
    'lon': '77.216721',
    'tzone': '5.5',
    'transit_month': '10',
    'transit_year': '2025',
    'transit_lat': '25.321684',
    'transit_lon': '82.987289',
    'transit_tzone': '5.5',
    'transit_place': 'New Delhi',
    'transit_planet': 'moon',
    'aspects_type': 'ALL'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

JavaScript jQuery AJAX

var form = new FormData();
form.append("api_key", "Enter your divine api key");
form.append("full_name", "Robin Kamboj");
form.append("day", "6");
form.append("month", "11");
form.append("year", "2025");
form.append("hour", "0");
form.append("min", "0");
form.append("sec", "0");
form.append("gender", "female");
form.append("place", "Bareilly");
form.append("lat", "28.644800");
form.append("lon", "77.216721");
form.append("tzone", "5.5");
form.append("transit_month", "10");
form.append("transit_year", "2025");
form.append("transit_lat", "25.321684");
form.append("transit_lon", "82.987289");
form.append("transit_tzone", "5.5");
form.append("transit_place", "New Delhi");
form.append("transit_planet", "moon");
form.append("aspects_type", "ALL");

var settings = {
  "url": "https://astroapi-8.divineapi.com/western-api/v1/transit/monthly",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer divine auth token"
  },
  "processData": false,
  "mimeType": "multipart/form-data",
  "contentType": false,
  "data": form
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Python

import requests

url = "https://astroapi-8.divineapi.com/western-api/v1/transit/monthly"

payload = {'api_key': 'Enter your divine api key',
'full_name': 'Robin Kamboj',
'day': '6',
'month': '11',
'year': '2025',
'hour': '0',
'min': '0',
'sec': '0',
'gender': 'female',
'place': 'Bareilly',
'lat': '28.644800',
'lon': '77.216721',
'tzone': '5.5',
'transit_month': '10',
'transit_year': '2025',
'transit_lat': '25.321684',
'transit_lon': '82.987289',
'transit_tzone': '5.5',
'transit_place': 'New Delhi',
'transit_planet': 'moon',
'aspects_type': 'ALL'}
files=[

]
headers = {
  'Authorization': 'Bearer divine auth token'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

Use Authorization: Bearer {Your Auth Token} and {Your API Key} securely; never expose them in client-side code.

Provide date, time, and coordinates in correct numeric formats; use decimal timezone values (e.g., 5.5).

Check HTTP status codes, log responses, and handle 4xx/5xx errors gracefully.

Defaults are lan=en and house_system=P; test via Postman first and always use HTTPS for secure communication.