POST/api/astro/saptamsa/1 क्रेडिट

सप्तमांश (D7)

सप्तमांश, सातवीं वर्ग कुंडली: इसमें हर राशि सात भागों में बँटी होती है, हर भाग लगभग 4°17' का। संतान और वंश के लिए देखी जाती है। उत्तर का ढाँचा /api/astro/planet-positions/ जैसा ही फ़्लैट है: ग्रहों की सूची पारंपरिक क्रम में, हर ग्रह के साथ `name`, भोगांश, राशि, नक्षत्र, पद और भाव, और साथ में लग्न व लागू किया गया अयनांश। तारीख़ और स्थान भेजें; `ayanamsa` का डिफ़ॉल्ट LAHIRI है, और सभी 48 अयनांश स्वीकार हैं। कुंडली रूट से तय होती है, इसलिए बॉडी में भेजा गया `chart_name` अनदेखा कर दिया जाता है - यह एंडपॉइंट वही कुंडली लौटाता है जिसके नाम पर यह बना है, कोई और नहीं। बाकी 24 वर्गों के लिए /api/astro/chart/ इस्तेमाल करें।

https://api.occultapi.com/api/astro/saptamsa/

अनुरोध आज़माएँ

ऑथेंटिकेशन

अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

अनुरोध के फ़ील्ड

फ़ील्ड	टाइप	ज़रूरी	टिप्पणी
chart_name	string	ज़रूरी
datetime	string (date-time)	ज़रूरी	जिस क्षण की गणना करनी है, ISO 8601 फ़ॉर्मैट में। ऑफ़सेट या अंत में Z हमेशा लगाएँ - बिना ज़ोन वाली वैल्यू UTC नहीं, बल्कि Asia/Kolkata (UTC+05:30) मानी जाती है। इसका अर्थ date_time जैसा ही है; दूसरे एंडपॉइंट इसी चीज़ को दूसरे नाम से लेते हैं।
latitude	number (double)	ज़रूरी	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -89.9 · max 89.9
longitude	number (double)	ज़रूरी	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180
aberration	boolean	वैकल्पिक
apply_correction	boolean	वैकल्पिक
ascendant_pos	string	वैकल्पिक	`cuspstartend`
ayanamsa	string	वैकल्पिक
background_color	string	वैकल्पिक	SVG की पृष्ठभूमि का हेक्स रंग।
chart_style	string	वैकल्पिक	render='svg' होने पर चार्ट की शैली। 'north' हीरे के आकार वाला लेआउट है, जिसमें भाव अपनी जगह रहते हैं और राशियाँ घूमती हैं; 'south' ग्रिड वाला लेआउट है, जिसमें राशियाँ अपनी जगह रहती हैं और भाव घूमते हैं। `northsouth`
correction_deg	integer	वैकल्पिक	min 0
correction_direction	string	वैकल्पिक	`addsubtract`
correction_min	integer	वैकल्पिक	min 0 · max 59
correction_sec	integer	वैकल्पिक	min 0 · max 59
extended_bodies	array	वैकल्पिक	किन पिंड-समूहों को शामिल करना है: 'asteroids', 'planetary_moons', 'fictitious_bodies'।
label_style	string	वैकल्पिक	ग्रहों के लेबल किस रूप में हों: 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) या 'symbol' (☉, ☽, ...)। `englishsanskritsymbol`
line_color	string	वैकल्पिक	चार्ट की ग्रिड रेखाओं का हेक्स रंग।
notation	string	वैकल्पिक	`astrologicaldegree`
nutation	boolean	वैकल्पिक
planet_color	string	वैकल्पिक	ग्रहों के लेबल का हेक्स रंग, जैसे '#111827'। डिफ़ॉल्ट रूप से थीम का अपना रंग।
rahu	string	वैकल्पिक	कौन-सा पात शामिल करना है। 'true' देने पर केवल स्पष्ट पात, 'mean' पर केवल मध्यम पात, और 'both' पर दोनों मिलते हैं। `truemeanboth`
refraction	boolean	वैकल्पिक
render	string	वैकल्पिक	'svg' दें, तो साथ में रेंडर किया हुआ चार्ट डायग्राम (chart_style देखें) और उसकी ज्यामिति भी मिलती है। इसे न भेजें, तो उत्तर में कोई बदलाव नहीं होता। `nonesvg`
show_degrees	boolean	वैकल्पिक	हर पिंड के लेबल के पास, उसकी राशि में उसका अंश भी दिखाएँ।
sign_color	string	वैकल्पिक	राशि संख्याओं/संक्षिप्त नामों का हेक्स रंग।
svg_size	integer	वैकल्पिक	वर्गाकार SVG viewBox की चौड़ाई और ऊँचाई, पिक्सेल में। min 100 · max 2000
theme	string	वैकल्पिक	`lightdark`
true_mean	string	वैकल्पिक	`TrueMean`
use_28_nakshatras	boolean	वैकल्पिक

उदाहरण अनुरोध

curl -X POST https://api.occultapi.com/api/astro/saptamsa/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2026-09-01T06:00:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"ayanamsa":"LAHIRI"}'

उत्तर

{
  "data": {
    "planets": [
      {
        "name": "sun",
        "longitude": 220.66583333333335,
        "latitude": 0,
        "nakshatra": "Anooraadha",
        "pada": 3,
        "kakshya": "mars",
        "zodiac_name": "Scorpio",
        "house": 2
      },
      {
        "name": "moon",
        "longitude": 10.344444444444443,
        "latitude": 4.37,
        "nakshatra": "Ashwini",
        "pada": 4,
        "kakshya": "mars",
        "zodiac_name": "Aries",
        "house": 7
      },
      {
        "name": "mars",
        "longitude": 194.22305555555556,
        "latitude": 0.535,
        "nakshatra": "Swaati",
        "pada": 3,
        "kakshya": "sun",
        "zodiac_name": "Libra",
        "house": 1
      },
      {
        "name": "mercury",
        "longitude": 249.55444444444444,
        "latitude": 1.574,
        "nakshatra": "Moola",
        "pada": 3,
        "kakshya": "mars",
        "zodiac_name": "Sagittarius",
        "house": 3
      },
      {
        "name": "jupiter",
        "longitude": 46.30361111111111,
        "latitude": 0.529,
        "nakshatra": "Rohini",
        "pada": 2,
        "kakshya": "venus",
        "zodiac_name": "Taurus",
        "house": 8
      },
      {
        "name": "venus",
        "longitude": 172.69083333333333,
        "latitude": -3.391,
        "nakshatra": "Hasta",
        "pada": 4,
        "kakshya": "moon",
        "zodiac_name": "Virgo",
        "house": 12
      },
      {
        "name": "saturn",
        "longitude": 286.1286111111111,
        "latitude": -2.651,
        "nakshatra": "Sravanam",
        "pada": 2,
        "kakshya": "venus",
        "zodiac_name": "Capricorn",
        "house": 4
      },
      {
        "name": "northtruenode",
        "longitude": 338.9608333333333,
        "latitude": 0,
        "nakshatra": "Uttaraabhaadra",
        "pada": 2,
        "kakshya": "mars",
        "zodiac_name": "Pisces",
        "house": 6
      },
      {
        "name": "southtruenode",
        "longitude": 158.96083333333334,
        "latitude": 0,
        "nakshatra": "Uttara Phalguni",
        "pada": 4,
        "kakshya": "mars",
        "zodiac_name": "Virgo",
        "house": 12
      },
      {
        "name": "uranus",
        "longitude": 289.96722222222223,
        "latitude": -0.154,
        "nakshatra": "Sravanam",
        "pada": 3,
        "kakshya": "Mercury",
        "zodiac_name": "Capricorn",
        "house": 4
      },
      {
        "name": "neptune",
        "longitude": 216.02944444444444,
        "latitude": -1.412,
        "nakshatra": "Anooraadha",
        "pada": 1,
        "kakshya": "jupiter",
        "zodiac_name": "Scorpio",
        "house": 2
      },
      {
        "name": "pluto",
        "longitude": 154.95222222222225,
        "latitude": -4.3,
        "nakshatra": "Uttara Phalguni",
        "pada": 3,
        "kakshya": "jupiter",
        "zodiac_name": "Virgo",
        "house": 12
      }
    ],
    "ascendant": {
      "longitude": 205.3144444444445,
      "zodiac_name": "Libra",
      "nakshatra": "Makha",
      "pada": 4
    },
    "ayanamsa": {
      "name": "LAHIRI",
      "corrected": false,
      "value_degrees": 24.229599,
      "formatted": "24°13'47\""
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।

त्रुटियाँ

कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।