Vedic Solar Return API

The minute the Sun returns to its birth longitude in a year, with the chart for that minute

POST/v1/forecast/solar-return

2 credits · Secret key (test or live) · getSolarReturn

Sidereal by default, or tropical for the moment only. The chart is always sidereal on the Lahiri ayanamsa. Give place to cast it somewhere other than the birth place.

Request body

birth Birth required
- date string (date) required
  e.g. "1990-08-13"
- time string
  pattern ^([01]\d|2[0-3]):[0-5]\d(:[0-5]\d)?$ · e.g. "06:30"
- time_accuracy string
  With "unknown", lagna- and house-dependent fields are omitted and listed in warnings — never filled with a noon default.
  one of exact, approximate, unknown · default "exact"
- place Coordinates or object or object required
  Coordinates, a place_id from /v1/places/search, or a free-text query. A vague query returns 422 place_ambiguous with candidates; the API never guesses.
  
  One of:
  1. Coordinates
    Fields
    - latitude number required
      ≥ -90 · ≤ 90
    - longitude number required
      ≥ -180 · ≤ 180
    No other fields are accepted.
  2. object
    Fields
    - place_id string required
    No other fields are accepted.
  3. object
    Fields
    - query string required
      at least 2 characters · at most 120 characters
    No other fields are accepted.
- timezone string
  "auto" (from coordinates AND date), an IANA name, or a fixed offset like "+05:30".
  default "auto"
No other fields are accepted.
year integer required
≥ 1901 · ≤ 2100
frame string
one of sidereal, tropical · default "sidereal"
place Coordinates or object or object
Coordinates, a place_id from /v1/places/search, or a free-text query. A vague query returns 422 place_ambiguous with candidates; the API never guesses.

One of:
1. Coordinates
  Fields
  - latitude number required
    ≥ -90 · ≤ 90
  - longitude number required
    ≥ -180 · ≤ 180
  No other fields are accepted.
2. object
  Fields
  - place_id string required
  No other fields are accepted.
3. object
  Fields
  - query string required
    at least 2 characters · at most 120 characters
  No other fields are accepted.

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

year integer required
frame string required
one of sidereal, tropical
natal_sun_longitude number required
moment string (date-time) required
place object required
- latitude number required
- longitude number required
lagna object required
- sign string required
- degree number required
planets array of object required
- planet string required
- longitude number required
- sign string required
- house integer required
- retrograde boolean required
chart_frame string required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/forecast/solar-return' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}},"year":2026}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/forecast/solar-return", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "birth": {
      "date": "1990-08-13",
      "time": "06:30",
      "place": {
        "latitude": 28.6139,
        "longitude": 77.209
      }
    },
    "year": 2026
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "birth": {
        "date": "1990-08-13",
        "time": "06:30",
        "place": {
            "latitude": 28.6139,
            "longitude": 77.209,
        },
    },
    "year": 2026,
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/forecast/solar-return",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/forecast/solar-return');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}},"year":2026}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 2,046 characters

{
  "data": {
    "year": 2026,
    "frame": "sidereal",
    "natal_sun_longitude": 116.3139,
    "moment": "2026-08-13T06:27:00.000Z",
    "place": {
      "latitude": 28.6139,
      "longitude": 77.209
    },
    "lagna": {
      "sign": "libra",
      "degree": 15.59
    },
    "planets": [
      {
        "planet": "sun",
        "longitude": 116.3147,
        "sign": "cancer",
        "house": 10,
        "retrograde": false
      },
      {
        "planet": "moon",
        "longitude": 123.4816,
        "sign": "leo",
        "house": 11,
        "retrograde": false
      },
      {
        "planet": "mercury",
        "longitude": 101.8333,
        "sign": "cancer",
        "house": 10,
        "retrograde": false
      },
      {
        "planet": "venus",
        "longitude": 162.1804,
        "sign": "virgo",
        "house": 12,
        "retrograde": false
      },
      {
        "planet": "mars",
        "longitude": 67.0347,
        "sign": "gemini",
        "house": 9,
        "retrograde": false
      },
      {
        "planet": "jupiter",
        "longitude": 105.436,
        "sign": "cancer",
        "house": 10,
        "retrograde": false
      },
      {
        "planet": "saturn",
        "longitude": 350.2584,
        "sign": "pisces",
        "house": 6,
        "retrograde": true
      },
      {
        "planet": "rahu",
        "longitude": 305.5552,
        "sign": "aquarius",
        "house": 5,
        "retrograde": true
      },
      {
        "planet": "ketu",
        "longitude": 125.5552,
        "sign": "leo",
        "house": 11,
        "retrograde": true
      }
    ],
    "chart_frame": "sidereal_lahiri"
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 2,
    "ayanamsa": "lahiri",
    "house_system": "whole_sign",
    "node": "true",
    "timezone_used": {
      "name": "Asia/Kolkata",
      "utc_offset": "+05:30",
      "source": "auto"
    }
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON)

{
  "birth": {
    "date": "1990-08-13",
    "time": "06:30",
    "place": {
      "latitude": 28.6139,
      "longitude": 77.209
    }
  },
  "year": 2026
}

Vedic Solar Return API

Request body

Response

Example request

Example response

More in Forecast