/v1/chart/combustion

Combustion status for each planet.

What this tells you

A planet too close to the Sun is "combust" — its significations are weakened because it's "burned" by the Sun's rays. Each planet has its own classical threshold per Brihat Parashara Hora Shastra. Combustion is a major weakening factor separate from dignity.

Request

All requests require an Authorization header with your dv_live_* API key.

example request

curl "https://api.divyastroapi.com/v1/chart/combustion?date=2026-04-19&time=06%3A30&tz=%2B05%3A30&lat=28.61&lon=77.21" \
  -H "Authorization: Bearer dv_live_0123456789abcdef0123456789abcdef"

Response (200 OK)

Successful requests return a JSON body. Field names are stable across versions.

200 response

{
  "sun_longitude": 272.018,
  "planets": [
    { "name": "Moon",    "longitude":  53.772, "distance_from_sun": 141.754, "is_combust": false, "threshold_deg": 12.0 },
    { "name": "Mars",    "longitude": 213.214, "distance_from_sun":  58.804, "is_combust": false, "threshold_deg": 17.0 },
    { "name": "Mercury", "longitude": 264.183, "distance_from_sun":   7.835, "is_combust": true,  "threshold_deg": 14.0 },
    { "name": "Jupiter", "longitude": 112.908, "distance_from_sun": 159.110, "is_combust": false, "threshold_deg": 11.0 },
    { "name": "Venus",   "longitude": 243.619, "distance_from_sun":  28.399, "is_combust": false, "threshold_deg": 10.0 },
    { "name": "Saturn",  "longitude": 268.507, "distance_from_sun":   3.511, "is_combust": true,  "threshold_deg": 15.0 }
  ]
}

Field reference

Every field in the response, with its type, a real example, and what it means.

Field	Type	Meaning
sun_longitude	number	Sun's sidereal longitude at the moment. example: `272.018`
planets[].distance_from_sun	number (0–180)	Angular separation from Sun (always 0–180°). example: `7.835`
planets[].is_combust	boolean	Whether the planet is within its combustion threshold. example: `true`
planets[].threshold_deg	number	Classical threshold per BPHS: Moon 12°, Mars 17°, Mercury 14° (13° when retro), Jupiter 11°, Venus 10° (8° when retro), Saturn 15°. example: `14.0`

Usage tips

How to use it

Combined with dignity for strength
A planet that is both combust AND debilitated needs special remedies. Surface this combination prominently.
Mercury is combust often
Mercury is always within 28° of the Sun, so it's frequently combust (distance < 14°). Don't alarm users unnecessarily.

Errors

Every error follows the same envelope. Use the error.code field (not the message) for conditional logic in your integration.

401 Unauthorized

{
  "error": {
    "code": "unauthorized",
    "message": "missing or invalid API key",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

402 Payment Required

{
  "error": {
    "code": "trial_exhausted",
    "message": "your free trial credits are exhausted — pick a plan to continue",
    "top_up_url": "https://divyastroapi.com/pricing",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

429 Too Many Requests

{
  "error": {
    "code": "rate_limited",
    "message": "rate limit exceeded; retry after 12 seconds",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

Try it

Get a dv_live_* key from your dashboard and paste into the cURL snippet above. New accounts get 500 free credits. Sign up.