Planet Combustion (Asta and Uday) API

Asta and Uday: when each planet sets and rises near the Sun, for a place

POST/v1/planets/asta

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

A daily test in time-degrees at sunrise and sunset. Published panchangs use their own models, so dates can differ by days: see Vedic additions in the docs.

Request body

from string (date) required
e.g. "1990-08-13"
to string (date) required
At most 366 days after from.
e.g. "1990-08-13"
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.
planets array of string

No other fields are accepted.

Response

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

from string (date) required
e.g. "1990-08-13"
to string (date) required
e.g. "1990-08-13"
periods array of object required
- planet string required
- asta string (date-time) required
- uday string (date-time) required
- days number required
- sets_in string required
  one of morning, evening
- rises_in string required
  one of morning, evening
- degrees_at_asta number required
source object required
- text string required
- basis string required
  one of convention

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

Example request

curl -X POST 'https://api.astrologics.in/v1/planets/asta' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"from":"2026-07-01","to":"2026-08-20","place":{"latitude":28.6139,"longitude":77.209},"planets":["jupiter"]}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/planets/asta", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "from": "2026-07-01",
    "to": "2026-08-20",
    "place": {
      "latitude": 28.6139,
      "longitude": 77.209
    },
    "planets": [
      "jupiter"
    ]
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "from": "2026-07-01",
    "to": "2026-08-20",
    "place": {
        "latitude": 28.6139,
        "longitude": 77.209,
    },
    "planets": [
        "jupiter",
    ],
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/planets/asta",
    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/planets/asta');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"from":"2026-07-01","to":"2026-08-20","place":{"latitude":28.6139,"longitude":77.209},"planets":["jupiter"]}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 798 characters

{
  "data": {
    "from": "2026-07-01",
    "to": "2026-08-20",
    "periods": [
      {
        "planet": "jupiter",
        "asta": "2026-07-13T13:51:27.411Z",
        "uday": "2026-08-12T00:18:41.021Z",
        "days": 29.4,
        "sets_in": "evening",
        "rises_in": "morning",
        "degrees_at_asta": 11
      }
    ],
    "source": {
      "text": "When the planet stops and starts rising or setting far enough from the Sun, in time-degrees, tested at sunrise and sunset. Published panchangs use their own models and can differ by days. Not a forecast of a sighting.",
      "basis": "convention"
    }
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 2
  },
  "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)

{
  "from": "2026-07-01",
  "to": "2026-08-20",
  "place": {
    "latitude": 28.6139,
    "longitude": 77.209
  },
  "planets": [
    "jupiter"
  ]
}

Planet Combustion (Asta and Uday) API

Request body

Response

Example request

Example response

More in Kundli