ASTROLOGY API REFERENCE DOCUMENTATION

Solar Return/Solar Return Planets

Get Solar Return Planets

API Endpoint
solar_return_planets
Method & Url
MethodFull Url
POSThttps://json.apireports.com/v1/solar_return_planets

Response Data

{
  "status_code": 200,
  "status": true,
  "data": {
    "solar_return_details": {
      "native_birth_date": "1994-09-15 12:30:00",
      "native_age": 27,
      "solar_return_date": "2021-09-15 01:28:11"
    },
    "planets": {
      "sun": {
        "planet_id": 1,
        "planet_name": "Sun",
        "planet_symbol": "☉",
        "full_deg": {
          "deg": 172.2168468,
          "formatted": {
            "full": "172:13:01",
            "deg": "172",
            "min": "13",
            "sec": "01"
          }
        },
        "norm_deg": {
          "deg": 22.216846800000013,
          "formatted": {
            "full": "22:13:01",
            "deg": "22",
            "min": "13",
            "sec": "01"
          }
        },
        "speed": 0.9742047,
        "is_retro": false,
        "sign": {
          "id": 6,
          "name": "Virgo",
          "symbol": "♍︎"
        },
        "house": 3
      },
      "moon": {
        "planet_id": 2,
        "planet_name": "Moon",
        "planet_symbol": "☽",
        "full_deg": {
          "deg": 274.9018521,
          "formatted": {
            "full": "274:54:07",
            "deg": "274",
            "min": "54",
            "sec": "07"
          }
        },
        "norm_deg": {
          "deg": 4.901852099999985,
          "formatted": {
            "full": "04:54:07",
            "deg": "04",
            "min": "54",
            "sec": "07"
          }
        },
        "speed": 13.9801338,
        "is_retro": false,
        "sign": {
          "id": 10,
          "name": "Capricorn",
          "symbol": "♑"
        },
        "house": 6
      },
      "mercury": {
        "planet_id": 3,
        "planet_name": "Mercury",
        "planet_symbol": "☿",
        "full_deg": {
          "deg": 198.8411737,
          "formatted": {
            "full": "198:50:28",
            "deg": "198",
            "min": "50",
            "sec": "28"
          }
        },
        "norm_deg": {
          "deg": 18.841173700000013,
          "formatted": {
            "full": "18:50:28",
            "deg": "18",
            "min": "50",
            "sec": "28"
          }
        },
        "speed": 0.9325366,
        "is_retro": false,
        "sign": {
          "id": 7,
          "name": "Libra",
          "symbol": "♎"
        },
        "house": 4
      },
      "venus": {
        "planet_id": 4,
        "planet_name": "Venus",
        "planet_symbol": "♀",
        "full_deg": {
          "deg": 214.5654545,
          "formatted": {
            "full": "214:33:56",
            "deg": "214",
            "min": "33",
            "sec": "56"
          }
        },
        "norm_deg": {
          "deg": 4.565454499999987,
          "formatted": {
            "full": "04:33:56",
            "deg": "04",
            "min": "33",
            "sec": "56"
          }
        },
        "speed": 1.1462522,
        "is_retro": false,
        "sign": {
          "id": 8,
          "name": "Scorpio",
          "symbol": "♏"
        },
        "house": 4
      },
      "mars": {
        "planet_id": 5,
        "planet_name": "Mars",
        "planet_symbol": "♂",
        "full_deg": {
          "deg": 179.8853229,
          "formatted": {
            "full": "179:53:07",
            "deg": "179",
            "min": "53",
            "sec": "07"
          }
        },
        "norm_deg": {
          "deg": 29.885322900000006,
          "formatted": {
            "full": "29:53:07",
            "deg": "29",
            "min": "53",
            "sec": "07"
          }
        },
        "speed": 0.646089,
        "is_retro": false,
        "sign": {
          "id": 6,
          "name": "Virgo",
          "symbol": "♍︎"
        },
        "house": 3
      },
      "jupiter": {
        "planet_id": 6,
        "planet_name": "Jupiter",
        "planet_symbol": "♃",
        "full_deg": {
          "deg": 324.1092218,
          "formatted": {
            "full": "324:06:33",
            "deg": "324",
            "min": "06",
            "sec": "33"
          }
        },
        "norm_deg": {
          "deg": 24.1092218,
          "formatted": {
            "full": "24:06:33",
            "deg": "24",
            "min": "06",
            "sec": "33"
          }
        },
        "speed": -0.1003913,
        "is_retro": true,
        "sign": {
          "id": 11,
          "name": "Aquarius",
          "symbol": "♒"
        },
        "house": 8
      },
      "saturn": {
        "planet_id": 7,
        "planet_name": "Saturn",
        "planet_symbol": "♄",
        "full_deg": {
          "deg": 307.4393808,
          "formatted": {
            "full": "307:26:22",
            "deg": "307",
            "min": "26",
            "sec": "22"
          }
        },
        "norm_deg": {
          "deg": 7.439380799999981,
          "formatted": {
            "full": "07:26:22",
            "deg": "07",
            "min": "26",
            "sec": "22"
          }
        },
        "speed": -0.0412626,
        "is_retro": true,
        "sign": {
          "id": 11,
          "name": "Aquarius",
          "symbol": "♒"
        },
        "house": 7
      },
      "uranus": {
        "planet_id": 8,
        "planet_name": "Uranus",
        "planet_symbol": "♅",
        "full_deg": {
          "deg": 44.5236996,
          "formatted": {
            "full": "44:31:25",
            "deg": "44",
            "min": "31",
            "sec": "25"
          }
        },
        "norm_deg": {
          "deg": 14.5236996,
          "formatted": {
            "full": "14:31:25",
            "deg": "14",
            "min": "31",
            "sec": "25"
          }
        },
        "speed": -0.0204077,
        "is_retro": true,
        "sign": {
          "id": 2,
          "name": "Taurus",
          "symbol": "♉︎"
        },
        "house": 10
      },
      "neptune": {
        "planet_id": 9,
        "planet_name": "Neptune",
        "planet_symbol": "♆",
        "full_deg": {
          "deg": 351.7734995,
          "formatted": {
            "full": "351:46:25",
            "deg": "351",
            "min": "46",
            "sec": "25"
          }
        },
        "norm_deg": {
          "deg": 21.773499500000014,
          "formatted": {
            "full": "21:46:25",
            "deg": "21",
            "min": "46",
            "sec": "25"
          }
        },
        "speed": -0.0275499,
        "is_retro": true,
        "sign": {
          "id": 12,
          "name": "Pisces",
          "symbol": "♓"
        },
        "house": 9
      },
      "pluto": {
        "planet_id": 10,
        "planet_name": "Pluto",
        "planet_symbol": "♇",
        "full_deg": {
          "deg": 294.4275535,
          "formatted": {
            "full": "294:25:39",
            "deg": "294",
            "min": "25",
            "sec": "39"
          }
        },
        "norm_deg": {
          "deg": 24.427553499999988,
          "formatted": {
            "full": "24:25:39",
            "deg": "24",
            "min": "25",
            "sec": "39"
          }
        },
        "speed": -0.0100904,
        "is_retro": true,
        "sign": {
          "id": 10,
          "name": "Capricorn",
          "symbol": "♑"
        },
        "house": 7
      },
      "chiron": {
        "planet_id": 11,
        "planet_name": "Chiron",
        "planet_symbol": "⚷",
        "full_deg": {
          "deg": 11.4826454,
          "formatted": {
            "full": "11:28:58",
            "deg": "11",
            "min": "28",
            "sec": "58"
          }
        },
        "norm_deg": {
          "deg": 11.4826454,
          "formatted": {
            "full": "11:28:58",
            "deg": "11",
            "min": "28",
            "sec": "58"
          }
        },
        "speed": -0.0419226,
        "is_retro": true,
        "sign": {
          "id": 1,
          "name": "Aries",
          "symbol": "♈︎"
        },
        "house": 9
      },
      "node": {
        "planet_id": 20,
        "planet_name": "True Node",
        "planet_symbol": "☊",
        "full_deg": {
          "deg": 64.7327437,
          "formatted": {
            "full": "64:43:58",
            "deg": "64",
            "min": "43",
            "sec": "58"
          }
        },
        "norm_deg": {
          "deg": 4.7327437,
          "formatted": {
            "full": "04:43:58",
            "deg": "04",
            "min": "43",
            "sec": "58"
          }
        },
        "speed": -0.0216234,
        "is_retro": false,
        "sign": {
          "id": 3,
          "name": "Gemini",
          "symbol": "♊︎"
        },
        "house": 11
      },
      "lilith": {
        "planet_id": 13,
        "planet_name": "Lilith",
        "planet_symbol": "⚸",
        "full_deg": {
          "deg": 66.4763983,
          "formatted": {
            "full": "66:28:35",
            "deg": "66",
            "min": "28",
            "sec": "35"
          }
        },
        "norm_deg": {
          "deg": 6.4763983,
          "formatted": {
            "full": "06:28:35",
            "deg": "06",
            "min": "28",
            "sec": "35"
          }
        },
        "speed": 0.1107696,
        "is_retro": false,
        "sign": {
          "id": 3,
          "name": "Gemini",
          "symbol": "♊︎"
        },
        "house": 11
      },
      "pof": {
        "planet_id": 14,
        "planet_name": "Part of Fortune",
        "planet_symbol": "⊗",
        "full_deg": {
          "deg": 8.793592100000012,
          "formatted": {
            "full": "08:47:37",
            "deg": "08",
            "min": "47",
            "sec": "37"
          }
        },
        "norm_deg": {
          "deg": 8.793592100000012,
          "formatted": {
            "full": "08:47:37",
            "deg": "08",
            "min": "47",
            "sec": "37"
          }
        },
        "speed": 0,
        "is_retro": false,
        "sign": {
          "id": 1,
          "name": "Aries",
          "symbol": "♈︎"
        },
        "house": 9
      },
      "ascendant": {
        "planet_id": 15,
        "planet_name": "Ascendant",
        "planet_symbol": "AC",
        "full_deg": {
          "deg": 111.4785974,
          "formatted": {
            "full": "111:28:43",
            "deg": "111",
            "min": "28",
            "sec": "43"
          }
        },
        "norm_deg": {
          "deg": 21.478597399999998,
          "formatted": {
            "full": "21:28:43",
            "deg": "21",
            "min": "28",
            "sec": "43"
          }
        },
        "speed": 0,
        "is_retro": false,
        "sign": {
          "id": 4,
          "name": "Cancer",
          "symbol": "♋︎"
        },
        "house": 1
      },
      "descendant": {
        "planet_id": 16,
        "planet_name": "Descendant",
        "planet_symbol": "DC",
        "full_deg": {
          "deg": 291.4785974,
          "formatted": {
            "full": "291:28:43",
            "deg": "291",
            "min": "28",
            "sec": "43"
          }
        },
        "norm_deg": {
          "deg": 21.478597400000012,
          "formatted": {
            "full": "21:28:43",
            "deg": "21",
            "min": "28",
            "sec": "43"
          }
        },
        "speed": 0,
        "is_retro": false,
        "sign": {
          "id": 10,
          "name": "Capricorn",
          "symbol": "♑"
        },
        "house": 7
      }
    }
  }
}
JSON
Params Data Type Description Example
day int Date of Birth 15
month int Month of Birth 9
year int Year of Birth 1994
hour int Hour of Birth 12
min int Min of Birth 30
lat float Latitude of Birth Place 28.6139
lon float Longitude of Birth Place 77.1025
tzone float Timezone of Birth Place 5.5
# cURL Request Example

curl --location --request POST 'https://json.apireports.com/v1/solar_return_planets' \
-u '{YourUserID}:{YourApiKey}'\
--header 'Accept-Language: en' \
--header 'Content-Type: application/json' \
--data-raw '{
    "day": 15,
    "month": 9,
    "year": 1994,
    "hour": 12,
    "min": 30,
    "lat": 28.61390000000000100044417195022106170654296875,
    "lon": 77.1025000000000062527760746888816356658935546875,
    "tzone": 5.5
}'

# END
cURL
/* JavaScript Request Example */

var apiEndPoint = "solar_return_planets";
var userId = "{YourUserID}";
var apiKey = "{YourApiKey}";
var language = "en";
var data = {
    "day": 15,
    "month": 9,
    "year": 1994,
    "hour": 12,
    "min": 30,
    "lat": 28.61390000000000100044417195022106170654296875,
    "lon": 77.1025000000000062527760746888816356658935546875,
    "tzone": 5.5
};
var url = 'https://json.apireports.com/v1/'+apiEndPoint;

var request = $.ajax({
	url: url,
	method: "POST",
	dataType:'json',
	headers: {
		"Authorization": "Basic " + btoa(userId+":"+apiKey),
		"Accept-Language": "en",
		"Content-Type":'application/json'
	},
	data:JSON.stringify(data)
});

request.then(
	function(resp){
		console.log(resp);
	},
	function(err){
		console.log(err);
	}
);

/* END */
JavaScript
<?php
/* PHP Request Example */

$apiEndPoint = "solar_return_planets";
$userId = "{YourUserID}";
$apiKey = "{YourApiKey}";
$url = "https://json.apireports.com/v1/";
$data = array(
	"day" => 15,
	"month" => 9,
	"year" => 1994,
	"hour" => 12,
	"min" => 30,
	"lat" => 28.6139,
	"lon" => 77.1025,
	"tzone" => 5.5
);
$ch = curl_init();
curl_setopt($ch,CURLOPT_URL, $url.$apiEndPoint);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 20);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
$header[] = 'Authorization: Basic '. base64_encode($userId.":".$apiKey);
$header[] = 'Accept-Language: en';
$header[] = 'Content-Type: application/json';
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
$response = curl_exec($ch);
$error = curl_error($ch);
$http_code = curl_getinfo($ch ,CURLINFO_HTTP_CODE);
curl_close($ch);
echo $response;

/* END */
PHP
# Python Request Example

import requests
import json

apiEndPoint = "solar_return_planets";
userId = "{YourUserID}";
apiKey = "{YourApiKey}";
url = "https://json.apireports.com/v1/"+apiEndPoint

data = json.dumps({
    "day": 15,
    "month": 9,
    "year": 1994,
    "hour": 12,
    "min": 30,
    "lat": 28.61390000000000100044417195022106170654296875,
    "lon": 77.1025000000000062527760746888816356658935546875,
    "tzone": 5.5
})

headers = {
  'Accept-Language': 'en',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, auth=(userId, apiKey),data=data)

print(response.text)

# END
Python
/* NodeJS Request Example */

var request = require('request');
var apiEndPoint = "solar_return_planets";
var userId = "{YourUserID}";
var apiKey = "{YourApiKey}";
var url = 'https://json.apireports.com/v1/'+apiEndPoint;
var options = {
  'method': 'POST',
  'url': url,
  'auth': {
    'user': userId,
    'password': apiKey
  },
  'headers': {
    'Accept-Language': 'en',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "day": 15,
    "month": 9,
    "year": 1994,
    "hour": 12,
    "min": 30,
    "lat": 28.61390000000000100044417195022106170654296875,
    "lon": 77.1025000000000062527760746888816356658935546875,
    "tzone": 5.5
})
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

/* END */
NodeJS

Astrology API Reports in News