Avakhada Birth Details API

Avakhada birth details

POST/v1/kundli/birth-details

1 credit · Secret key (test or live) · getBirthDetails

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.

• 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

    The Rahu/Ketu the chart uses: the true (osculating) node, as Swiss Ephemeris and Drik Panchang define it, or the mean node. meta.node names the one used. POST /v1/planets/positions always returns both.

    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"

  • tone string

    descriptive: the prose fields (tithi.note, tara descriptions, the timing summary and insights, natal-transit descriptions, transit-event notes) carry reviewed descriptive sentences, attributed to the tradition and with no instructions, in options.lang. Ids, scores and every other value are unchanged. Applies to getPanchang, getFavourableDays, getPersonalTiming, getDashaTransitConfluence, getNatalTransits and listPlanetaryEvents (and those inside a bundle); elsewhere it changes nothing.

    one of default, descriptive · default "default"

  • dasha_year number

    Days in a Vimshottari year: 365.25 (Julian, the default), 365.2422 (tropical) or 360 (savana). Applies to /v1/dasha/vimshottari and /v1/dasha/vimshottari/current; data.basis.year_days names the one used.

    one of 365.25, 365.2422, 360 · default 365.25

  No other fields are accepted.

No other fields are accepted.

Response

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

• varna string
• vashya string
• yoni string
• gana string
• nadi string
• nakshatra string

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

Example request

curl -X POST 'https://api.astrologics.in/v1/kundli/birth-details' \
  -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/birth-details", {
  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/birth-details",
    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/birth-details');
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;

Example response

{
  "data": {
    "varna": "Kshatriya",
    "vashya": "Chatushpada",
    "yoni": "Elephant",
    "gana": "Manushya",
    "nadi": "Madhya (Pitta)",
    "nakshatra": "bharani"
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 1,
    "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 } } }

Send