Annual

Tajik varshaphal: the solar-return chart for a year of life.

Tajik varshaphal: annual chart, muntha, year lord, Mudda dasha

POST/v1/varshaphal

3 credits · Secret key (test or live) · getVarshaphal

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
≥ 1900 · ≤ 2100
options Options
- ayanamsa string
  Each system is its Swiss Ephemeris definition (a constant offset from Lahiri). Applies to chart operations; KP operations always use KP-New and the personal muhurat stays Lahiri. meta.ayanamsa names the system used.
  one of lahiri, raman, krishnamurti, yukteshwar, fagan_bradley · default "lahiri"
- house_system string
  one of whole_sign · default "whole_sign"
- node string
  one of true, mean · default "true"
- lang string
  one of en, hi · default "en"
- view string
  compact drops labels and prose — for LLM callers.
  one of full, compact · default "full"
No other fields are accepted.

No other fields are accepted.

Response

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

year integer required
solar_return string (date-time) required
is_day boolean required
lagna object required
- sign string required
- degree number required
muntha object required
- sign string required
- house integer required
- lord string required
year_lord string required
mudda_dasha array of object required
- lord string required
- start string (date-time) required
- end string (date-time) required
harsha_bala map of number required
panchavargeeya map of number required
sahams array of object required
- id string required
- longitude number required
- sign string required
- house integer required
tajik_yogas array of object required
- kind string required
- planets array of string required

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

Example request

curl -X POST 'https://api.astrologics.in/v1/varshaphal' \
  -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/varshaphal", {
  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/varshaphal",
    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/varshaphal');
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 · 5,867 characters

{
  "data": {
    "year": 2026,
    "solar_return": "2026-08-13T06:28:00.000Z",
    "is_day": true,
    "lagna": {
      "sign": "libra",
      "degree": 15.8
    },
    "muntha": {
      "sign": "leo",
      "house": 11,
      "lord": "sun"
    },
    "year_lord": "moon",
    "mudda_dasha": [
      {
        "lord": "venus",
        "start": "2026-08-13T06:28:00.000Z",
        "end": "2026-10-13T03:29:00.000Z"
      },
      {
        "lord": "sun",
        "start": "2026-10-13T03:29:00.000Z",
        "end": "2026-10-31T09:47:00.000Z"
      },
      {
        "lord": "moon",
        "start": "2026-10-31T09:47:00.000Z",
        "end": "2026-11-30T20:18:00.000Z"
      },
      {
        "lord": "mars",
        "start": "2026-11-30T20:18:00.000Z",
        "end": "2026-12-22T03:39:00.000Z"
      },
      {
        "lord": "rahu",
        "start": "2026-12-22T03:39:00.000Z",
        "end": "2027-02-14T22:34:00.000Z"
      },
      {
        "lord": "jupiter",
        "start": "2027-02-14T22:34:00.000Z",
        "end": "2027-04-04T15:23:00.000Z"
      },
      {
        "lord": "saturn",
        "start": "2027-04-04T15:23:00.000Z",
        "end": "2027-06-01T11:21:00.000Z"
      },
      {
        "lord": "mercury",
        "start": "2027-06-01T11:21:00.000Z",
        "end": "2027-07-23T05:13:00.000Z"
      },
      {
        "lord": "ketu",
        "start": "2027-07-23T05:13:00.000Z",
        "end": "2027-08-13T12:34:00.000Z"
      }
    ],
    "harsha_bala": {
      "sun": 10,
      "moon": 0,
      "mars": 5,
      "mercury": 0,
      "jupiter": 15,
      "venus": 0,
      "saturn": 0
    },
    "panchavargeeya": {
      "sun": 8.3,
      "moon": 9.99,
      "mars": 6.42,
      "mercury": 8.87,
      "jupiter": 11.27,
      "venus": 9.79,
      "saturn": 7.39
    },
    "sahams": [
      {
        "id": "punya",
        "longitude": 232.98,
        "sign": "scorpio",
        "house": 2
      },
      {
        "id": "vidya",
        "longitude": 188.63,
        "sign": "libra",
        "house": 1
      },
      {
        "id": "yasas",
        "longitude": 98.26,
        "sign": "cancer",
        "house": 10
      },
      {
        "id": "mitra",
        "longitude": 64.64,
        "sign": "gemini",
        "house": 9
      },
      {
        "id": "mahatmya",
        "longitude": 1.74,
        "sign": "aries",
        "house": 7
      },
      {
        "id": "gaurava",
        "longitude": 98.26,
        "sign": "cancer",
        "house": 10
      },
      {
        "id": "rajya",
        "longitude": 69.75,
        "sign": "gemini",
        "house": 9
      },
      {
        "id": "pitru",
        "longitude": 69.75,
        "sign": "gemini",
        "house": 9
      },
      {
        "id": "matru",
        "longitude": 157.11,
        "sign": "virgo",
        "house": 12
      },
      {
        "id": "bhratru",
        "longitude": 340.98,
        "sign": "pisces",
        "house": 6
      },
      {
        "id": "karma",
        "longitude": 161,
        "sign": "virgo",
        "house": 12
      },
      {
        "id": "roga",
        "longitude": 268.11,
        "sign": "sagittarius",
        "house": 3
      },
      {
        "id": "kali",
        "longitude": 264.2,
        "sign": "sagittarius",
        "house": 3
      },
      {
        "id": "bandhu",
        "longitude": 174.15,
        "sign": "virgo",
        "house": 12
      },
      {
        "id": "mrityu",
        "longitude": 102.31,
        "sign": "cancer",
        "house": 10
      },
      {
        "id": "vivaha",
        "longitude": 37.73,
        "sign": "taurus",
        "house": 8
      },
      {
        "id": "vyapara",
        "longitude": 302.58,
        "sign": "aquarius",
        "house": 5
      },
      {
        "id": "shatru",
        "longitude": 302.58,
        "sign": "aquarius",
        "house": 5
      },
      {
        "id": "jeeva",
        "longitude": 80.62,
        "sign": "gemini",
        "house": 9
      },
      {
        "id": "karyasiddhi",
        "longitude": 69.75,
        "sign": "gemini",
        "house": 9
      },
      {
        "id": "samartha",
        "longitude": 100.66,
        "sign": "cancer",
        "house": 10
      },
      {
        "id": "artha",
        "longitude": 338.76,
        "sign": "pisces",
        "house": 6
      }
    ],
    "tajik_yogas": [
      {
        "kind": "ithasala",
        "planets": [
          "sun",
          "mars"
        ]
      },
      {
        "kind": "ithasala",
        "planets": [
          "moon",
          "mars"
        ]
      },
      {
        "kind": "ithasala",
        "planets": [
          "mercury",
          "venus"
        ]
      },
      {
        "kind": "ithasala",
        "planets": [
          "jupiter",
          "venus"
        ]
      },
      {
        "kind": "ithasala",
        "planets": [
          "jupiter",
          "saturn"
        ]
      },
      {
        "kind": "ishrafa",
        "planets": [
          "sun",
          "jupiter"
        ]
      },
      {
        "kind": "ishrafa",
        "planets": [
          "sun",
          "saturn"
        ]
      },
      {
        "kind": "ishrafa",
        "planets": [
          "mars",
          "venus"
        ]
      },
      {
        "kind": "nakta",
        "planets": [
          "mars",
          "jupiter"
        ]
      },
      {
        "kind": "nakta",
        "planets": [
          "mars",
          "saturn"
        ]
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.9.28",
    "mode": "live",
    "credits_charged": 3,
    "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
}