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

Testing Guide URL

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-4.divineapi.com/western-api/v1/transit/monthly

Response: Returns Monthly Transit in response.

Headers

Request Body

200: OK Monthly Transit fetched successfully

{
    "success": 1,
    "data": {
        "start_date": "2024-04-01",
        "end_date": "2024-04-30",
        "natal_ascendant": "Libra",
        "transit_response": [
            {
                "transit_planet": "Moon",
                "natal_planet": "Ascendant",
                "aspect": "Quincunx",
                "transit_time": "2024-04-06 02:00:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Sun",
                "aspect": "Sextile",
                "transit_time": "2024-04-16 13:42:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Mercury",
                "aspect": "Quincunx",
                "transit_time": "2024-04-22 02:54:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Venus",
                "aspect": "Sextile",
                "transit_time": "2024-04-20 08:03:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Mars",
                "aspect": "Trine",
                "transit_time": "2024-04-26 11:11:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Jupiter",
                "aspect": "Semisextile",
                "transit_time": "2024-04-11 21:25:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Saturn",
                "aspect": "Conjunction",
                "transit_time": "2024-04-19 09:19:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Uranus",
                "aspect": "Sextile",
                "transit_time": "2024-04-15 12:10:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Neptune",
                "aspect": "Trine",
                "transit_time": "2024-04-26 01:59:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "Pluto",
                "aspect": "Square",
                "transit_time": "2024-04-23 21:19:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "North node",
                "aspect": "Square",
                "transit_time": "2024-04-16 13:00:00"
            },
            {
                "transit_planet": "Moon",
                "natal_planet": "South node",
                "aspect": "Square",
                "transit_time": "2024-04-16 13:00:00"
            }
        ]
    }
}

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-4.divineapi.com/western-api/v1/transit/monthly' \
--header 'Authorization: ' \Bearer {Your Auth Token}
--form 'api_key="{Your API Key}"' \
--form 'full_name="Test"' \
--form 'day="24"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'hour="14"' \
--form 'min="40"' \
--form 'sec="43"' \
--form 'gender="male"' \
--form 'place="New Delhi"' \
--form 'lat="28.7041"' \
--form 'lon="77.1025"' \
--form 'tzone="5.5"' \
--form 'lan="en"' \
--form 'transit_planet="Moon"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-4.divineapi.com/western-api/v1/transit/monthly',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'full_name': 'Test',
    'day': '24',
    'month': '05',
    'year': '2023',
    'hour': '14',
    'min': '40',
    'sec': '43',
    'gender': 'male',
    'place': 'New Delhi',
    'lat': '28.7041',
    'lon': '77.1025',
    'tzone': '5.5',
    'lan': 'en',
    'transit_planet': 'Moon'
  }
};
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", "{Your API Key}");
form.append("full_name", "Test");
form.append("day", "24");
form.append("month", "05");
form.append("year", "2023");
form.append("hour", "14");
form.append("min", "40");
form.append("sec", "43");
form.append("gender", "male");
form.append("place", "New Delhi");
form.append("lat", "28.7041");
form.append("lon", "77.1025");
form.append("tzone", "5.5");
form.append("lan", "en");
form.append("transit_planet", "Moon");

var settings = {
  "url": "https://astroapi-4.divineapi.com/western-api/v1/transit/monthly",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {Your 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-4.divineapi.com/western-api/v1/transit/monthly"

payload = {'api_key': '{Your API Key}',
'full_name': 'Test',
'day': '24',
'month': '05',
'year': '2023',
'hour': '14',
'min': '40',
'sec': '43',
'gender': 'male',
'place': 'New Delhi',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5',
'lan': 'en',
'transit_planet': 'Moon'}

headers = {
  'Authorization': 'Bearer {Your Auth Token}'
}

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

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.