Planetary Ingress

Planetary Ingress (Planet Sign Transit) highlights planetary transitions from one zodiac sign to another, signaling key shifts in cosmic themes. Use this API to understand how each ingress impacts life events and emotional patterns.

Allowed Transit Planets

Use Translator for Other Languages

Support Article URL: https://support.divineapi.com/general-api-support/translating-a-natal-apis-into-a-different-language

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

API Endpoint

POST https://astroapi-8.divineapi.com/western-api/v1/planetary-ingress

Returns: Planetary Ingress details for the specified month and planet.

Headers

Request Body

200: OK Planetary Ingress details fetched successfully

# With Transit Data  
{
    "status": "success",
    "code": 200,
    "message": "Request successful",
    "data": {
        "transit": [
            {
                "sign": "Aries",
                "sign_no": 1,
                "entered_on": "2025-11-02 21:10:00"
            },
            {
                "sign": "Taurus",
                "sign_no": 2,
                "entered_on": "2025-11-04 21:46:00"
            },
            {
                "sign": "Gemini",
                "sign_no": 3,
                "entered_on": "2025-11-06 20:51:00"
            },
            {
                "sign": "Cancer",
                "sign_no": 4,
                "entered_on": "2025-11-08 20:37:00"
            },
            {
                "sign": "Leo",
                "sign_no": 5,
                "entered_on": "2025-11-10 23:04:00"
            },
            {
                "sign": "Virgo",
                "sign_no": 6,
                "entered_on": "2025-11-13 05:22:00"
            },
            {
                "sign": "Libra",
                "sign_no": 7,
                "entered_on": "2025-11-15 15:14:00"
            },
            {
                "sign": "Scorpio",
                "sign_no": 8,
                "entered_on": "2025-11-18 03:15:00"
            },
            {
                "sign": "Sagittarius",
                "sign_no": 9,
                "entered_on": "2025-11-20 15:56:00"
            },
            {
                "sign": "Capricorn",
                "sign_no": 10,
                "entered_on": "2025-11-23 04:23:00"
            },
            {
                "sign": "Aquarius",
                "sign_no": 11,
                "entered_on": "2025-11-25 15:46:00"
            },
            {
                "sign": "Pisces",
                "sign_no": 12,
                "entered_on": "2025-11-28 00:54:00"
            },
            {
                "sign": "Aries",
                "sign_no": 1,
                "entered_on": "2025-11-30 06:38:00"
            }
        ]
    }
}
# Without Transit Data
{
    "status": "success",
    "code": 200,
    "message": "Request successful",
    "data": {
        "transit": []
    }
}

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-8.divineapi.com/western-api/v1/planetary-ingress' \
--header 'Authorization: Bearer your API Access Token' \
--form 'api_key="your API Key"' \
--form 'planet="moon"' \
--form 'month="11"' \
--form 'year="2025"' \
--form 'place="New Delhi, India"' \
--form 'lat="28.7041"' \
--form 'lon="77.1025"' \
--form 'tzone="5.5"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-8.divineapi.com/western-api/v1/planetary-ingress',
  'headers': {
    'Authorization': 'Bearer your API Access Token'
  },
  formData: {
    'api_key': 'your API Key',
    'planet': 'moon',
    'month': '11',
    'year': '2025',
    'place': 'New Delhi, India',
    'lat': '28.7041',
    'lon': '77.1025',
    'tzone': '5.5'
  }
};
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("planet", "moon");
form.append("month", "11");
form.append("year", "2025");
form.append("place", "New Delhi, India");
form.append("lat", "28.7041");
form.append("lon", "77.1025");
form.append("tzone", "5.5");

var settings = {
  "url": "https://astroapi-8.divineapi.com/western-api/v1/planetary-ingress",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer your API Access 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/planetary-ingress"

payload = {'api_key': 'your API Key',
'planet': 'moon',
'month': '11',
'year': '2025',
'place': 'New Delhi, India',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5'}
files=[

]
headers = {
  'Authorization': 'Bearer your API Access Token'
}

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

print(response.text)

Implementation Notes

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.