Combust

Endpoint POST https://starsapi.com/api/v3/transit/vedic/combust

Returns combustion windows — periods when a planet is too close to the Sun and considered “burnt” (asta). Each entry shows the start/end of the combustion period, the sign at each boundary, and the date of closest approach with the minimum angular distance.

Sun is never combust (it’s the combustor). Rahu and Ketu are shadowy nodes and have no combustion. Moon combustion (Amavasya proximity) is included optionally via include_moon.

Authentication

Required. See basic → Authentication.

Request body

Field	Type	Required	Description
`query_type`	string	No	`current` (default), `date`, `range`, `month`, `year`.
`timezone`	string	No	IANA timezone. Default `UTC`.
`planet`	string	No	Planet filter or `all`. Sun is never combust.
`date`	string	*	Required for `date` query type.
`from_date`, `to_date`	string	*	Required for `range`.
`month`, `year`	integer	*	Required for `month`/`year`.
`include_moon`	boolean	No	Include Moon combustion. Auto-managed by default.

Response shape

Field	Type	Description
`planet`	string	Planet name.
`start_date`, `start_time`	string	Combustion begins.
`end_date`, `end_time`	string	Combustion ends.
`duration_days`	number	Total days combust.
`sign_at_start`	string	Sign when combustion begins.
`sign_at_end`	string	Sign when combustion ends.
`closest_date`	string	Date of minimum Sun distance.
`closest_distance_deg`	number	Minimum angular distance from Sun (degrees).

Classical combustion orbs

The classical orb distances used:

Planet	Orb (degrees)
Moon	12°
Mars	17°
Mercury	14°
Jupiter	11°
Venus	10°
Saturn	15°

Use cases

Combustion alerts — warn users when a benefic like Venus or Jupiter is combust.
Muhurta avoidance — avoid starting ventures when the ruling planet is combust.
Transit reports — annotate transit timelines with combustion periods.

Errors

Same error set as nakshatra.

# Replace YOUR_API_KEY with the key from your dashboard
curl -X POST "https://starsapi.com/api/v3/transit/vedic/combust" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "query_type": "month",
        "month": 6,
        "year": 2026,
        "timezone": "Asia/Kolkata"
    }'

const response = await fetch(
  'https://starsapi.com/api/v3/transit/vedic/combust',
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      query_type: 'month',
      month: 6,
      year: 2026,
      timezone: 'Asia/Kolkata'
    })
  }
);
const result = await response.json();

if (result.success) {
  console.log(result.data);
}

import requests
import os

response = requests.post(
    'https://starsapi.com/api/v3/transit/vedic/combust',
    headers={'X-Api-Key': os.environ['STARSAPI_KEY']},
    json={
        'query_type': 'month',
        'month': 6,
        'year': 2026,
        'timezone': 'Asia/Kolkata'
    }
)
result = response.json()

if result['success']:
    print(result['data'])

<?php
$payload = [
    'query_type' => 'month',
    'month' => 6,
    'year' => 2026,
    'timezone' => 'Asia/Kolkata',
];

$ch = curl_init('https://starsapi.com/api/v3/transit/vedic/combust');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-Api-Key: ' . getenv('STARSAPI_KEY'),
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

if ($data['success']) {
    print_r($data['data']);
}

import 'package:http/http.dart' as http;
import 'dart:convert';

Future<Map<String, dynamic>> getAscendant() async {
  final response = await http.post(
    Uri.parse('https://starsapi.com/api/v3/transit/vedic/combust'),
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: jsonEncode({
      'query_type': 'month',
      'month': 6,
      'year': 2026,
      'timezone': 'Asia/Kolkata',
    }),
  );
  return jsonDecode(response.body);
}

import Foundation

func getAscendant() async throws -> [String: Any] {
    var request = URLRequest(url: URL(string:
        "https://starsapi.com/api/v3/transit/vedic/combust"
    )!)
    request.httpMethod = "POST"
    request.setValue("YOUR_API_KEY", forHTTPHeaderField: "X-Api-Key")
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    request.httpBody = """
        {
            "query_type": "month",
            "month": 6,
            "year": 2026,
            "timezone": "Asia/Kolkata"
        }
        """.data(using: .utf8)

    let (data, _) = try await URLSession.shared.data(for: request)
    return try JSONSerialization.jsonObject(with: data) as! [String: Any]
}

import okhttp3.*
import org.json.JSONObject

val client = OkHttpClient()
val JSON = "application/json; charset=utf-8".toMediaType()

fun getAscendant(callback: (JSONObject) -> Unit) {
    val payload = """
    {
        "query_type": "month",
        "month": 6,
        "year": 2026,
        "timezone": "Asia/Kolkata"
    }
    """.trimIndent()

    val request = Request.Builder()
        .url("https://starsapi.com/api/v3/transit/vedic/combust")
        .addHeader("X-Api-Key", "YOUR_API_KEY")
        .post(payload.toRequestBody(JSON))
        .build()

    client.newCall(request).enqueue(object : Callback {
        override fun onResponse(call: Call, response: Response) {
            callback(JSONObject(response.body!!.string()))
        }
        override fun onFailure(call: Call, e: java.io.IOException) {
            e.printStackTrace()
        }
    })
}

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

func main() {
    payload, _ := json.Marshal(map[string]interface{}{
        "query_type": "month",
        "month": 6,
        "year": 2026,
        "timezone": "Asia/Kolkata",
    })

    req, _ := http.NewRequest("POST",
        "https://starsapi.com/api/v3/transit/vedic/combust",
        bytes.NewBuffer(payload))
    req.Header.Set("X-Api-Key", os.Getenv("STARSAPI_KEY"))
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result["data"])
}

require 'net/http'
require 'json'

uri = URI('https://starsapi.com/api/v3/transit/vedic/combust')
payload = {
  'query_type' => 'month',
  'month' => 6,
  'year' => 2026,
  'timezone' => 'Asia/Kolkata'
}

req = Net::HTTP::Post.new(uri)
req['X-Api-Key'] = ENV['STARSAPI_KEY']
req['Content-Type'] = 'application/json'
req.body = payload.to_json

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
res = http.request(req)

data = JSON.parse(res.body)
puts data['data'] if data['success']

200 RESPONSE

{
  "status": 200,
  "success": true,
  "data": {
    "query_type": "month",
    "month": 6,
    "year": 2026,
    "timezone": "Asia/Kolkata",
    "zodiac": "sidereal",
    "planet": "all",
    "transits": [
      {
        "planet": "Venus",
        "start_date": "2026-06-02",
        "start_time": "11:14:00",
        "end_date": "2026-06-28",
        "end_time": "07:33:00",
        "duration_days": 25.85,
        "sign_at_start": "Taurus",
        "sign_at_end": "Gemini",
        "closest_date": "2026-06-14",
        "closest_distance_deg": 0.42
      }
    ],
    "count": 3
  },
  "meta": {
    "endpoint": "/api/v3/transit/vedic/combust",
    "version": "3.0"
  }
}