The Vedic astrology API, done right for India.

Kundli, matchmaking, panchang and horoscopes in one clean API, with birth places and historical timezones resolved for you and Hindi built in.

Get a free API key Read the quickstart

Free plan: 3,000 credits a month. Test keys run the real engine and are never charged.

133operations, all on every plan
5.17Mplaces, India-aware
1900–2100birth dates supported

POST/v1/kundli200 OK2 credits

Leo lagna, Magha pada 213 August 1990, 06:30, New Delhi

See the full response

GET/v1/panchang200 OK1 credit

City

Tithi: …
Nakshatra: …
Yoga: …
Karana: …
Vara: …
Sunrise: …
Sunset: …
Rahu kaal: …

Today, for the city you pick. Computed once a day and shared, so this tab spends no credits.

POST/v1/match/ashtakoot200 OK1 credit

Births at 12:00 local time, for the demo. Your app sends the real time.

GET/v1/horoscope/{sign}200 OK1 credit

…

Today's daily reading, in English or Hindi with lang=hi. Shared and cached: no credits.

Live from the API, today

This is what your app would show this morning: the day's panchang for a city and a reading for every sign, computed by the same engine you call.

City

Tithi…
Nakshatra…
Yoga…
Sunrise…
Rahu kaal…

Aries
…
Taurus
…
Gemini
…
Cancer
…
Leo
…
Virgo
…
Libra
…
Scorpio
…
Sagittarius
…
Capricorn
…
Aquarius
…
Pisces
…

GET /v1/panchang and GET /v1/horoscope, cached for the day. Want your own reading? It is on astrologics.in.

Your first call

The code for the call you tried above, in four languages, with its response. Test keys run the real engine and are never charged.

Quickstart API reference openapi.yaml

curl -X POST 'https://api.astrologics.in/v1/kundli' \
  -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
      }
    }
  }'

const res = await fetch("https://api.astrologics.in/v1/kundli", {
  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
      }
    }
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

import json
import urllib.error
import urllib.request

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

req = urllib.request.Request(
    "https://api.astrologics.in/v1/kundli",
    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
$ch = curl_init('https://api.astrologics.in/v1/kundli');
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}}}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

curl 'https://api.astrologics.in/v1/panchang?date=2026-10-02&lat=28.6139&lon=77.209' \
  -H 'Authorization: Bearer al_test_YOUR_KEY'

const res = await fetch("https://api.astrologics.in/v1/panchang?date=2026-10-02&lat=28.6139&lon=77.209", {
  headers: { Authorization: "Bearer al_test_YOUR_KEY" },
});
console.log(JSON.stringify(await res.json(), null, 2));

import json
import urllib.error
import urllib.request

req = urllib.request.Request(
    "https://api.astrologics.in/v1/panchang?date=2026-10-02&lat=28.6139&lon=77.209",
    method="GET",
    headers={"Authorization": "Bearer al_test_YOUR_KEY"},
)
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
$ch = curl_init('https://api.astrologics.in/v1/panchang?date=2026-10-02&lat=28.6139&lon=77.209');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

curl -X POST 'https://api.astrologics.in/v1/match/ashtakoot' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "person_a": {
      "date": "1990-08-13",
      "time": "06:30",
      "place": {
        "latitude": 28.6139,
        "longitude": 77.209
      }
    },
    "person_b": {
      "date": "1992-03-02",
      "time": "14:10",
      "place": {
        "latitude": 19.076,
        "longitude": 72.8777
      }
    }
  }'

const res = await fetch("https://api.astrologics.in/v1/match/ashtakoot", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "person_a": {
      "date": "1990-08-13",
      "time": "06:30",
      "place": {
        "latitude": 28.6139,
        "longitude": 77.209
      }
    },
    "person_b": {
      "date": "1992-03-02",
      "time": "14:10",
      "place": {
        "latitude": 19.076,
        "longitude": 72.8777
      }
    }
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

import json
import urllib.error
import urllib.request

body = {
    "person_a": {
        "date": "1990-08-13",
        "time": "06:30",
        "place": {
            "latitude": 28.6139,
            "longitude": 77.209,
        },
    },
    "person_b": {
        "date": "1992-03-02",
        "time": "14:10",
        "place": {
            "latitude": 19.076,
            "longitude": 72.8777,
        },
    },
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/match/ashtakoot",
    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
$ch = curl_init('https://api.astrologics.in/v1/match/ashtakoot');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"person_a":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}},"person_b":{"date":"1992-03-02","time":"14:10","place":{"latitude":19.076,"longitude":72.8777}}}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

curl 'https://api.astrologics.in/v1/horoscope/leo?period=weekly&date=2026-10-02&lang=hi' \
  -H 'Authorization: Bearer al_test_YOUR_KEY'

const res = await fetch("https://api.astrologics.in/v1/horoscope/leo?period=weekly&date=2026-10-02&lang=hi", {
  headers: { Authorization: "Bearer al_test_YOUR_KEY" },
});
console.log(JSON.stringify(await res.json(), null, 2));

import json
import urllib.error
import urllib.request

req = urllib.request.Request(
    "https://api.astrologics.in/v1/horoscope/leo?period=weekly&date=2026-10-02&lang=hi",
    method="GET",
    headers={"Authorization": "Bearer al_test_YOUR_KEY"},
)
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
$ch = curl_init('https://api.astrologics.in/v1/horoscope/leo?period=weekly&date=2026-10-02&lang=hi');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Replace al_test_YOUR_KEY with your own test key. Test calls are free: 100 a day for each project.

Example response200 OK

{
  "data": {
    "lagna": {
      "sign": "leo",
      "degree": 4.27,
      "nakshatra": "magha",
      "pada": 2
    },
    "planets": [
      { "id": "sun", "sign": "cancer", "house": 12 },
      { "id": "moon", "sign": "aries", "house": 9 },
      … 7 more grahas
    ],
    "divisional_lagnas": {
      "D2": "leo",
      "D9": "taurus",
      "D10": "virgo"
    }
  },
  "meta": {
    "engine_version": "2026.10.10",
    "ayanamsa": "lahiri",
    "timezone_used": {
      "name": "Asia/Kolkata",
      "utc_offset": "+05:30",
      "source": "auto"
    }
  },
  "warnings": []
}

{
  "data": {
    "date": "2026-10-02",
    "place": {
      "latitude": 28.6139,
      "longitude": 77.209
    },
    "timezone": {
      "name": "Asia/Kolkata",
      "utc_offset": "+05:30"
    },
    "tithi": {
      "number": 22,
      "name": "saptami",
      "label": "Saptami",
      "paksha": "krishna",
      "ends_at": "2026-10-03T08:00:00+05:30",
      "note": "Positive - a day for action",
      "note_id": "tithi_saptami"
    },
    "nakshatra": {
      "name": "mrigashira",
      "label": "Mrigashira",
      "lord": "mars",
      "next": "ardra",
      "ends_at": "2026-10-03T02:55:00+05:30",
      "weight": 0.05,
      "number": 5,
      "hours_remaining": 14.9
    },
    "yoga": {
      "name": "vyatipata",
  … trimmed to fit
}

{
  "data": {
    "total": 10.5,
    "max": 36,
    "conclusion": "Below recommended - consult an astrologer",
    "kootas": [
      {
        "name": "varna",
        "label": "Varna",
        "score": 1,
        "max": 1,
        "note": "Kshatriya / Vaishya"
      },
      {
        "name": "vashya",
        "label": "Vashya",
        "score": 0.5,
        "max": 2,
        "note": "Chatushpada / Jalachara"
      },
      {
        "name": "tara_dina",
        "label": "Tara / Dina",
        "score": 1.5,
        "max": 3,
        "note": "Star compatibility"
      },
      {
        "name": "yoni",
        "label": "Yoni",
        "score": 0,
        "max": 4,
  … trimmed to fit
}

{
  "data": {
    "sign": "leo",
    "sign_label": "सिंह",
    "period": "weekly",
    "date": "2026-10-02",
    "reading": "कार्यक्षेत्र में मिश्रित स्थिति - सोच-समझकर निर्णय लें। प्रेम जीवन अनुकूल रहेगा, साथी से तालमेल अच्छा रहेगा। स्वास्थ्य में उतार-चढ़ाव - खानपान का ध्यान रखें। आर्थिक स्थिति स्थिर रहेगी।",
    "scores": {
      "love": 58,
      "career": 39,
      "health": 43,
      "money": 47
    },
    "score_notes": {
      "love": "Favourable",
      "career": "Mixed",
      "health": "Mixed",
      "money": "Steady"
    },
    "ruler": "sun",
    "element": "fire",
    "lucky": {
      "color": "Gold",
      "number": "1",
      "day": "Sunday",
      "gem": "Ruby",
      "time": "3-5 PM",
      "mood": "Patient"
    },
    "transits": [
      {
        "planet": "venus",
  … trimmed to fit
}

What you can build

133 operations in 23 groups. Filter them, and open any card's JSON to see exactly what comes back.

Try each call Browse the API reference

Panchang & muhurat

10 operations

Daily panchang, choghadiya, hora, a day judged for an activity, and dated muhurat lists.

Friday 2 October 2026, New Delhi

TithiSaptamiKrishna paksha
NakshatraMrigashiralord Mars
YogaVyatipatainauspicious
KaranaVishtinumber 43
VaraShukravaraFriday

Gulika 07:43–09:12
Rahu kaal 10:41–12:10
Yamaganda 15:08–16:37
Abhijit muhurat 11:47–12:34

{
  "date": "2026-10-02",
  "place": {
    "latitude": 28.6139,
    "longitude": 77.209
  },
  "timezone": {
    "name": "Asia/Kolkata",
    "utc_offset": "+05:30"
  },
  "tithi": {
    "number": 22,
    "name": "saptami",
    "label": "Saptami",
    "paksha": "krishna",
    "ends_at": "2026-10-03T08:00:00+05:30",
    "note": "Positive - a day for action",
    "note_id": "tithi_saptami"
  },
  "nakshatra": {
    "name": "mrigashira",
    "label": "Mrigashira",
    "lord": "mars",
    "next": "ardra",
  … trimmed

GET/v1/panchang1 credit, works with a publishable key

Lagna, nine grahas, divisional charts, aspects, yogas, Ashtakavarga, Shadbala, upagrahas, arudha padas, the classical layer, outer planets, the D12, Asta and Uday, position series and rashi and nakshatra tables.

Birth chart2 credits
Avakhada birth details1 credit
Divisional charts, D1–D602 credits
Graha drishti (aspects)1 credit
Yogas, with strength and rule2 credits
Bhinna and Sarva Ashtakavarga2 credits
Wealth from D1, D2, D9 and D102 credits
Gemstones by functional lordship2 credits
Shadbala, the six strengths2 credits
Classical layer: cusps, bhava bala, avasthas2 credits
Uranus, Neptune and Pluto2 credits
D12, the lineage chart2 credits
Upagrahas, from the Sun and the day1 credit
Arudha padas and Upapada1 credit
Chara karakas1 credit
Bhav chalit1 credit
Asta and Uday at a place2 credits
Positions over a range2 credits
The 12 rashis1 credit
The 27 nakshatras1 credit
Positions at any moment1 credit
The sky now, by the hour1 credit
Retrograde cycle of Saturn and the outer planets1 credit
Several chart reads in one call3 credits

{
  "lagna": {
    "sign": "leo",
    "sign_label": "Leo",
    "degree": 4.27,
    "nakshatra": "magha",
    "nakshatra_label": "Magha",
    "pada": 2
  },
  "planets": [
    {
      "id": "sun",
      "label": "Sun",
      "longitude": 116.3139,
      "sign": "cancer",
      "degree_in_sign": 26.3139,
      "nakshatra": "ashlesha",
      "pada": 3,
      "nakshatra_lord": "mercury",
      "house": 12,
      "retrograde": false
    },
    {
      "id": "moon",
  … trimmed

POST/v1/kundli2 credits

Horoscopes

4 operations

By sign and period, or from a birth chart, in English and Hindi.

सिंहLeo, weekly, in Hindi

कार्यक्षेत्र में मिश्रित स्थिति - सोच-समझकर निर्णय लें। प्रेम जीवन अनुकूल रहेगा, साथी से तालमेल अच्छा रहेगा। स्वास्थ्य में उतार-चढ़ाव - खानपान का ध्यान रखें। आर्थिक स्थिति स्थिर रहेगी।

Love58Favourable
Career39Mixed
Health43Mixed
Money47Steady

{
  "sign": "leo",
  "sign_label": "सिंह",
  "period": "weekly",
  "date": "2026-10-02",
  "reading": "कार्यक्षेत्र में मिश्रित स्थिति - सोच-समझकर निर्णय लें। प्रेम जीवन अनुकूल रहेगा, साथी से तालमेल अच्छा रहेगा। स्वास्थ्य में उतार-चढ़ाव - खानपान का ध्यान रखें। आर्थिक स्थिति स्थिर रहेगी।",
  "scores": {
    "love": 58,
    "career": 39,
    "health": 43,
    "money": 47
  },
  "score_notes": {
    "love": "Favourable",
    "career": "Mixed",
    "health": "Mixed",
    "money": "Steady"
  },
  "ruler": "sun",
  "element": "fire",
  "lucky": {
    "color": "Gold",
    "number": "1",
    "day": "Sunday",
  … trimmed

GET/v1/horoscope/{sign}1 credit, works with a publishable key

Doshas

4 operations

Manglik with named cancellations, Kaal Sarp, and Sade Sati today or over a lifetime.

Manglik

Low (with cancellation)

9from lagna
1from Moon
10from Venus

Mars is in its own/exalted sign (Aries) - dosha is greatly reduced.
Mars is conjunct the Moon - the dosha is reduced.

{
  "manglik": true,
  "severity": "Low (with cancellation)",
  "house_from_lagna": 9,
  "house_from_moon": 1,
  "house_from_venus": 10,
  "cancellations": [
    "Mars is in its own/exalted sign (Aries) - dosha is greatly reduced.",
    "Mars is conjunct the Moon - the dosha is reduced."
  ]
}

POST/v1/dosha/manglik1 credit

Dasha

4 operations

Vimshottari to five levels, Yogini and Chara, and the periods running now.

VeSuMoMaRaJuSaMeKe

Running on 2 October 2026

MahadashaRahu21 Jun 2026 – 21 Jun 2044
AntardashaRahu21 Jun 2026 – 4 Mar 2029
PratyantardashaRahu21 Jun 2026 – 16 Nov 2026
SookshmaVenus24 Sep 2026 – 19 Oct 2026
PranaMoon30 Sep 2026 – 2 Oct 2026

{
  "at": "2026-10-02T00:00:00.000Z",
  "mahadasha": {
    "planet": "rahu",
    "start": "2026-06-21T16:53:13.747Z",
    "end": "2044-06-21T04:53:13.747Z"
  },
  "antardasha": {
    "planet": "rahu",
    "start": "2026-06-21T16:53:13.747Z",
    "end": "2029-03-03T21:05:13.747Z"
  },
  "pratyantardasha": {
    "planet": "rahu",
    "start": "2026-06-21T16:53:13.747Z",
    "end": "2026-11-16T15:07:01.747Z"
  },
  "sookshma": {
    "planet": "venus",
    "start": "2026-09-24T14:57:05.047Z",
    "end": "2026-10-19T06:39:23.047Z"
  },
  "prana": {
    "planet": "moon",
  … trimmed

POST/v1/dasha/vimshottari/current2 credits

Places & time

4 operations

5.17M birth places, India-aware, and the timezone at any moment.

Birth place

Noida

NoidaUttar Pradesh, IndiaAsia/Kolkatapl_2028
Noidans-lès-VesoulBourgogne, FranceEurope/Parispl_106077
NoidanBourgogne, FranceEurope/Parispl_328080

{
  "results": [
    {
      "place_id": "pl_2028",
      "name": "Noida",
      "country": "India",
      "latitude": 28.58,
      "longitude": 77.33,
      "timezone": "Asia/Kolkata",
      "state": "Uttar Pradesh",
      "population": 293908
    },
    {
      "place_id": "pl_106077",
      "name": "Noidans-lès-Vesoul",
      "country": "France",
      "latitude": 47.61299,
      "longitude": 6.12571,
      "timezone": "Europe/Paris",
      "state": "Bourgogne",
      "population": 2163
    },
    {
      "place_id": "pl_328080",
  … trimmed

GET/v1/places/search1 credit

Numerology

Chaldean and Pythagorean core numbers, names, business and lucky names, mobile numbers and Lo Shu.

49923578116

Missing 2, 4, 5, 6, 7

{
  "grid": [
    [
      0,
      2,
      0
    ],
    [
      1,
      0,
      0
    ],
    [
      1,
      2,
      0
    ]
  ],
  "missing": [
    2,
    4,
    5,
    6,
    7
  … trimmed

POST/v1/numerology/loshu

8 operations, 1 credit each

Chart images

Charts drawn as SVG or PNG, North or South Indian style.

north, light

south, dark

POST/v1/charts/{varga}.svg

2 operations, 2–3 credits, D1 to D60

Transits

Ingresses, stations and combustion between dates, transits over a birth chart, and planetary war now.

18 Sep 2026Mars enters Cancer
31 Oct 2026Jupiter enters Leo
25 Nov 2026Rahu enters Capricorn

{
  "events": [
    {
      "planet": "mars",
      "type": "ingress",
      "date": "2026-09-18",
      "at": "2026-09-18T11:05:46.000Z",
      "from_sign": "gemini",
      "to_sign": "cancer"
    },
    {
      "planet": "jupiter",
      "type": "ingress",
      "date": "2026-10-31",
      "at": "2026-10-31T06:38:48.000Z",
      "from_sign": "cancer",
      "to_sign": "leo"
    },
    {
      "planet": "mars",
      "type": "ingress",
      "date": "2026-11-12",
      "at": "2026-11-12T14:48:51.000Z",
      "from_sign": "cancer",
  … trimmed

GET/v1/transits

6 operations, 1–2 credits

Platform

Your usage, and the conventions every result uses.

ayanamsa: lahiri
house_system: whole_sign
node: true
engine_version: 2026.10.10

{
  "engine_version": "2026.10.10",
  "ayanamsa": "lahiri",
  "kp_ayanamsa": "kp_new (Lahiri − 5′24″)",
  "house_system": "whole_sign",
  "node": "true",
  "sunrise": "upper limb, refracted",
  "moonrise": "the Moon's centre on the true horizon (festival moments; the panchang does not give moonrise)",
  "lunar_month": "amanta (new moon to new moon); purnimanta names alongside",
  "ayanamsa_options": "lahiri (default), raman, krishnamurti, yukteshwar, fagan_bradley: options.ayanamsa on chart operations; the calendar, panchang and KP are unaffected",
  "not_computed": [
    "moonrise in the panchang",
    "yoga/karana end times",
    "Vaishnava paran (Ekadashi)",
    "Vaishnava Janmashtami",
    "Ghatak Chakra",
    "Chara-dasha antardashas"
  ]
}

GET/v1/meta/conventions

2 operations, both free

Calendar

Tithis to the minute, every Ekadashi with its paran, and festivals by their rules.

20 Oct 2026Vijayadashami (Dussehra)विजयादशमी (दशहरा)
8 Nov 2026Diwali (Lakshmi Puja)दीपावली (लक्ष्मी पूजा)
24 Nov 2026Kartik Purnimaकार्तिक पूर्णिमा

50 festivals a year, each by its stated rule

{
  "year": 2026,
  "verified_years": [
    2026
  ],
  "verified_place": {
    "name": "Delhi",
    "latitude": 28.6139,
    "longitude": 77.209
  },
  "festivals": [
    {
      "id": "makar_sankranti",
      "name": "Makar Sankranti",
      "name_hi": "मकर संक्रांति",
      "date": "2026-01-14",
      "rule": "the day of the Sun's sidereal entry into Makara, or the next day if it enters after sunset; punya kaal from a daytime entry to sunset",
      "tithi": {
        "number": 26,
        "id": "ekadashi",
        "paksha": "krishna",
        "start": "2026-01-13T09:49:00.000Z",
        "end": "2026-01-14T12:24:00.000Z"
      },
  … trimmed

GET/v1/calendar/festivals

3 operations, 1–2 credits

KP

Cusps and sub lords, significators, ruling planets and horary.

2 October 2026, New Delhi

day lord: Venus
lagna: Mars · Mercury · Sun
moon: Venus · Mars · Jupiter

Sign, star and sub lords

{
  "at": "2026-10-02T06:00:00.000Z",
  "day_lord": "venus",
  "lagna": {
    "sign_lord": "mars",
    "star_lord": "mercury",
    "sub_lord": "sun"
  },
  "moon": {
    "sign_lord": "venus",
    "star_lord": "mars",
    "sub_lord": "jupiter"
  },
  "local": {
    "date": "2026-10-02",
    "time": "11:30",
    "offset_hours": 5.5
  },
  "weekday": {
    "name": "friday",
    "lord": "venus"
  },
  "lagna_sign": "scorpio",
  "moon_sign": "taurus",
  … trimmed

GET/v1/kp/ruling-planets

6 operations, 1–2 credits

Lal Kitab

The teva, planet states, the nine debts, the annual chart and remedies.

Pitru Rinपितृ ऋणmild
Matru Rinमातृ ऋणmoderate

2 of 9 debts present

{
  "graded_by": "astrologics",
  "debts": [
    {
      "id": "pitru",
      "label": "Pitru Rin",
      "label_hi": "पितृ ऋण",
      "of": "Ancestors / father",
      "present": true,
      "severity": "mild",
      "reasons": [
        "Mercury in khana 5 fires this debt",
        "Mercury is nek there",
        "Mercury is asleep",
        "Sun’s buniyaadi sight reaches khana 12",
        "Moon’s buniyaadi sight reaches khana 9",
        "Mars’s buniyaadi sight reaches khana 9",
        "Mercury’s dhokhe sight falls on khana 2",
        "Jupiter’s buniyaadi sight reaches khana 12",
        "Venus’s buniyaadi sight reaches khana 12",
        "Saturn’s buniyaadi sight reaches khana 5",
        "Ketu’s buniyaadi sight reaches khana 12"
      ]
    },
  … trimmed

POST/v1/lal-kitab/debts

4 operations, 1–2 credits

Annual

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

Year 2026, for a birth on 13 Aug 1990

solar return: 13 Aug 2026, 11:55
varsha lagna: Libra 15.34°
muntha: Leo, house 11
year lord: Moon

{
  "year": 2026,
  "solar_return": "2026-08-13T06:25:50.000Z",
  "is_day": true,
  "lagna": {
    "sign": "libra",
    "degree": 15.34
  },
  "muntha": {
    "sign": "leo",
    "house": 11,
    "lord": "sun"
  },
  "year_lord": "moon",
  "mudda_dasha": [
    {
      "lord": "venus",
      "start": "2026-08-13T06:25:50.000Z",
      "end": "2026-10-13T03:27:30.000Z"
    },
    {
      "lord": "sun",
      "start": "2026-10-13T03:27:30.000Z",
      "end": "2026-10-31T09:46:00.000Z"
  … trimmed

POST/v1/varshaphal

1 operation, 3 credits

Timing

Day scores from the running dasha and the transits, favourable days by tara bala, and the eclipses over a chart.

Birth star Bharani, from 3 Nov 2026

3 Nov 2026Best Friend tara, favourable
4 Nov 2026Birth Star tara, neutral
5 Nov 2026Wealth tara, favourable
6 Nov 2026Danger tara, unfavourable
7 Nov 2026Happiness tara, favourable

7 days ahead, by tara bala

{
  "as_of": "2026-11-03T02:15:51.124Z",
  "birth_nakshatra": "bharani",
  "days": [
    {
      "date": "2026-11-03",
      "weekday": "tuesday",
      "moon_nakshatra": "magha",
      "tara": {
        "id": "param_mitra",
        "number": 9,
        "label": "Best Friend"
      },
      "type": "favourable",
      "score": 3,
      "description": "Param Mitra: Most auspicious - ideal for any major activity",
      "description_id": "param_mitra_most_auspicious_ideal_for_any_major_activity"
    },
    {
      "date": "2026-11-04",
      "weekday": "wednesday",
      "moon_nakshatra": "purva_phalguni",
      "tara": {
        "id": "janma",
  … trimmed

POST/v1/timing/favourable-days

5 operations, 1–2 credits

Vastu

7 operations

The mandala over a real plot in metres, the door's pada, plot and room findings, and Ayadi, each with its source.

A door on the east wall of a 18 × 27 m plot

pada: Surya, 5 of 32
the text says: Increase of anger.
verses: Brihat Samhita 53: 43, 72, 71
better on this wall: Indra

Each rule cites its verse or is labelled convention

{
  "grid": 81,
  "plot": {
    "width_m": 18,
    "depth_m": 27,
    "facing_deg": 90,
    "front": "east",
    "skew_deg": 0,
    "east_west_m": 27,
    "north_south_m": 18,
    "area_m2": 486
  },
  "door": {
    "wall": "front",
    "compass": "east",
    "from_left_m": 10,
    "width_m": 1.2
  },
  "pada": 5,
  "side": "east",
  "ordinal_on_side": 5,
  "devata": {
    "id": "surya",
    "name": "Surya"
  … trimmed

POST/v1/vastu/entrance1 credit

Reports

Client-ready PDF kundli, matching and Vastu reports under your name and logo, in English or Hindi.

Under the name Sample Jyotish Studio

Kundli, matching and Vastu, in English or Hindi

POST/v1/reports/kundli.pdf

3 operations, 10 credits each

Biorhythm

6 operations

The 23, 28 and 33 day cycles from a date of birth: values, critical days, phases and a daily summary in English or Hindi.

Day 13,320 since birth

physical 73, emotional -97, intellectual -76

{
  "date": "2026-11-02",
  "days_since_birth": 13320,
  "cycles": [
    {
      "id": "physical",
      "name": "Physical",
      "period_days": 23,
      "value": 73.1,
      "state": "positive",
      "trend": "rising",
      "day_in_cycle": 3,
      "next_critical": "2026-11-10",
      "meaning": "The physical cycle is in its upper half, which biorhythm charts read as more energy and stamina."
    },
    {
      "id": "emotional",
      "name": "Emotional",
      "period_days": 28,
      "value": -97.5,
      "state": "negative",
      "trend": "falling",
      "day_in_cycle": 20,
      "next_critical": "2026-11-10",
  … trimmed

POST/v1/biorhythm/reading1 credit

Forecast

5 operations

Dasha changes, Saturn's periods, sign changes and natal degree hits in date order, a monthly digest and the solar return.

2026-11: 8 dated events

Mars reaches the natal Sun degree.

{
  "month": "2026-11",
  "running": {
    "mahadasha": {
      "lord": "rahu",
      "until": "2044-06-21T04:53:13.747Z"
    },
    "antardasha": {
      "lord": "rahu",
      "until": "2029-03-03T21:05:13.747Z"
    },
    "saturn_period": {
      "period": "sade_sati",
      "until": "2032-05-30T21:29:10.451Z"
    }
  },
  "planets_at_start": [
    {
      "planet": "sun",
      "sign": "libra",
      "house_from_moon": 7,
      "house_from_lagna": 3,
      "longitude": 194.3425,
      "retrograde": false
  … trimmed

POST/v1/forecast/digest2 credits

Western

9 operations

Tropical birth charts with real house cusps, a wheel in SVG, aspects, synastry, composite, transits, progressions and returns.

Tropical, placidus houses

Sun 20°02′ Leo, ascendant 28°00′ Leo

{
  "moment": "1990-08-13T01:00:00.000Z",
  "frame": "tropical",
  "house_system": "placidus",
  "planets": [
    {
      "id": "sun",
      "name": "Sun",
      "longitude": 140.0441,
      "sign": "leo",
      "sign_name": "Leo",
      "degree": 20.0441,
      "formatted": "20°02′ Leo",
      "speed": 0.96,
      "retrograde": false,
      "house": 12,
      "dignity": "domicile"
    },
    {
      "id": "moon",
      "name": "Moon",
      "longitude": 41.8257,
      "sign": "taurus",
      "sign_name": "Taurus",
  … trimmed

POST/v1/western/chart2 credits

Chinese

7 operations

Bazi, luck pillars, the year against a chart, branch and stem relations, the Chinese calendar and the 24 solar terms.

Year, month, day and hour

庚午甲申庚戌己卯

{
  "moment": "1990-08-13T01:00:00.000Z",
  "time_known": true,
  "time_basis": "clock",
  "zi_convention": "day_changes_at_23",
  "zi_hour": null,
  "solar_year": 1990,
  "pillars": {
    "year": {
      "name": "Geng Wu",
      "chinese": "庚午",
      "cycle_number": 7,
      "stem": {
        "id": "geng",
        "chinese": "庚",
        "element": "metal",
        "element_name": "Metal",
        "polarity": "yang",
        "ten_god": {
          "id": "bi_jian",
          "name": "Friend"
        }
      },
      "branch": {
  … trimmed

POST/v1/chinese/bazi2 credits

Feng Shui

5 operations

Kua and Eight Mansions, flying star charts with an SVG grid, and each year's stars and afflictions.

Period 9, facing south (午)

Mountain 1, water 8 and base 4 at the facing palace

{
  "period": 9,
  "facing": {
    "degrees": 180,
    "mountain": {
      "id": "wu",
      "chinese": "午",
      "palace": {
        "id": "S",
        "name": "south"
      },
      "order_in_palace": 2,
      "from_degree": 172.5,
      "to_degree": 187.5
    }
  },
  "sitting": {
    "degrees": 0,
    "mountain": {
      "id": "zi",
      "chinese": "子",
      "palace": {
        "id": "N",
        "name": "north"
  … trimmed

POST/v1/feng-shui/flying-stars2 credits

Not a developer?

Astrologers and Vastu consultants can add tools to their own site without code.

WordPress plugin: blocks and shortcodes
Widgets: one script tag on any site
For astrologers
For Vastu consultants

Give your AI assistant real numbers

A language model cannot calculate a tithi or a lagna. Connect it to the API's MCP server and it calls the same operations you do, then answers from the result.

claude mcp add --transport http astrologics https://api.astrologics.in/mcp \
  --header "Authorization: Bearer al_test_YOUR_KEY"

MCP servers Build an AI chatbot

An example conversation, from the recorded example for 2026-10-02

What is the tithi in New Delhi today, and when is Rahu kaal?
MCP toolgetPanchang{ "date": "2026-10-02", "lat": 28.6139, "lon": 77.209 }
tithi: Saptami (krishna) · nakshatra: Mrigashira · rahu_kaal: 10:41–12:10
In New Delhi it is Saptami in the krishna paksha, with the Moon in Mrigashira. Rahu kaal runs from 10:41 to 12:10.

Drop a widget on any page

One script tag and one element. These are the real widgets, running here against the demo. Pick one, recolour it, and copy the snippet.

Widgets guide WordPress plugin

Colour

Language

Your snippet

<script src="https://developers.astrologics.in/widgets/v1.js" defer></script>
<astrologics-panchang key="YOUR_PUBLISHABLE_KEY" lat="28.6139" lon="77.209"></astrologics-panchang>

Panchang and horoscope work with a publishable key. Kundli and match need endpoint: a server of yours that holds the secret key.

The widget loads here.

Build it your way

Call the API directly, or start from one of these.

The API never guesses.

A kundli is only as right as the place, time and offset it was cast from. So when an input is vague, the API asks instead of assuming.

Vague places come back as a question

Send coordinates, a place_id or a free-text query. When more than one place matches, you get 422 place_ambiguous with the candidates to choose from.

"place": { "query": "Aurangabad" }

422place_ambiguous

"candidates": [
  { "name": "Aurangabad",
    "state": "Maharashtra", … },
  { "name": "Aurangābād",
    "state": "Bihar", … }
]

An unknown birth time stays unknown

Say what you know with time_accuracy. With unknown, lagna and house fields are left out and listed in warnings. Lagna and houses are never cast from a noon guess.

"date": "1990-08-13",
"time_accuracy": "unknown",
"place": { "place_id": "pl_2028" }

200OK, lagna and houses left out

"warnings": [ … ]

Historical timezones, worked out

timezone: auto reads the zone from the coordinates and the date, historical changes included. Or send an IANA name, or an offset like +05:30.

"timezone": "auto"

200OK

"timezone_used": {
  "name": "Asia/Kolkata",
  "utc_offset": "+05:30",
  "source": "auto"
}

Request bodies never stored
Request bodies are never written to our database or logs. Send birth details in the body, not the URL.
Versioned engine
Every response carries engine_version, and it changes whenever a calculation does.
Keys for the browser
al_pub_ keys call read-only operations without birth data, and only from your domains.
Compact view for AI
Set view to compact and responses drop labels and prose, which suits LLM callers.

Numbers you can check

Positions are compared with NASA JPL Horizons from 1900 to 2025, and the conventions behind them are one request away. How we measure

0.38″
Sun: median difference from NASA JPL Horizons, 1900–2025
0.92″
Moon: median difference over the same comparison
<11.4″
Median for every body measured, as of 1 November 2026

One arcminute, drawn to scale

Each small tick is one arcsecond.

A nakshatra pada is 3°20′, which is 12,000″: 200 of these rulers laid end to end.

The conventions, stated

Ayanamsa: Lahiri, or 4 others per request
KP ayanamsa: KP-New, Lahiri − 5′24″
Houses: Whole sign
Nodes: True node, or mean per request
Sunrise: Upper limb, refracted
Dates: 1900 to 2100

GET /v1/meta/conventions returns all of these, and needs no key.

How many credits will you need?

Enter the calls you expect a day. The sum runs in your browser.

Open the calculator

Operation	Credits a call	Calls a day
`POST /v1/kundli` Birth chart: lagna and the nine grahas	2
`GET /v1/panchang` Panchang for a date and place	1
`GET /v1/horoscope/{sign}` Horoscope for one sign	1
`POST /v1/match/ashtakoot` Ashtakoot Guna Milan (36 points)	1
`POST /v1/dasha/vimshottari` Vimshottari periods to 5 levels	2
`POST /v1/dosha/manglik` Manglik: graded, from lagna, Moon and Venus, cancellations named	1
`POST /v1/charts/{varga}.svg` Chart as SVG (North or South Indian)	2
`POST /v1/numerology/core` Life path, destiny, soul urge, personality (Chaldean)	1
`POST /v1/reports/kundli.pdf` A client-ready kundli as a PDF, under your name, logo and colour	10

Enter the calls you expect a day.

Every operation, on every plan

Plans differ in volume and rate limits; every plan includes every operation.

Free

₹0

a month

Get a free API key
- 3,000 credits a month
- 2 requests a second
- 2 requests at once
- Stops at the limit
Starter

₹999

+ GST, a month

Choose Starter
- 75,000 credits a month
- 5 requests a second
- 4 requests at once
- Then ₹16 per 1,000 credits
Growth

₹3,999

+ GST, a month

Choose Growth
- 4,00,000 credits a month
- 20 requests a second
- 8 requests at once
- Then ₹12 per 1,000 credits
Business

₹11,999

+ GST, a month

Choose Business
- 15,00,000 credits a month
- 50 requests a second
- 16 requests at once
- Then ₹9 per 1,000 credits

Every plan includes all 133 operations and 100 test calls a day. Of the 133 operations, 64 cost 1 credit, 52 cost 2, 10 cost 3, 1 costs 5, 3 cost 10 and 3 are free. Credits per operation. Only successful (2xx) calls are charged. INR prices exclude 18% GST. Paid plans are billed in rupees through Razorpay (UPI, cards, netbanking), with a GST tax invoice for every payment. For billing in USD, write to us.

See pricing details Ask about a custom plan

The Vedic astrology API, done right for India.

Live from the API, today

Your first call

What you can build

Not a developer?

Give your AI assistant real numbers

Drop a widget on any page

Build it your way

The API never guesses.

Vague places come back as a question

An unknown birth time stays unknown

Historical timezones, worked out

Numbers you can check

One arcminute, drawn to scale

The conventions, stated

How many credits will you need?

Every operation, on every plan

Free

Starter

Growth

Business