Planet Returns List

The Planet Returns List API provides the return dates of all planets, helping identify when each planet revisits its original position in an individual's birth chart.

Supported Language Codes:

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

en For English

hi For Hindi

pt For Portuguese

fr For French

de For German

ja For Japanese

tr For turkish

ru For Russian

it For Italian

es For Spanish

nl For Dutch

pl For Polish

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

House system codes:

House System Codes Support Article URL - https://support.divineapi.com/western-astrology-apis/how-to-change-the-house-system-code-in-natal-astrology

P: Placidus

K: Koch

R: Regiomontanus

C: Campanus

A: equal

W: equal, whole sign

N: Whole sign, Aries = 1st house

X: axial rotation system/ Meridian houses

T: Polich/Page ("topocentric")

M: Morinus

O: Porphyry

B: Alcabitius

D: equal / MC

E: equal = A

F: Carter poli-equatorial

G: 36 Gauquelin sectors

H: horizon / azimuth

I: Sunshine

i: Sunshine alternative

L: Pullen

S-delta

Q: Pullen

S-ratio

S: Sripati

U: Krusinski-Pisa-Goelzer

V: equal Vehlow

Y: APC houses

Note: The default house system used is P - Placidus

Allowed Planets:

SUN MOON MERCURY VENUS MARS JUPITER SATURN URANUS NEPTUNE

POST https://astroapi-8.divineapi.com/western-api/v1/planet-returns-list

Returns Planet Returns List in response

Headers

Name

Type

Description

Authorization*

String

your API Access Token

eg: Bearer {token}

Request Body

Name

Type

Description

api_key*

String

your API key

planet*

String

planet, ex: MOON

full_name*

String

full name, ex: Rahul kumar

day*

Integer

date of birth, eg: 24

month*

Integer

month of birth, eg: 05

year*

Integer

year of birth, eg: 2023

hour*

Integer

hour, eg: 14

min *

Integer

minute, eg: 40

sec*

Integer

second, eg 43

gender*

String

gender, ex: male

place*

String

place, ex: New Delhi

lat*

Float

latitude, eg: 28.7041

lon*

Float

longitude, eg: 77.1025

tzone*

Float

timezone, eg: 5.5 Timezone List

lan

String

Language en/hi, default en

return_year*

Integer

return_year, eg: 2024

return_lat*

Float

return_lat, ex: 19.0760

return_lon*

Float

return_lon, ex: 72.8774

return_tzone*

Float

return_tzone ex: 5.5

return_place*

String

place, ex: Mumbai, Maharashtra, India

house_system

String

House system code, default - P (Placidus)

{
    "status": "success",
    "code": 200,
    "message": "Request successful",
    "data": {
        "planet_return": [
            {
                "return_datetime": "2027-01-01 05:17:00",
                "return_key": "MOON_P_1798780620000"
            },
            {
                "return_datetime": "2027-01-28 12:38:00",
                "return_key": "MOON_P_1801139880000"
            },
            {
                "return_datetime": "2027-02-24 21:58:00",
                "return_key": "MOON_P_1803506280000"
            },
            {
                "return_datetime": "2027-03-24 08:01:00",
                "return_key": "MOON_P_1805875260000"
            },
            {
                "return_datetime": "2027-04-20 16:59:00",
                "return_key": "MOON_P_1808240340000"
            },
            {
                "return_datetime": "2027-05-18 00:01:00",
                "return_key": "MOON_P_1810598460000"
            },
            {
                "return_datetime": "2027-06-14 05:39:00",
                "return_key": "MOON_P_1812951540000"
            },
            {
                "return_datetime": "2027-07-11 11:21:00",
                "return_key": "MOON_P_1815304860000"
            },
            {
                "return_datetime": "2027-08-07 18:34:00",
                "return_key": "MOON_P_1817663640000"
            },
            {
                "return_datetime": "2027-09-04 03:42:00",
                "return_key": "MOON_P_1820029320000"
            },
            {
                "return_datetime": "2027-10-01 13:52:00",
                "return_key": "MOON_P_1822398720000"
            },
            {
                "return_datetime": "2027-10-28 23:25:00",
                "return_key": "MOON_P_1824765900000"
            },
            {
                "return_datetime": "2027-11-25 06:59:00",
                "return_key": "MOON_P_1827125940000"
            },
            {
                "return_datetime": "2027-12-22 12:41:00",
                "return_key": "MOON_P_1829479260000"
            }
        ],
        "planet_data": {
            "name": "Moon",
            "sign": "li",
            "speed": "11.9818279",
            "is_retro": "false",
            "longitude": "24:29:55",
            "full_degree": "204.4984819"
        }
    }
}

Take a look at how you might call this method via cURL, NodeJS or JavaScript jQuery AJAX and Python :

curl --location 'https://astroapi-8.divineapi.com/western-api/v1/planet-returns-list' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'planet="MOON"' \
--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 'return_year="2024"' \
--form 'return_place="New Delhi"' \
--form 'return_lat="28.7041"' \
--form 'return_lon="77.1025"' \
--form 'return_tzone="5.5"'

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-8.divineapi.com/western-api/v1/planet-returns-list',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'planet': 'MOON',
    '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',
    'return_year': '2024',
    'return_place': 'New Delhi',
    'return_lat': '28.7041',
    'return_lon': '77.1025',
    'return_tzone': '5.5',
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("planet", "MOON");
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("return_year", "2024");
form.append("return_place", "New Delhi");
form.append("return_lat", "28.7041");
form.append("return_lon", "77.1025");
form.append("return_tzone", "5.5");

var settings = {
  "url": "https://astroapi-8.divineapi.com/western-api/v1/planet-returns-list",
  "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);
});

import requests

url = "https://astroapi-8.divineapi.com/western-api/v1/planet-returns-list"

payload = {'api_key': '{Your API Key}',
'planet': 'MOON',
'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_year': '2024',
'transit_place': 'New Delhi',
'transit_lat': '28.7041',
'transit_lon': '77.1025',
'transit_tzone': '5.5',
}
files=[

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

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

print(response.text)

PreviousPlanet Returns NextPlanet Returns Details

Last updated 11 hours ago