Planet Retrograde Transit

Analyze planetary retrograde transits using the Western Astrology Transit API, returning retrograde movement details for a selected planet based on month, location, and timezone.

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 (if applicable).

API Endpoint

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

Returns: Planet retrograde transit details for the specified planet and month.

Headers

Request Body

200: OK Planet Retrograde Transit details fetched successfully

# With Transit Data
{
    "status": "success",
    "code": 200,
    "message": "Request successful",
    "data": {
        "transit": [
            {
                "retrograde": "false",
                "progressive": "true",
                "datetime": "2025-02-24 07:30: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/planet-retrograde-transit' \
--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/planet-retrograde-transit',
  '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/planet-retrograde-transit",
  "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/planet-retrograde-transit"

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.