@roxyapi/sdk 1.2.55 → 1.2.57

package/dist/types.gen.d.ts

@@ -432,10 +432,25 @@ export type HousesResponse = {
      */
     comparison?: {
         [key: string]: {
+            /**
+             * All 12 house cusps as this system computes them. Compare the same house number across the four keys to see how far the systems disagree, which is largest at high latitudes and for the intermediate cusps.
+             */
             houses: Array<{
+                /**
+                 * House number (1-12). Each house governs specific life areas.
+                 */
                 number: number;
+                /**
+                 * Ecliptic longitude of this house cusp in degrees (0-360), as this house system places it.
+                 */
                 longitude: number;
+                /**
+                 * Zodiac sign on this house cusp in this house system.
+                 */
                 sign: string;
+                /**
+                 * Degree within the zodiac sign on this cusp (0-29.999).
+                 */
                 degree: number;
             }>;
         };
@@ -809,7 +824,7 @@ export type TransitsResponse = {
              */
             summary: string;
             /**
-             * How long this transit influence lasts based on the transiting planet speed.
+             * How long this transit influence lasts, localized. The bucket follows the speed of the transiting body: a few hours for the Moon, a few days for the Sun, Mercury, Venus and Mars, one to two weeks for Jupiter, several weeks for Saturn, and an extended period for Uranus, Neptune and Pluto.
              */
             timing: string;
             /**
@@ -873,7 +888,13 @@ export type TransitsRequest = {
          * Time in 24-hour format. Seconds are optional and default to 00 (14:30 becomes 14:30:00); a single-digit hour is zero-padded. Out-of-range values are rejected.
          */
         time: string;
+        /**
+         * Natal birth latitude in decimal degrees, positive north. Sets the local sidereal time behind the natal Ascendant and house cusps that the transits are measured against.
+         */
         latitude: number;
+        /**
+         * Natal birth longitude in decimal degrees, positive east and negative west. Example: New York -74.0060, London -0.1276, Sydney 151.2093.
+         */
         longitude: number;
         /**
          * Natal timezone: decimal hours OR IANA name (e.g. "America/New_York"). IANA resolved to the DST-correct offset for the natal date.
@@ -973,7 +994,7 @@ export type AstrocartographyResponse = {
             /**
              * Absolute latitude in degrees beyond which the body never crosses the horizon, so the line has no points past it. Null when the line spans the full sampled range.
              */
-            circumpolarBeyond: number;
+            circumpolarBeyond: number | null;
             /**
              * Plain language meaning of this rising or setting planetary line for relocation, suitable for chart reports and AI agents.
              */
@@ -999,7 +1020,7 @@ export type AstrocartographyResponse = {
             /**
              * Absolute latitude in degrees beyond which the body never crosses the horizon, so the line has no points past it. Null when the line spans the full sampled range.
              */
-            circumpolarBeyond: number;
+            circumpolarBeyond: number | null;
             /**
              * Plain language meaning of this rising or setting planetary line for relocation, suitable for chart reports and AI agents.
              */
@@ -2092,7 +2113,7 @@ export type ProfectionsRequest = {
 export type BirthChartResponse = {
     aries: {
         /**
-         * Zodiac sign name in lowercase.
+         * Zodiac sign name in lowercase. Always equals the key of the block it sits in, so the aries block carries "aries" and the pisces block carries "pisces".
          */
         rashi: string;
         /**
@@ -2149,7 +2170,7 @@ export type BirthChartResponse = {
     };
     taurus: {
         /**
-         * Zodiac sign name in lowercase.
+         * Zodiac sign name in lowercase. Always equals the key of the block it sits in, so the aries block carries "aries" and the pisces block carries "pisces".
          */
         rashi: string;
         /**
@@ -2206,7 +2227,7 @@ export type BirthChartResponse = {
     };
     gemini: {
         /**
-         * Zodiac sign name in lowercase.
+         * Zodiac sign name in lowercase. Always equals the key of the block it sits in, so the aries block carries "aries" and the pisces block carries "pisces".
          */
         rashi: string;
         /**
@@ -2263,7 +2284,7 @@ export type BirthChartResponse = {
     };
     cancer: {
         /**
-         * Zodiac sign name in lowercase.
+         * Zodiac sign name in lowercase. Always equals the key of the block it sits in, so the aries block carries "aries" and the pisces block carries "pisces".
          */
         rashi: string;
         /**
@@ -2320,7 +2341,7 @@ export type BirthChartResponse = {
     };
     leo: {
         /**
-         * Zodiac sign name in lowercase.
+         * Zodiac sign name in lowercase. Always equals the key of the block it sits in, so the aries block carries "aries" and the pisces block carries "pisces".
          */
         rashi: string;
         /**
@@ -2377,7 +2398,7 @@ export type BirthChartResponse = {
     };
     virgo: {
         /**
-         * Zodiac sign name in lowercase.
+         * Zodiac sign name in lowercase. Always equals the key of the block it sits in, so the aries block carries "aries" and the pisces block carries "pisces".
          */
         rashi: string;
         /**
@@ -2434,7 +2455,7 @@ export type BirthChartResponse = {
     };
     libra: {
         /**
-         * Zodiac sign name in lowercase.
+         * Zodiac sign name in lowercase. Always equals the key of the block it sits in, so the aries block carries "aries" and the pisces block carries "pisces".
          */
         rashi: string;
         /**
@@ -2491,7 +2512,7 @@ export type BirthChartResponse = {
     };
     scorpio: {
         /**
-         * Zodiac sign name in lowercase.
+         * Zodiac sign name in lowercase. Always equals the key of the block it sits in, so the aries block carries "aries" and the pisces block carries "pisces".
          */
         rashi: string;
         /**
@@ -2548,7 +2569,7 @@ export type BirthChartResponse = {
     };
     sagittarius: {
         /**
-         * Zodiac sign name in lowercase.
+         * Zodiac sign name in lowercase. Always equals the key of the block it sits in, so the aries block carries "aries" and the pisces block carries "pisces".
          */
         rashi: string;
         /**
@@ -2605,7 +2626,7 @@ export type BirthChartResponse = {
     };
     capricorn: {
         /**
-         * Zodiac sign name in lowercase.
+         * Zodiac sign name in lowercase. Always equals the key of the block it sits in, so the aries block carries "aries" and the pisces block carries "pisces".
          */
         rashi: string;
         /**
@@ -2662,7 +2683,7 @@ export type BirthChartResponse = {
     };
     aquarius: {
         /**
-         * Zodiac sign name in lowercase.
+         * Zodiac sign name in lowercase. Always equals the key of the block it sits in, so the aries block carries "aries" and the pisces block carries "pisces".
          */
         rashi: string;
         /**
@@ -2719,7 +2740,7 @@ export type BirthChartResponse = {
     };
     pisces: {
         /**
-         * Zodiac sign name in lowercase.
+         * Zodiac sign name in lowercase. Always equals the key of the block it sits in, so the aries block carries "aries" and the pisces block carries "pisces".
          */
         rashi: string;
         /**
@@ -2774,6 +2795,69 @@ export type BirthChartResponse = {
             deeptadi?: 'Dipta' | 'Svastha' | 'Pramudita' | 'Shanta' | 'Dina' | 'Duhkhita' | 'Vikala' | 'Khala' | 'Kopa';
         }>;
     };
+    /**
+     * The sidereal frame this response was computed in, so a cached or forwarded payload is self describing.
+     */
+    frame: {
+        /**
+         * Sidereal frame this chart was cast in, echoing the ayanamsa request field. "lahiri" when the field was omitted.
+         */
+        ayanamsa: string;
+        /**
+         * Degrees actually subtracted from every tropical longitude to produce this chart, read at the birth instant. Subtract it back to recover the tropical positions, or compare it against your reference software to confirm you are in the same frame before chasing a placement difference.
+         */
+        ayanamsaDegrees: number;
+    };
+    /**
+     * Uranus, Neptune and Pluto, present only when modernPlanets true was sent. Deliberately separate from meta and deliberately without dignity, avastha, combustion or aspect fields: those are constructs of the nine-graha system and the modern planets rule no sign, so no classical value exists for them. Order is always Uranus, Neptune, Pluto.
+     */
+    modernPlanets?: Array<{
+        /**
+         * Modern planet name. These three are outside the classical Navagraha and are returned only when modernPlanets true is sent.
+         */
+        planet: 'Uranus' | 'Neptune' | 'Pluto';
+        /**
+         * Sanskrit name Indian software prints for this body: Arun for Uranus, Varun for Neptune, Yam for Pluto. Transliterated rather than translated, the same treatment as rashi and nakshatra lord names, so it is identical in every locale.
+         */
+        sanskritName: 'Arun' | 'Varun' | 'Yam';
+        /**
+         * Sidereal longitude in degrees (0-360), in the same ayanamsa frame as every other position in this response.
+         */
+        longitude: number;
+        /**
+         * Zodiac sign (rashi) the body occupies.
+         */
+        rashi: string;
+        /**
+         * Degrees advanced into the sign, 0 to 30. This is the figure a chart displays beside the sign.
+         */
+        degreeInRashi: number;
+        /**
+         * Nakshatra placement. Reported because it is purely positional; it does not imply the body participates in Vimshottari dasha, which is built on the Moon alone.
+         */
+        nakshatra: {
+            /**
+             * Nakshatra (lunar mansion, 1 of 27) the body occupies.
+             */
+            name: string;
+            /**
+             * Nakshatra pada (quarter, 1-4).
+             */
+            pada: number;
+            /**
+             * Nakshatra index (1-27) starting from Ashwini.
+             */
+            key: number;
+            /**
+             * Vimshottari ruling planet of this nakshatra.
+             */
+            lord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
+        };
+        /**
+         * True when the body appears to move backward. All three are retrograde for roughly 40 percent of each year, so this is the normal case rather than the exception.
+         */
+        isRetrograde: boolean;
+    }>;
     /**
      * The twelve bhavas (houses) in order, each with its classical name and significations. Houses are counted whole-sign from the Lagna.
      */
@@ -3006,10 +3090,22 @@ export type BirthChartRequest = {
      * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC (e.g. -5 for EST, 1 for CET). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly. Defaults to 5.5.
      */
     timezone?: number | string;
+    /**
+     * Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
+     */
+    ayanamsaValue?: number;
     /**
      * Set true to include a localized meaning and one-sentence classical interpretation beside each graha avastha state, under avasthaInfo on that graha in meta. Defaults to false, so an existing integration is byte-identical until it opts in. Saves a second call to GET /avasthas and the client-side join that would otherwise be needed to turn Yuva or Swapna into readable text.
      */
     avasthaInfo?: boolean;
+    /**
+     * Set true to also return Uranus, Neptune and Pluto, under the Sanskrit names Arun, Varun and Yam that Indian software prints for them. They arrive in a separate modernPlanets array, NOT inside meta, because classical Jyotish is defined over nine grahas: the moderns rule no sign, so they have no dignity, avastha, combustion or aspect strength and it would be fabrication to report one. Each carries longitude, rashi, degree in sign, nakshatra with pada and lord, and retrograde status. Defaults to false, so an existing integration is byte-identical until it opts in.
+     */
+    modernPlanets?: boolean;
 };
 export type NavamsaResponse = {
     /**
@@ -3069,7 +3165,7 @@ export type NavamsaResponse = {
          */
         aries: {
             /**
-             * Zodiac sign name in lowercase.
+             * Zodiac sign name in lowercase. Always equals the key of the navamsa rashi-house block it sits in.
              */
             rashi: string;
             /**
@@ -3117,6 +3213,19 @@ export type NavamsaResponse = {
         };
         [key: string]: unknown;
     };
+    /**
+     * The sidereal frame this response was computed in, so a cached or forwarded payload is self describing.
+     */
+    frame: {
+        /**
+         * Sidereal frame this chart was cast in, echoing the ayanamsa request field. "lahiri" when the field was omitted.
+         */
+        ayanamsa: string;
+        /**
+         * Degrees actually subtracted from every tropical longitude to produce this chart, read at the birth instant. Subtract it back to recover the tropical positions, or compare it against your reference software to confirm you are in the same frame before chasing a placement difference.
+         */
+        ayanamsaDegrees: number;
+    };
     /**
      * Planets that are Vargottama (same sign in D1 and D9)
      */
@@ -3147,6 +3256,14 @@ export type NavamsaRequest = {
      * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC (e.g. -5 for EST, 1 for CET). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly. Defaults to 5.5.
      */
     timezone?: number | string;
+    /**
+     * Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
+     */
+    ayanamsaValue?: number;
 };
 export type DivisionalChartResponse = {
     /**
@@ -3174,6 +3291,19 @@ export type DivisionalChartResponse = {
          */
         significance: string;
     };
+    /**
+     * The sidereal frame this response was computed in, so a cached or forwarded payload is self describing.
+     */
+    frame: {
+        /**
+         * Sidereal frame this chart was cast in, echoing the ayanamsa request field. "lahiri" when the field was omitted.
+         */
+        ayanamsa: string;
+        /**
+         * Degrees actually subtracted from every tropical longitude to produce this chart, read at the birth instant. Subtract it back to recover the tropical positions, or compare it against your reference software to confirm you are in the same frame before chasing a placement difference.
+         */
+        ayanamsaDegrees: number;
+    };
     /**
      * Divisional chart showing planetary positions across 12 rashi houses plus a meta lookup. Same structure as birth chart and navamsa responses.
      */
@@ -3231,7 +3361,7 @@ export type DivisionalChartResponse = {
          */
         aries: {
             /**
-             * Zodiac sign name in lowercase.
+             * Zodiac sign name in lowercase. Always equals the key of the divisional rashi-house block it sits in.
              */
             rashi: string;
             /**
@@ -3305,12 +3435,33 @@ export type DivisionalChartRequest = {
      * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC (e.g. -5 for EST, 1 for CET). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly. Defaults to 5.5.
      */
     timezone?: number | string;
+    /**
+     * Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
+     */
+    ayanamsaValue?: number;
     /**
      * Divisional chart number. Each division reveals a specific life area. Supported: 2 (Hora, wealth), 3 (Drekkana, siblings), 4 (Chaturthamsa, property), 7 (Saptamsa, children), 9 (Navamsa, marriage), 10 (Dasamsa, career), 12 (Dwadasamsa, parents), 16 (Shodasamsa, vehicles), 20 (Vimsamsa, spirituality), 24 (Chaturvimsamsa, education), 27 (Bhamsa, strength), 30 (Trimsamsa, misfortunes), 40 (Khavedamsa, merit), 45 (Akshavedamsa, character), 60 (Shashtiamsa, past life karma).
      */
     division: number;
 };
 export type CompatibilityResponse = {
+    /**
+     * The sidereal frame this response was computed in, so a cached or forwarded payload is self describing.
+     */
+    frame: {
+        /**
+         * Sidereal frame this chart was cast in, echoing the ayanamsa request field. "lahiri" when the field was omitted.
+         */
+        ayanamsa: string;
+        /**
+         * Degrees actually subtracted from every tropical longitude to produce this chart, read at the birth instant. Subtract it back to recover the tropical positions, or compare it against your reference software to confirm you are in the same frame before chasing a placement difference.
+         */
+        ayanamsaDegrees: number;
+    };
     /**
      * Total Ashtakoot Gun Milan score out of 36. Scores above 18 are considered compatible for marriage. Higher scores indicate stronger marital harmony.
      */
@@ -3429,6 +3580,14 @@ export type CompatibilityRequest = {
          */
         timezone?: number | string;
     };
+    /**
+     * Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
+     */
+    ayanamsaValue?: number;
 };
 export type PlanetaryPositionsResponse = {
     [key: string]: {
@@ -3507,7 +3666,7 @@ export type PlanetaryPositionsResponse = {
          */
         isRetrograde: boolean;
         /**
-         * Whether the planet is combust (asta, moudhya). A planet is combust when too close to the Sun, weakening its significations. Combustion orbs vary by planet: Moon 12 deg, Mars 17 deg, Mercury 14 deg (12 deg if retrograde), Jupiter 11 deg, Venus 10 deg (8 deg if retrograde), Saturn 15 deg. Sun, Rahu, Ketu, and Lagna are never combust. Based on Surya Siddhanta combustion orbs.
+         * Whether the planet is combust (asta, moudhya). A planet is combust when too close to the Sun, weakening its significations. Limits per Surya Siddhanta: Moon 12 deg, Mars 17 deg, Mercury 14 deg (12 deg if retrograde), Jupiter 11 deg, Venus 10 deg (8 deg if retrograde), Saturn 15 deg. Compared against the difference in ecliptic longitude, which is the standard interpretive convention and matches what other Vedic software reports. It is a chart judgement and not a statement about naked-eye visibility, which additionally depends on the observer latitude: for that use the heliacal endpoint, which applies the same limits in the classical degrees of time. The field is omitted entirely for Sun, Rahu, Ketu and Lagna, since the question does not apply to them rather than the answer being no.
          */
         isCombust?: boolean;
         /**
@@ -3541,8 +3700,29 @@ export type PlanetaryPositionsRequest = {
      * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC (e.g. -5 for EST, 1 for CET). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly. Defaults to 5.5.
      */
     timezone?: number | string;
+    /**
+     * Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
+     */
+    ayanamsaValue?: number;
 };
 export type ManglikResponse = {
+    /**
+     * The sidereal frame this response was computed in, so a cached or forwarded payload is self describing.
+     */
+    frame: {
+        /**
+         * Sidereal frame this chart was cast in, echoing the ayanamsa request field. "lahiri" when the field was omitted.
+         */
+        ayanamsa: string;
+        /**
+         * Degrees actually subtracted from every tropical longitude to produce this chart, read at the birth instant. Subtract it back to recover the tropical positions, or compare it against your reference software to confirm you are in the same frame before chasing a placement difference.
+         */
+        ayanamsaDegrees: number;
+    };
     /**
      * Whether Manglik dosha (Kuja dosha) is present based on Mars placement from Lagna
      */
@@ -3606,8 +3786,29 @@ export type ManglikRequest = {
      * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC (e.g. -5 for EST, 1 for CET). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly. Defaults to 5.5.
      */
     timezone?: number | string;
+    /**
+     * Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
+     */
+    ayanamsaValue?: number;
 };
 export type KalsarpaResponse = {
+    /**
+     * The sidereal frame this response was computed in, so a cached or forwarded payload is self describing.
+     */
+    frame: {
+        /**
+         * Sidereal frame this chart was cast in, echoing the ayanamsa request field. "lahiri" when the field was omitted.
+         */
+        ayanamsa: string;
+        /**
+         * Degrees actually subtracted from every tropical longitude to produce this chart, read at the birth instant. Subtract it back to recover the tropical positions, or compare it against your reference software to confirm you are in the same frame before chasing a placement difference.
+         */
+        ayanamsaDegrees: number;
+    };
     /**
      * Whether Kalsarpa dosha (Kalsarpa yoga) is present, all planets hemmed between Rahu-Ketu axis
      */
@@ -3679,8 +3880,29 @@ export type KalsarpaRequest = {
      * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC (e.g. -5 for EST, 1 for CET). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly. Defaults to 5.5.
      */
     timezone?: number | string;
+    /**
+     * Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
+     */
+    ayanamsaValue?: number;
 };
 export type SadhesatiResponse = {
+    /**
+     * The sidereal frame this response was computed in, so a cached or forwarded payload is self describing.
+     */
+    frame: {
+        /**
+         * Sidereal frame this chart was cast in, echoing the ayanamsa request field. "lahiri" when the field was omitted.
+         */
+        ayanamsa: string;
+        /**
+         * Degrees actually subtracted from every tropical longitude to produce this chart, read at the birth instant. Subtract it back to recover the tropical positions, or compare it against your reference software to confirm you are in the same frame before chasing a placement difference.
+         */
+        ayanamsaDegrees: number;
+    };
     /**
      * Whether Sade Sati is currently active, Saturn transiting 12th, 1st, or 2nd house from natal Moon
      */
@@ -3738,6 +3960,14 @@ export type SadhesatiRequest = {
      * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC (e.g. -5 for EST, 1 for CET). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly. Defaults to 5.5.
      */
     timezone?: number | string;
+    /**
+     * Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
+     */
+    ayanamsaValue?: number;
 };
 export type YogaDetail = {
     /**
@@ -3807,6 +4037,19 @@ export type YogaDetectResponse = {
          */
         evidence?: string;
     }>;
+    /**
+     * The sidereal frame this response was computed in, so a cached or forwarded payload is self describing.
+     */
+    frame: {
+        /**
+         * Sidereal frame this chart was cast in, echoing the ayanamsa request field. "lahiri" when the field was omitted.
+         */
+        ayanamsa: string;
+        /**
+         * Degrees actually subtracted from every tropical longitude to produce this chart, read at the birth instant. Subtract it back to recover the tropical positions, or compare it against your reference software to confirm you are in the same frame before chasing a placement difference.
+         */
+        ayanamsaDegrees: number;
+    };
     /**
      * Count of yogas where present === true in this chart. Range 0-44, though real charts sit in the low single digits: the Nabhasa families are mutually constrained by the precedence norms, and most shape yogas are rare.
      */
@@ -3815,10 +4058,25 @@ export type YogaDetectResponse = {
      * Echo of the resolved birth data used for detection. Timezone is the numeric offset that the chart engine consumed (IANA names are resolved upstream).
      */
     birthDetails: {
+        /**
+         * Birth date the kundli was cast for, YYYY-MM-DD, echoed back from the request.
+         */
         date: string;
+        /**
+         * Birth time the kundli was cast for, 24-hour HH:MM:SS, echoed back from the request. Lagna moves roughly one rashi every two hours, so this is what pins the bhava-dependent yogas.
+         */
         time: string;
+        /**
+         * Birth latitude in decimal degrees, echoed back from the request. Feeds the local sidereal time behind the Lagna.
+         */
         latitude: number;
+        /**
+         * Birth longitude in decimal degrees, echoed back from the request. East is positive, west is negative.
+         */
         longitude: number;
+        /**
+         * Numeric UTC offset in decimal hours that the chart engine actually consumed. An IANA name sent on the request is resolved to its DST-correct offset upstream, so this is always a number.
+         */
         timezone: number;
     };
 };
@@ -3843,6 +4101,14 @@ export type YogaDetectRequest = {
      * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC (e.g. -5 for EST, 1 for CET). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly. Defaults to 5.5.
      */
     timezone?: number | string;
+    /**
+     * Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
+     */
+    ayanamsaValue?: number;
 };
 export type KpAyanamsaResponse = {
     /**
@@ -3952,9 +4218,9 @@ export type KpPlanetsRequest = {
      */
     timezone?: number | string;
     /**
-     * Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula (most common for KP). "kp-old" uses the Krishnamurti original table. "lahiri" uses Lahiri/Chitrapaksha ayanamsa matching most traditional Vedic software. "custom" allows providing your own value via ayanamsaValue. Defaults to "kp-newcomb".
+     * Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula (most common for KP). "kp-old" uses the Krishnamurti original table. "lahiri" uses Lahiri/Chitrapaksha ayanamsa matching most traditional Vedic software. "raman" uses the B.V. Raman ayanamsa, about 1.45 degrees below Lahiri. "custom" allows providing your own value via ayanamsaValue. Defaults to "kp-newcomb".
      */
-    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'custom';
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
     /**
      * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
      */
@@ -4052,9 +4318,9 @@ export type KpCuspsRequest = {
      */
     timezone?: number | string;
     /**
-     * Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula (most common for KP). "kp-old" uses the Krishnamurti original table. "lahiri" uses Lahiri/Chitrapaksha ayanamsa matching most traditional Vedic software. "custom" allows providing your own value via ayanamsaValue. Defaults to "kp-newcomb".
+     * Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula (most common for KP). "kp-old" uses the Krishnamurti original table. "lahiri" uses Lahiri/Chitrapaksha ayanamsa matching most traditional Vedic software. "raman" uses the B.V. Raman ayanamsa, about 1.45 degrees below Lahiri. "custom" allows providing your own value via ayanamsaValue. Defaults to "kp-newcomb".
      */
-    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'custom';
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
     /**
      * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
      */
@@ -4090,7 +4356,7 @@ export type KpChartResponse = {
          */
         ayanamsa: number;
         /**
-         * Ayanamsa system used (KP Newcomb).
+         * Ayanamsa system used, echoing the ayanamsa field of the request: "kp-newcomb", "kp-old", "lahiri", "raman" or "custom".
          */
         ayanamsaType: string;
         /**
@@ -4406,9 +4672,9 @@ export type KpChartRequest = {
      */
     timezone?: number | string;
     /**
-     * Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula (most common for KP). "kp-old" uses the Krishnamurti original table. "lahiri" uses Lahiri/Chitrapaksha ayanamsa matching most traditional Vedic software. "custom" allows providing your own value via ayanamsaValue. Defaults to "kp-newcomb".
+     * Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula (most common for KP). "kp-old" uses the Krishnamurti original table. "lahiri" uses Lahiri/Chitrapaksha ayanamsa matching most traditional Vedic software. "raman" uses the B.V. Raman ayanamsa, about 1.45 degrees below Lahiri. "custom" allows providing your own value via ayanamsaValue. Defaults to "kp-newcomb".
      */
-    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'custom';
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
     /**
      * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
      */
@@ -4427,8 +4693,17 @@ export type KpRulingPlanetsResponse = {
      * Observer location coordinates
      */
     location: {
+        /**
+         * Observer latitude in decimal degrees, echoed back from the request. Sets the local sidereal time behind the KP ascendant and therefore the Lagna sublord.
+         */
         latitude: number;
+        /**
+         * Observer longitude in decimal degrees, echoed back from the request. East is positive, west is negative.
+         */
         longitude: number;
+        /**
+         * Numeric UTC offset in decimal hours the calculation consumed. An IANA name sent on the request is resolved to its DST-correct offset upstream, so this is always a number.
+         */
         timezone: number;
     };
     /**
@@ -4771,9 +5046,9 @@ export type KpSublordChangesRequest = {
      */
     timezone?: number | string;
     /**
-     * Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. "kp-old" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. "lahiri" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. Defaults to "kp-newcomb".
+     * Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. "kp-old" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. "lahiri" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. "raman" uses the B.V. Raman ayanamsa from Hindu Predictive Astrology, a recognised traditional school that sits about 1.45 degrees below Lahiri. Defaults to "kp-newcomb".
      */
-    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri';
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman';
     /**
      * Lunar node type for Rahu and Ketu positions. "mean" uses the smooth mean node (traditional Vedic astrology default). "true" uses the osculating node with perturbation corrections, oscillating up to 1.5 degrees from mean with a 173-day period. Impacts KP sub-lord assignments in narrow boundary cases. Defaults to "mean".
      */
@@ -4848,9 +5123,9 @@ export type KpRasiChangesRequest = {
      */
     timezone?: number | string;
     /**
-     * Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. "kp-old" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. "lahiri" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. Defaults to "kp-newcomb".
+     * Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. "kp-old" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. "lahiri" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. "raman" uses the B.V. Raman ayanamsa from Hindu Predictive Astrology, a recognised traditional school that sits about 1.45 degrees below Lahiri. Defaults to "kp-newcomb".
      */
-    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri';
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman';
     /**
      * Lunar node type for Rahu and Ketu positions. "mean" uses the smooth mean node (traditional Vedic astrology default). "true" uses the osculating node with perturbation corrections, oscillating up to 1.5 degrees from mean with a 173-day period. Impacts KP sub-lord assignments in narrow boundary cases. Defaults to "mean".
      */
@@ -4972,9 +5247,291 @@ export type KpPlanetsIntervalRequest = {
      */
     timezone?: number | string;
     /**
-     * Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. "kp-old" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. "lahiri" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. Defaults to "kp-newcomb".
+     * Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. "kp-old" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. "lahiri" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. "raman" uses the B.V. Raman ayanamsa from Hindu Predictive Astrology, a recognised traditional school that sits about 1.45 degrees below Lahiri. Defaults to "kp-newcomb".
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman';
+    /**
+     * Lunar node type for Rahu and Ketu positions. "mean" uses the smooth mean node (traditional Vedic astrology default). "true" uses the osculating node with perturbation corrections, oscillating up to 1.5 degrees from mean with a 173-day period. Impacts KP sub-lord assignments in narrow boundary cases. Defaults to "mean".
+     */
+    nodeType?: 'mean' | 'true';
+};
+/**
+ * A complete KP horary (Prashna) chart: the Ascendant from the number, the cusps and planets from the moment of the question, plus ruling planets and four-level significators.
+ */
+export type KpHoraryResponse = {
+    /**
+     * The number that was asked for, echoed so a stored chart is self describing.
+     */
+    horaryNumber: number;
+    /**
+     * UTC instant the chart was cast for, resolved from the date, time and timezone.
+     */
+    questionTime: string;
+    /**
+     * Sidereal frame used, echoed back.
+     */
+    ayanamsaType: string;
+    /**
+     * Degrees subtracted from every tropical longitude to produce this chart. Compare it against your reference software before treating a placement difference as a disagreement.
+     */
+    ayanamsaDegrees: number;
+    /**
+     * The Ascendant the horary number produced. This is the ONLY part of the chart that comes from the number; everything else comes from the sky at the moment of the question.
+     */
+    ascendant: {
+        /**
+         * Sidereal longitude of the horary Ascendant, taken as the MIDPOINT of the sub division the number names.
+         */
+        longitude: number;
+        /**
+         * Degrees into the sign, 0 to 30, which is what a chart displays.
+         */
+        degreeInSign: number;
+        /**
+         * Zodiac sign (rashi) of this point.
+         */
+        sign: string;
+        /**
+         * Nakshatra (star) this point falls in.
+         */
+        star: string;
+        /**
+         * Nakshatra lord (star lord), the second level of the KP hierarchy.
+         */
+        starLord: string;
+        /**
+         * Sub lord, the decisive level in KP. A cusp sub lord is what answers the question: it is read for whether the matter is promised, before any timing is attempted.
+         */
+        subLord: string;
+        /**
+         * KP horary number 1 to 249 of the sub division holding this point. Matches the standard published KP table.
+         */
+        kpNumber: number;
+        /**
+         * Sidereal longitude where this numbered sub division begins.
+         */
+        spanFrom: number;
+        /**
+         * Sidereal longitude where it ends. The Ascendant sits midway between this and spanFrom.
+         */
+        spanTo: number;
+    };
+    /**
+     * Twelve Placidus cusps, house 1 first. House 1 is the horary Ascendant; the other eleven follow from the house frame that Ascendant implies at this latitude.
+     */
+    cusps: Array<{
+        /**
+         * House (bhava) number 1 to 12.
+         */
+        house: number;
+        /**
+         * Sidereal longitude of the cusp.
+         */
+        longitude: number;
+        /**
+         * Zodiac sign (rashi) of this point.
+         */
+        sign: string;
+        /**
+         * Nakshatra (star) this point falls in.
+         */
+        star: string;
+        /**
+         * Nakshatra lord (star lord), the second level of the KP hierarchy.
+         */
+        starLord: string;
+        /**
+         * Sub lord, the decisive level in KP. A cusp sub lord is what answers the question: it is read for whether the matter is promised, before any timing is attempted.
+         */
+        subLord: string;
+        /**
+         * KP horary number 1 to 249 of the sub division holding this point. Matches the standard published KP table.
+         */
+        kpNumber: number;
+    }>;
+    /**
+     * The nine grahas at the moment of the question, placed against the horary cusps. These come from the real sky, not from the number.
+     */
+    planets: Array<{
+        /**
+         * Graha name.
+         */
+        planet: string;
+        /**
+         * Sidereal longitude at the moment of the question.
+         */
+        longitude: number;
+        /**
+         * Placidus house the graha occupies in this horary chart, counted against the cusps above rather than by whole sign.
+         */
+        house: number;
+        /**
+         * Retrograde motion flag.
+         */
+        isRetrograde: boolean;
+        /**
+         * Sub-sub lord, the fourth KP level, used to refine timing.
+         */
+        subSubLord: string;
+        /**
+         * Zodiac sign (rashi) of this point.
+         */
+        sign: string;
+        /**
+         * Nakshatra (star) this point falls in.
+         */
+        star: string;
+        /**
+         * Nakshatra lord (star lord), the second level of the KP hierarchy.
+         */
+        starLord: string;
+        /**
+         * Sub lord, the decisive level in KP. A cusp sub lord is what answers the question: it is read for whether the matter is promised, before any timing is attempted.
+         */
+        subLord: string;
+        /**
+         * KP horary number 1 to 249 of the sub division holding this point. Matches the standard published KP table.
+         */
+        kpNumber: number;
+    }>;
+    /**
+     * Ruling planets at the moment of the question. NOTE the lagna values here are from the TIME-based ascendant, which is the classical ruling-planet definition, not from the horary number.
+     */
+    rulingPlanets: {
+        /**
+         * Lord of the Hindu weekday, counted from sunrise.
+         */
+        dayLord: string;
+        /**
+         * Sign lord of the Moon.
+         */
+        moonSignLord: string;
+        /**
+         * Star lord of the Moon.
+         */
+        moonStarLord: string;
+        /**
+         * Sub lord of the Moon.
+         */
+        moonSublord: string;
+        /**
+         * Sub-sub lord of the Moon.
+         */
+        moonSubSublord: string;
+        /**
+         * Sign lord of the ascendant at the question moment.
+         */
+        lagnaSignLord: string;
+        /**
+         * Star lord of that ascendant.
+         */
+        lagnaStarLord: string;
+        /**
+         * Sub lord of that ascendant.
+         */
+        lagnaSublord: string;
+        /**
+         * Sub-sub lord of that ascendant.
+         */
+        lagnaSubSublord: string;
+        /**
+         * The distinct ruling planets in KP order of strength. They validate the chart: when they repeat the significators of the houses the question needs, the judgment is considered reliable.
+         */
+        rulingPlanets: Array<string>;
+    };
+    /**
+     * KP significators for event prediction and timing. Shows which planets signify each house (house-wise) and which houses each planet signifies (planet-wise). Strength order: Level 1 (planets in star of occupant) > Level 2 (occupants) > Level 3 (planets in star of owner) > Level 4 (house owner).
+     */
+    significators: {
+        houseWise: Array<{
+            /**
+             * House number 1-12
+             */
+            house: number;
+            significators: Array<{
+                /**
+                 * KP significator strength level (1-4). L1: planets in star of occupant (strongest). L2: occupant itself. L3: planets in star of owner. L4: sign owner. Lower number = stronger signification for this house.
+                 */
+                level: number;
+                /**
+                 * Human-readable label for this KP significator level.
+                 */
+                description: string;
+                /**
+                 * Planets signifying this house at this strength level.
+                 */
+                planets: Array<string>;
+            }>;
+            /**
+             * All significators in order of strength
+             */
+            all: Array<string>;
+        }>;
+        planetWise: Array<{
+            /**
+             * Vedic graha (planet) being analyzed for its house significations.
+             */
+            planet: string;
+            signifies: Array<{
+                /**
+                 * KP significator strength level (1-4). L1 strongest, L4 weakest.
+                 */
+                level: number;
+                /**
+                 * House numbers this planet signifies at this strength level.
+                 */
+                houses: Array<number>;
+            }>;
+            /**
+             * All houses signified in order of strength
+             */
+            allHouses: Array<number>;
+        }>;
+    };
+    /**
+     * Significations of each of the twelve bhavas (houses), keyed by house number 1 to 12, as short keywords. Bhava 1 is the Lagna (self, body, vitality), 2 wealth and speech, 4 home and mother, 7 marriage and partnership, 10 career and status, 11 gains. Use it to label the house numbers returned elsewhere in the response: a Vimshottari dasha period signifying houses 2, 7 and 8, or a KP significator carrying houses 11 and 6, becomes readable text without a separate lookup call. Returned once per response rather than repeated per period, and localized by the lang query parameter alongside every other interpretation field.
+     */
+    houseThemes: {
+        [key: string]: Array<string>;
+    };
+    /**
+     * Which signification vocabulary produced the houseThemes keywords in this response, echoing the focus query parameter. Always present, and "general" when the parameter was omitted. Read it to label a rendered house legend, or to tell two cached responses apart when only one asked for the finance lens.
+     */
+    focus: 'general' | 'finance';
+};
+export type KpHoraryRequest = {
+    /**
+     * Horary number from 1 to 249, given by the querent while focused on their question. It maps to one of the 249 KP sub divisions of the zodiac, and that division sets the Ascendant of the chart. The querent should give the first number that comes to mind and use it once for that question; the astrologer never chooses it. Numbers outside 1 to 249 are rejected rather than wrapped, because a wrapped number would silently answer a different question.
+     */
+    horaryNumber: number;
+    /**
+     * Date the question was taken up for judgment, YYYY-MM-DD. Not a birth date: a horary chart needs no birth details at all, which is the point of the method.
+     */
+    date: string;
+    /**
+     * Time the question was taken up for judgment, 24-hour HH:MM:SS. In KP practice this is the moment the astrologer receives and understands the question, not the moment the querent first thought of it. It sets every planetary position and all twelve cusps except the Ascendant.
+     */
+    time: string;
+    /**
+     * Latitude where the question is judged, decimal degrees. The house cusps are Placidus and therefore latitude dependent, so this is the place of judgment, not the querent birthplace.
+     */
+    latitude: number;
+    /**
+     * Longitude where the question is judged, decimal degrees.
+     */
+    longitude: number;
+    /**
+     * Timezone: IANA name (e.g. "Asia/Kolkata") OR decimal hours from UTC. Defaults to 5.5.
+     */
+    timezone?: number | string;
+    /**
+     * Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula (most common for KP). "kp-old" uses the Krishnamurti original table. "lahiri" uses Lahiri/Chitrapaksha ayanamsa matching most traditional Vedic software. "raman" uses the B.V. Raman ayanamsa, about 1.45 degrees below Lahiri. "custom" allows providing your own value via ayanamsaValue. Defaults to "kp-newcomb".
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
      */
-    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri';
+    ayanamsaValue?: number;
     /**
      * Lunar node type for Rahu and Ketu positions. "mean" uses the smooth mean node (traditional Vedic astrology default). "true" uses the osculating node with perturbation corrections, oscillating up to 1.5 degrees from mean with a 173-day period. Impacts KP sub-lord assignments in narrow boundary cases. Defaults to "mean".
      */
@@ -5146,6 +5703,19 @@ export type NakshatraResponse = {
  * Complete upagraha positions for a birth chart
  */
 export type UpagrahaResponse = {
+    /**
+     * The sidereal frame this response was computed in, so a cached or forwarded payload is self describing.
+     */
+    frame: {
+        /**
+         * Sidereal frame this chart was cast in, echoing the ayanamsa request field. "lahiri" when the field was omitted.
+         */
+        ayanamsa: string;
+        /**
+         * Degrees actually subtracted from every tropical longitude to produce this chart, read at the birth instant. Subtract it back to recover the tropical positions, or compare it against your reference software to confirm you are in the same frame before chasing a placement difference.
+         */
+        ayanamsaDegrees: number;
+    };
     /**
      * Time-based upagrahas derived from the 8-part division of day or night. Gulika and Mandi are from Saturn segment, others from Sun, Mars, Mercury, Jupiter segments. Positions depend on birth time, location, and weekday.
      */
@@ -5234,11 +5804,32 @@ export type UpagrahaRequest = {
      * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC (e.g. -5 for EST, 1 for CET). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly. Defaults to 5.5.
      */
     timezone?: number | string;
+    /**
+     * Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
+     */
+    ayanamsaValue?: number;
 };
 /**
  * Complete Ashtakavarga analysis for a birth chart
  */
 export type AshtakavargaResponse = {
+    /**
+     * The sidereal frame this response was computed in, so a cached or forwarded payload is self describing.
+     */
+    frame: {
+        /**
+         * Sidereal frame this chart was cast in, echoing the ayanamsa request field. "lahiri" when the field was omitted.
+         */
+        ayanamsa: string;
+        /**
+         * Degrees actually subtracted from every tropical longitude to produce this chart, read at the birth instant. Subtract it back to recover the tropical positions, or compare it against your reference software to confirm you are in the same frame before chasing a placement difference.
+         */
+        ayanamsaDegrees: number;
+    };
     /**
      * Individual planetary strength grids (Bhinnashtakavarga). Eight entries: one for each of the 7 classical planets plus Lagna. Each entry shows how many of the 8 contributors (7 planets + Lagna) give benefic points to that planet in each of the 12 signs.
      */
@@ -5346,11 +5937,115 @@ export type AshtakavargaRequest = {
      * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC (e.g. -5 for EST, 1 for CET). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly. Defaults to 5.5.
      */
     timezone?: number | string;
+    /**
+     * Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
+     */
+    ayanamsaValue?: number;
 };
 /**
  * Complete Shadbala (six-fold planetary strength) analysis for a birth chart per Brihat Parashara Hora Shastra (BPHS).
  */
 export type ShadbalaResponse = {
+    /**
+     * Localized name and one-line meaning for each of the six Shadbala components, keyed by the same field names each planet entry uses. Join it to render a readable strength breakdown in any of the eight supported languages instead of showing six untranslated Sanskrit terms.
+     */
+    balaThemes: {
+        /**
+         * Localized label and meaning for one Shadbala component.
+         */
+        sthanaBala: {
+            /**
+             * Localized name of this Shadbala component, suitable for a table header or a bar label.
+             */
+            name: string;
+            /**
+             * One-line localized explanation of what this component measures.
+             */
+            meaning: string;
+        };
+        /**
+         * Localized label and meaning for one Shadbala component.
+         */
+        digBala: {
+            /**
+             * Localized name of this Shadbala component, suitable for a table header or a bar label.
+             */
+            name: string;
+            /**
+             * One-line localized explanation of what this component measures.
+             */
+            meaning: string;
+        };
+        /**
+         * Localized label and meaning for one Shadbala component.
+         */
+        kalaBala: {
+            /**
+             * Localized name of this Shadbala component, suitable for a table header or a bar label.
+             */
+            name: string;
+            /**
+             * One-line localized explanation of what this component measures.
+             */
+            meaning: string;
+        };
+        /**
+         * Localized label and meaning for one Shadbala component.
+         */
+        chestaBala: {
+            /**
+             * Localized name of this Shadbala component, suitable for a table header or a bar label.
+             */
+            name: string;
+            /**
+             * One-line localized explanation of what this component measures.
+             */
+            meaning: string;
+        };
+        /**
+         * Localized label and meaning for one Shadbala component.
+         */
+        naisargikaBala: {
+            /**
+             * Localized name of this Shadbala component, suitable for a table header or a bar label.
+             */
+            name: string;
+            /**
+             * One-line localized explanation of what this component measures.
+             */
+            meaning: string;
+        };
+        /**
+         * Localized label and meaning for one Shadbala component.
+         */
+        drikBala: {
+            /**
+             * Localized name of this Shadbala component, suitable for a table header or a bar label.
+             */
+            name: string;
+            /**
+             * One-line localized explanation of what this component measures.
+             */
+            meaning: string;
+        };
+    };
+    /**
+     * The sidereal frame this response was computed in, so a cached or forwarded payload is self describing.
+     */
+    frame: {
+        /**
+         * Sidereal frame this chart was cast in, echoing the ayanamsa request field. "lahiri" when the field was omitted.
+         */
+        ayanamsa: string;
+        /**
+         * Degrees actually subtracted from every tropical longitude to produce this chart, read at the birth instant. Subtract it back to recover the tropical positions, or compare it against your reference software to confirm you are in the same frame before chasing a placement difference.
+         */
+        ayanamsaDegrees: number;
+    };
     /**
      * Shadbala analysis for all 7 classical planets. Ordered: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn. Each entry contains all 6 strength components, total strength in virupas and Rupas, Ishta/Kashta Phala, minimum required threshold, strength ratio, and relative rank.
      */
@@ -5372,7 +6067,7 @@ export type ShadbalaResponse = {
          */
         kalaBala: number;
         /**
-         * Chesta Bala (Motional Strength) in virupas. Based on planetary motion and retrogression. Retrograde planets score higher. Sun uses Ayana Chesta Bala (declination arc), Moon uses elongation from Sun. Other planets use Sheeghrochcha (mean anomaly) from Surya Siddhanta elements. Range 0 to 60.
+         * Chesta Bala (Motional Strength) in virupas. Based on planetary motion, so a retrograde graha scores higher because it is closer to Earth and working hardest. The Sun uses its Ayana Bala and the Moon its elongation from the Sun, per BPHS. Mars, Mercury, Jupiter, Venus and Saturn use the Sheeghra Kendra, the arc between the sheeghrochcha and the mean of the true and mean longitudes, with the roles of the mean Sun and the graha swapped for Mercury and Venus. Range 0 to 60.
          */
         chestaBala: number;
         /**
@@ -5380,7 +6075,7 @@ export type ShadbalaResponse = {
          */
         naisargikaBala: number;
         /**
-         * Drik Bala (Aspectual Strength) in virupas. Strength gained or lost from aspects received by other planets. Benefic aspects (Jupiter, Venus) add strength, malefic aspects (Sun, Mars, Saturn) reduce it. Can be negative when malefic aspects dominate. Uses Sputa Drishti with Vishesha (special) aspects for Mars, Jupiter, and Saturn.
+         * Drik Bala (Aspectual Strength) in virupas. Strength gained or lost from the aspects a graha receives. Benefic aspects add strength and malefic aspects reduce it, so this value is negative when malefics dominate. Mercury counts as benefic or malefic by the company it keeps in its own sign, decided by count with the nearest graha breaking a tie, and the Moon by its paksha. Uses the graded Sputa Drishti curve of BPHS Ch. 26 with the Vishesha (special) aspects of Mars, Jupiter and Saturn applied at their precise DEGREE ranges rather than by whole sign.
          */
         drikBala: number;
         /**
@@ -5434,11 +6129,32 @@ export type ShadbalaRequest = {
      * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC (e.g. -5 for EST, 1 for CET). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly. Defaults to 5.5.
      */
     timezone?: number | string;
+    /**
+     * Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
+     */
+    ayanamsaValue?: number;
 };
 /**
  * The twelve Arudha padas of a birth chart, computed per the Jaimini rule with the classical exception applied.
  */
 export type ArudhaResponse = {
+    /**
+     * The sidereal frame this response was computed in, so a cached or forwarded payload is self describing.
+     */
+    frame: {
+        /**
+         * Sidereal frame this chart was cast in, echoing the ayanamsa request field. "lahiri" when the field was omitted.
+         */
+        ayanamsa: string;
+        /**
+         * Degrees actually subtracted from every tropical longitude to produce this chart, read at the birth instant. Subtract it back to recover the tropical positions, or compare it against your reference software to confirm you are in the same frame before chasing a placement difference.
+         */
+        ayanamsaDegrees: number;
+    };
     /**
      * Zodiac sign of the Ascendant (Lagna), which anchors the twelve bhavas the padas are derived from.
      */
@@ -5526,11 +6242,32 @@ export type ArudhaRequest = {
      * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC (e.g. -5 for EST, 1 for CET). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly. Defaults to 5.5.
      */
     timezone?: number | string;
+    /**
+     * Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
+     */
+    ayanamsaValue?: number;
 };
 /**
  * Chara Karakas for a birth chart: the movable significators of Jaimini astrology, ranked by how far each graha has advanced into its sign.
  */
 export type CharaKarakaResponse = {
+    /**
+     * The sidereal frame this response was computed in, so a cached or forwarded payload is self describing.
+     */
+    frame: {
+        /**
+         * Sidereal frame this chart was cast in, echoing the ayanamsa request field. "lahiri" when the field was omitted.
+         */
+        ayanamsa: string;
+        /**
+         * Degrees actually subtracted from every tropical longitude to produce this chart, read at the birth instant. Subtract it back to recover the tropical positions, or compare it against your reference software to confirm you are in the same frame before chasing a placement difference.
+         */
+        ayanamsaDegrees: number;
+    };
     /**
      * Scheme the ranking used, echoed back so a cached or logged response is self describing.
      */
@@ -5610,11 +6347,372 @@ export type CharaKarakaRequest = {
      * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC (e.g. -5 for EST, 1 for CET). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly. Defaults to 5.5.
      */
     timezone?: number | string;
+    /**
+     * Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
+     */
+    ayanamsaValue?: number;
     /**
      * Which Chara Karaka scheme to rank. "eight" includes Rahu, counting its degree in reverse because it moves retrograde, and returns eight offices including Pitrikaraka. "seven" ranks only the seven classical grahas and drops Pitrikaraka. Ketu is excluded from both, since it always mirrors the Rahu degree exactly. The two schemes can produce a different Atmakaraka for the same chart, so select the one your reference software uses. Defaults to "eight".
      */
     scheme?: 'seven' | 'eight';
 };
+/**
+ * Complete Bhava Bala (house strength) analysis per Brihat Parashara Hora Shastra, with a localized house-meaning legend.
+ */
+export type BhavaBalaResponse = {
+    /**
+     * The sidereal frame this response was computed in, so a cached or forwarded payload is self describing.
+     */
+    frame: {
+        /**
+         * Sidereal frame this chart was cast in, echoing the ayanamsa request field. "lahiri" when the field was omitted.
+         */
+        ayanamsa: string;
+        /**
+         * Degrees actually subtracted from every tropical longitude to produce this chart, read at the birth instant. Subtract it back to recover the tropical positions, or compare it against your reference software to confirm you are in the same frame before chasing a placement difference.
+         */
+        ayanamsaDegrees: number;
+    };
+    /**
+     * House frame the bhavas were built on. Always sripati: Bhava Bala is defined on unequal bhava madhyas, not on whole signs.
+     */
+    houseSystem: string;
+    /**
+     * Bhava Bala for all twelve houses in order, house 1 first. Each entry carries its own components so a client can explain a score rather than just display it.
+     */
+    bhavas: Array<{
+        /**
+         * Bhava (house) number 1 to 12, counted from the Lagna. House 1 is the Ascendant bhava, house 10 the career bhava, house 7 the partnership bhava.
+         */
+        house: number;
+        /**
+         * Zodiac sign holding this bhavas madhya (mid-cusp). Under the Sripati house system the bhavas are unequal, so this is NOT always the nth sign from the Lagna, and two bhavas can share a sign while another sign holds none.
+         */
+        rashi: string;
+        /**
+         * Bhava madhya (mid-cusp) longitude in degrees, sidereal Lahiri. The point every strength component below is measured at. Bhavas 1, 4, 7 and 10 sit on the Ascendant, IC, Descendant and Midheaven; the rest trisect the quadrants between them.
+         */
+        madhya: number;
+        /**
+         * Bhavadhipati (house lord), the ruler of the sign holding the madhya. Its Shadbala is what this bhava inherits, so a house ruled by a strong graha starts strong.
+         */
+        lord: string;
+        /**
+         * Bhavadhipati Bala in virupas: the total Shadbala of the house lord, carried across unchanged. The dominant term of the three, typically 250 to 650. Two bhavas ruled by the same graha therefore share this value exactly.
+         */
+        bhavadhipatiBala: number;
+        /**
+         * Bhava Digbala (directional strength) in virupas, 0 to 60 in steps of 10. Each rashi class is strongest in one cardinal bhava (human signs at the Lagna, quadruped at the 10th, watery at the 4th, Scorpio at the 7th) and loses 10 virupas per bhava of separation, reaching 0 at the seventh from it.
+         */
+        digBala: number;
+        /**
+         * Bhava Drishti Bala (aspectual strength) in virupas, computed on the bhava madhya exactly as Graha Drik Bala is computed on a graha. Benefic aspects add and malefic aspects subtract, so this term is often negative.
+         */
+        drishtiBala: number;
+        /**
+         * Total Bhava Bala in virupas, the sum of the three components above. Use it to compare houses within one chart: the strongest bhavas are the life areas that unfold with least resistance.
+         */
+        totalVirupas: number;
+        /**
+         * Total Bhava Bala in rupas (totalVirupas / 60). 1 rupa equals 60 virupas. Rupas are the conventional unit in classical tables.
+         */
+        totalRupas: number;
+        /**
+         * Strength rank among the twelve bhavas, 1 = strongest. Ranked on totalVirupas, so it never disagrees with the published totals.
+         */
+        rank: number;
+    }>;
+    /**
+     * Significations of each of the twelve bhavas (houses), keyed by house number 1 to 12, as short keywords. Bhava 1 is the Lagna (self, body, vitality), 2 wealth and speech, 4 home and mother, 7 marriage and partnership, 10 career and status, 11 gains. Use it to label the house numbers returned elsewhere in the response: a Vimshottari dasha period signifying houses 2, 7 and 8, or a KP significator carrying houses 11 and 6, becomes readable text without a separate lookup call. Returned once per response rather than repeated per period, and localized by the lang query parameter alongside every other interpretation field.
+     */
+    houseThemes: {
+        [key: string]: Array<string>;
+    };
+    /**
+     * Which signification vocabulary produced the houseThemes keywords in this response, echoing the focus query parameter. Always present, and "general" when the parameter was omitted. Read it to label a rendered house legend, or to tell two cached responses apart when only one asked for the finance lens.
+     */
+    focus: 'general' | 'finance';
+};
+export type BhavaBalaRequest = {
+    /**
+     * Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).
+     */
+    date: string;
+    /**
+     * Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.
+     */
+    time: string;
+    /**
+     * Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.
+     */
+    latitude: number;
+    /**
+     * Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.
+     */
+    longitude: number;
+    /**
+     * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC (e.g. -5 for EST, 1 for CET). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly. Defaults to 5.5.
+     */
+    timezone?: number | string;
+    /**
+     * Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
+     */
+    ayanamsaValue?: number;
+};
+/**
+ * Bhav Chalit (Chalit Kundli): every graha placed by unequal Sripati bhava, with the whole-sign placement beside it for comparison.
+ */
+export type BhavChalitResponse = {
+    /**
+     * The sidereal frame this response was computed in, so a cached or forwarded payload is self describing.
+     */
+    frame: {
+        /**
+         * Sidereal frame this chart was cast in, echoing the ayanamsa request field. "lahiri" when the field was omitted.
+         */
+        ayanamsa: string;
+        /**
+         * Degrees actually subtracted from every tropical longitude to produce this chart, read at the birth instant. Subtract it back to recover the tropical positions, or compare it against your reference software to confirm you are in the same frame before chasing a placement difference.
+         */
+        ayanamsaDegrees: number;
+    };
+    /**
+     * House frame used to build the bhavas. Always sripati for the Chalit chart.
+     */
+    houseSystem: string;
+    /**
+     * Sidereal Lahiri Ascendant in degrees. The madhya of bhava 1.
+     */
+    ascendant: number;
+    /**
+     * Sidereal Lahiri Midheaven in degrees. The madhya of bhava 10.
+     */
+    midheaven: number;
+    /**
+     * The twelve Sripati bhavas in order with their boundaries and occupants.
+     */
+    bhavas: Array<{
+        /**
+         * Bhava number 1 to 12.
+         */
+        house: number;
+        /**
+         * Bhava sandhi (junction) opening this bhava, in degrees. The midpoint between this madhya and the previous one. A graha exactly on a sandhi belongs to the bhava it opens.
+         */
+        start: number;
+        /**
+         * Bhava madhya (mid-cusp) in degrees. Bhavas 1, 4, 7 and 10 sit exactly on the Ascendant, IC, Descendant and Midheaven; the other eight trisect the quadrant arcs between them.
+         */
+        madhya: number;
+        /**
+         * Bhava sandhi closing this bhava. Identical to the next bhavas start, so the twelve bhavas tile the zodiac with no gap.
+         */
+        end: number;
+        /**
+         * Width of the bhava in degrees. Rarely 30: the Ascendant and Midheaven are only 90 degrees apart by coincidence of latitude and epoch, so quadrants stretch and squeeze and the bhavas with them.
+         */
+        span: number;
+        /**
+         * Sign holding the madhya. Because bhavas are unequal, two bhavas can share a sign while another sign holds no madhya at all.
+         */
+        rashi: string;
+        /**
+         * Grahas falling inside this bhava. Empty when the bhava is unoccupied.
+         */
+        grahas: Array<string>;
+    }>;
+    /**
+     * All nine grahas with both their Chalit bhava and their whole-sign Rashi house, plus a moved flag.
+     */
+    grahas: Array<{
+        /**
+         * Graha name. All nine are placed, the seven classical grahas plus the lunar nodes Rahu and Ketu.
+         */
+        graha: string;
+        /**
+         * Sidereal Lahiri longitude in degrees.
+         */
+        longitude: number;
+        /**
+         * Zodiac sign the graha occupies. Identical to the Rashi (D1) chart.
+         */
+        rashi: string;
+        /**
+         * Bhava the graha falls in under the unequal Sripati cusps. This is the Bhav Chalit placement and the reason the chart exists.
+         */
+        bhava: number;
+        /**
+         * House the same graha occupies in the whole-sign Rashi chart, counted from the Lagna sign. Returned alongside bhava so the difference is visible without a second request.
+         */
+        rashiHouse: number;
+        /**
+         * True when bhava and rashiHouse disagree, i.e. the graha changes house between the Rashi chart and the Chalit chart. These are the placements a practitioner opens this chart to check.
+         */
+        moved: boolean;
+    }>;
+    /**
+     * How many of the nine grahas change house between the Rashi chart and the Chalit chart. Zero is a perfectly normal result and means the two charts agree for this nativity.
+     */
+    movedCount: number;
+    /**
+     * Significations of each of the twelve bhavas (houses), keyed by house number 1 to 12, as short keywords. Bhava 1 is the Lagna (self, body, vitality), 2 wealth and speech, 4 home and mother, 7 marriage and partnership, 10 career and status, 11 gains. Use it to label the house numbers returned elsewhere in the response: a Vimshottari dasha period signifying houses 2, 7 and 8, or a KP significator carrying houses 11 and 6, becomes readable text without a separate lookup call. Returned once per response rather than repeated per period, and localized by the lang query parameter alongside every other interpretation field.
+     */
+    houseThemes: {
+        [key: string]: Array<string>;
+    };
+    /**
+     * Which signification vocabulary produced the houseThemes keywords in this response, echoing the focus query parameter. Always present, and "general" when the parameter was omitted. Read it to label a rendered house legend, or to tell two cached responses apart when only one asked for the finance lens.
+     */
+    focus: 'general' | 'finance';
+};
+export type BhavChalitRequest = {
+    /**
+     * Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas).
+     */
+    date: string;
+    /**
+     * Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect.
+     */
+    time: string;
+    /**
+     * Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172.
+     */
+    latitude: number;
+    /**
+     * Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.
+     */
+    longitude: number;
+    /**
+     * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC (e.g. -5 for EST, 1 for CET). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly. Defaults to 5.5.
+     */
+    timezone?: number | string;
+    /**
+     * Sidereal frame (ayanamsa) the chart is cast in. "lahiri" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. "raman" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. "kp-newcomb" and "kp-old" are the two Krishnamurti Paddhati frames. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it.
+     */
+    ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
+    /**
+     * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
+     */
+    ayanamsaValue?: number;
+};
+/**
+ * Heliacal rising and setting status of the six visible grahas.
+ */
+export type HeliacalResponse = {
+    /**
+     * Local calendar date the verdicts were read for, echoed from the request.
+     */
+    date: string;
+    /**
+     * One entry per visible graha, in classical order. A graha is omitted only when no horizon crossing exists for it at this latitude on this day.
+     */
+    grahas: Array<{
+        /**
+         * Graha name. Only the six with a visible body appear: Moon, Mars, Mercury, Jupiter, Venus and Saturn. The Sun cannot be lost in his own glare, and Rahu and Ketu are computed points with nothing to see.
+         */
+        graha: string;
+        /**
+         * Whether the graha clears the Sun glare on this day. False is the state a practitioner calls asta or combust, during which classical muhurta withholds auspicious ceremonies, most strictly marriage while Jupiter or Venus is invisible.
+         */
+        visible: boolean;
+        /**
+         * Horizon this graha is currently judged at. West means it sets after the Sun and is an evening object, east that it rises before him and is a morning one.
+         */
+        horizon: 'east' | 'west';
+        /**
+         * Separation from the Sun in degrees of TIME (kalamsa), measured along the equator between the two bodies horizon crossings. This is the quantity Surya Siddhanta actually compares against the limit, and it is not the same as the difference of ecliptic longitudes: the two diverge by roughly 3 degrees at Mumbai and by more than 15 further north, because it accounts for the angle the ecliptic makes with the local horizon.
+         */
+        timeDegrees: number;
+        /**
+         * The limit in degrees of time this graha must clear to be seen, per Surya Siddhanta ch. IX vv.6-8 and ch. X.1: Moon 12, Jupiter 11, Saturn 15, Mars 17, Venus 10 or 8, Mercury 14 or 12. Larger means the graha is fainter and needs more distance from the Sun.
+         */
+        kalamsa: number;
+        /**
+         * Whether the graha is retrograde, which for Mercury and Venus tightens the limit (Venus 10 to 8, Mercury 14 to 12). Retrograde puts them near inferior conjunction where they are far closer to Earth, so the larger brighter disk survives closer to the Sun.
+         */
+        retrograde: boolean;
+        /**
+         * Plain angular separation of the two ecliptic longitudes, in degrees. Returned beside timeDegrees so the two measures can be compared: this is what a combustion flag on a birth chart uses, and the gap between them is precisely what a location-aware heliacal calculation adds.
+         */
+        longitudeSeparation: number;
+        /**
+         * The event that produced the current state, or null when none falls inside the search horizon (up to about one synodic period, so Mars can legitimately have none).
+         */
+        lastEvent: {
+            /**
+             * Udaya is heliacal rising, the graha re-emerging from the Sun rays and becoming visible again. Asta (also called lopa, moudhya or moudyami) is heliacal setting, the graha disappearing into them. Stable Sanskrit keys, never translated.
+             */
+            type: 'udaya' | 'asta';
+            /**
+             * Horizon the event happens at. East means it is read before sunrise, so the graha is a morning object; west means after sunset, an evening object. A graha crosses to the other horizon as it passes the Sun, which is why an asta and the udaya that follows it are usually on opposite horizons.
+             */
+            horizon: 'east' | 'west';
+            /**
+             * Local civil datetime of the event (YYYY-MM-DDTHH:MM:SS), being the moment the graha itself crosses the horizon on the day its verdict changes. That instant, rather than sunrise or sunset, is what published Asta tables print.
+             */
+            datetime: string;
+            /**
+             * Separation from the Sun in degrees of time on the event day, measured the way the classical rule requires. Sits just either side of kalamsa, since that crossing is what defines the event.
+             */
+            timeDegrees: number;
+            /**
+             * The limit that was crossed. Can differ from the current reading limit for Mercury and Venus, whose limit tightens when they are retrograde, so an asta entered while retrograde may be left at a different threshold.
+             */
+            kalamsa: number;
+        } | null;
+        /**
+         * The event that will end the current state, or null when none falls inside the search horizon. For an invisible graha this is the udaya a practitioner is waiting for, so it answers when Guru Asta or Shukra Asta lifts.
+         */
+        nextEvent: {
+            /**
+             * Udaya is heliacal rising, the graha re-emerging from the Sun rays and becoming visible again. Asta (also called lopa, moudhya or moudyami) is heliacal setting, the graha disappearing into them. Stable Sanskrit keys, never translated.
+             */
+            type: 'udaya' | 'asta';
+            /**
+             * Horizon the event happens at. East means it is read before sunrise, so the graha is a morning object; west means after sunset, an evening object. A graha crosses to the other horizon as it passes the Sun, which is why an asta and the udaya that follows it are usually on opposite horizons.
+             */
+            horizon: 'east' | 'west';
+            /**
+             * Local civil datetime of the event (YYYY-MM-DDTHH:MM:SS), being the moment the graha itself crosses the horizon on the day its verdict changes. That instant, rather than sunrise or sunset, is what published Asta tables print.
+             */
+            datetime: string;
+            /**
+             * Separation from the Sun in degrees of time on the event day, measured the way the classical rule requires. Sits just either side of kalamsa, since that crossing is what defines the event.
+             */
+            timeDegrees: number;
+            /**
+             * The limit that was crossed. Can differ from the current reading limit for Mercury and Venus, whose limit tightens when they are retrograde, so an asta entered while retrograde may be left at a different threshold.
+             */
+            kalamsa: number;
+        } | null;
+    }>;
+};
+export type HeliacalRequest = {
+    /**
+     * Local calendar date to judge, in YYYY-MM-DD format. There is deliberately no time field: heliacal visibility is a once-a-day verdict read at that day sunrise or sunset, so a clock time could only pick a different day.
+     */
+    date: string;
+    /**
+     * Observer latitude in decimal degrees, restricted to -60 to 60. Visibility depends on the observer, unlike the longitude orb every chart API reports, because the angle the ecliptic makes with the horizon decides how long a graha lingers after the Sun. Beyond this band the classical rule stops describing solar glare and starts describing polar horizon geometry, so it is declined rather than answered wrongly.
+     */
+    latitude: number;
+    /**
+     * Observer longitude in decimal degrees. Sets local sunrise and sunset, which are the instants the verdict is read at. Example: Mumbai 72.8777, Delhi 77.2090, London -0.1278.
+     */
+    longitude: number;
+    /**
+     * Timezone: IANA name (e.g. "Asia/Kolkata", "Europe/London") OR decimal hours from UTC. Fixes which local day the date refers to, and every datetime in the response is returned in it. Defaults to 5.5.
+     */
+    timezone?: number | string;
+};
 export type BasicCard = {
     /**
      * Unique card identifier in kebab-case (e.g. fool, ace-of-cups, queen-of-swords).
@@ -8821,7 +9919,7 @@ export type PostAstrologyTransitAspectsResponses = {
                  */
                 summary: string;
                 /**
-                 * When this transit is most active and how long its influence lasts.
+                 * When this transit is most active and how long its influence lasts, localized. The bucket follows the speed of the transiting body: a few hours for the Moon, a few days for the Sun, Mercury, Venus and Mars, one to two weeks for Jupiter, several weeks for Saturn, and an extended period for Uranus, Neptune and Pluto.
                  */
                 timing: string;
                 /**
@@ -8894,7 +9992,7 @@ export type PostAstrologyTransitAspectsResponses = {
                  * Aspect nature. Harmonious (trine, sextile) flows easily. Challenging (square, opposition) creates tension and growth. Neutral (conjunction) blends energies.
                  */
                 interpretation: 'harmonious' | 'challenging' | 'neutral';
-            };
+            } | null;
             /**
              * Transit aspect counts grouped by aspect type (conjunction, trine, square, opposition, sextile, etc.). Useful for quickly assessing the transit weather.
              */
@@ -10489,7 +11587,7 @@ export type PostAstrologyCompatibilityScoreResponses = {
             /**
              * Dominant element shared by both charts, or null if dominant elements differ.
              */
-            sharedElement: string;
+            sharedElement: string | null;
             /**
              * How the elemental balance between charts shapes the relationship dynamic.
              */
@@ -11983,7 +13081,7 @@ export type PostAstrologyFixedStarsData = {
         /**
          * Conjunction orb in degrees, the maximum separation for a star to count as conjunct a chart point. Defaults to 1, maximum 3. Widen it to surface looser contacts or tighten it for only the closest hits.
          */
-        orb?: number;
+        orb?: number | null;
     };
     url: '/astrology/fixed-stars';
 };
@@ -12935,7 +14033,7 @@ export type PostVedicAstrologyBirthChartErrors = {
 export type PostVedicAstrologyBirthChartError = PostVedicAstrologyBirthChartErrors[keyof PostVedicAstrologyBirthChartErrors];
 export type PostVedicAstrologyBirthChartResponses = {
     /**
-     * D1 Rashi birth chart with all 12 houses, 9 grahas plus Lagna, combustion analysis (Surya Siddhanta orbs), planetary war detection, bhava interpretations, and a meta lookup keyed by planet name.
+     * D1 Rashi birth chart with all 12 houses, 9 grahas plus Lagna, combustion analysis (Surya Siddhanta limits, applied as the standard ecliptic longitude orb), planetary war detection, bhava interpretations, and a meta lookup keyed by planet name.
      */
     200: BirthChartResponse;
 };
@@ -13614,9 +14712,9 @@ export type PostVedicAstrologyDashaCurrentData = {
          */
         timezone?: number | string;
         /**
-         * Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
+         * Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "raman" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
          */
-        ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'custom';
+        ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
         /**
          * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
          */
@@ -13783,7 +14881,7 @@ export type PostVedicAstrologyDashaCurrentResponses = {
         /**
          * Ayanamsa system used, echoing the request field. One of "lahiri", "kp-newcomb", "kp-old" or "custom". Echoed so a client can confirm which frame produced these dates without re-deriving it. When it reads "custom" the ayanamsa field above carries the exact value you supplied.
          */
-        ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'custom';
+        ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
         /**
          * Mahadasha (major planetary period) in the 120-year Vimshottari dasha cycle. Start and end dates are determined by Moon nakshatra at birth.
          */
@@ -14428,9 +15526,9 @@ export type PostVedicAstrologyDashaMajorData = {
          */
         timezone?: number | string;
         /**
-         * Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
+         * Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "raman" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
          */
-        ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'custom';
+        ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
         /**
          * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
          */
@@ -14597,7 +15695,7 @@ export type PostVedicAstrologyDashaMajorResponses = {
         /**
          * Ayanamsa system used, echoing the request field. One of "lahiri", "kp-newcomb", "kp-old" or "custom". Echoed so a client can confirm which frame produced these dates without re-deriving it. When it reads "custom" the ayanamsa field above carries the exact value you supplied.
          */
-        ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'custom';
+        ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
         /**
          * Remaining balance of the first Mahadasha at birth. Based on Moon degree within the birth nakshatra. partial dasha already elapsed before birth.
          */
@@ -14741,9 +15839,9 @@ export type PostVedicAstrologyDashaSubByMahadashaData = {
          */
         timezone?: number | string;
         /**
-         * Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
+         * Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "raman" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
          */
-        ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'custom';
+        ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
         /**
          * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
          */
@@ -14907,7 +16005,7 @@ export type PostVedicAstrologyDashaSubByMahadashaResponses = {
         /**
          * Ayanamsa system used, echoing the request field. One of "lahiri", "kp-newcomb", "kp-old" or "custom". Echoed so a client can confirm which frame produced these dates without re-deriving it. When it reads "custom" the ayanamsa field above carries the exact value you supplied.
          */
-        ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'custom';
+        ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
         /**
          * Full details of the parent Mahadasha including start/end dates and duration.
          */
@@ -15122,9 +16220,9 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaData = {
          */
         timezone?: number | string;
         /**
-         * Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
+         * Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "raman" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
          */
-        ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'custom';
+        ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
         /**
          * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
          */
@@ -15296,7 +16394,7 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses = {
         /**
          * Ayanamsa system used, echoing the request field. One of "lahiri", "kp-newcomb", "kp-old" or "custom". Echoed so a client can confirm which frame produced these dates without re-deriving it. When it reads "custom" the ayanamsa field above carries the exact value you supplied.
          */
-        ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'custom';
+        ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
         /**
          * Full details of the parent Antardasha including start/end dates and duration.
          */
@@ -15519,9 +16617,9 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaDa
          */
         timezone?: number | string;
         /**
-         * Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
+         * Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "raman" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
          */
-        ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'custom';
+        ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
         /**
          * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
          */
@@ -15701,7 +16799,7 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaRe
         /**
          * Ayanamsa system used, echoing the request field. One of "lahiri", "kp-newcomb", "kp-old" or "custom". Echoed so a client can confirm which frame produced these dates without re-deriving it. When it reads "custom" the ayanamsa field above carries the exact value you supplied.
          */
-        ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'custom';
+        ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
         /**
          * Full details of the parent Pratyantardasha including start/end dates and duration.
          */
@@ -15932,9 +17030,9 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBy
          */
         timezone?: number | string;
         /**
-         * Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
+         * Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. "lahiri" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. "kp-newcomb" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. "kp-old" uses the Krishnamurti original table from KP Reader-1. "raman" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. "custom" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
          */
-        ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'custom';
+        ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
         /**
          * Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source.
          */
@@ -16122,7 +17220,7 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBy
         /**
          * Ayanamsa system used, echoing the request field. One of "lahiri", "kp-newcomb", "kp-old" or "custom". Echoed so a client can confirm which frame produced these dates without re-deriving it. When it reads "custom" the ayanamsa field above carries the exact value you supplied.
          */
-        ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'custom';
+        ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman' | 'custom';
         /**
          * Full details of the parent Sookshma dasha including start/end dates and duration.
          */
@@ -16753,30 +17851,34 @@ export type PostVedicAstrologyPanchangDetailedResponses = {
          */
         vara: {
             /**
-             * Hindu weekday name. Vara begins at local sunrise, not midnight.
+             * Weekday name in English. Vara begins at local sunrise, not at midnight, so a time before sunrise belongs to the previous vara.
              */
             name: string;
+            /**
+             * Vara name transliterated from Sanskrit: Ravivara, Somavara, Mangalavara, Budhavara, Guruvara, Shukravara, Shanivara. Use this rather than name for a Jyotish-facing reading, since it is the form the classical texts use and it does not change with the lang parameter.
+             */
+            sanskritName: string;
             /**
              * Ruling planet of the day (Vara lord). Influences day-level auspiciousness.
              */
             lord: string;
         };
         /**
-         * Local sunrise time in UTC. Marks the start of the Hindu day.
+         * Local sunrise in the requested timezone as YYYY-MM-DDTHH:MM:SS, with no zone suffix. Marks the start of the Hindu day.
          */
         sunrise: string;
         /**
-         * Local sunset time in UTC. Marks the transition to night muhurtas.
+         * Local sunset in the requested timezone as YYYY-MM-DDTHH:MM:SS, with no zone suffix. Marks the transition to night muhurtas.
          */
         sunset: string;
         /**
          * Moonrise time in the requested timezone. Can be null if Moon does not rise on this date.
          */
-        moonrise: string;
+        moonrise: string | null;
         /**
          * Moonset time in the requested timezone. Can be null if Moon does not set on this date.
          */
-        moonset: string;
+        moonset: string | null;
         /**
          * Moon sign (Chandra Rashi) at sunrise. Central to Vedic astrology. determines daily emotional tone, Chandrabalam, and Tarabalam.
          */
@@ -16941,11 +18043,11 @@ export type PostVedicAstrologyPanchangDetailedResponses = {
              */
             number: number;
             /**
-             * Start time of the current hora in UTC.
+             * Start time of the current hora, as local civil time in the requested timezone offset. The first hora of any day begins at local sunrise, so this equals the sunrise field when the hora number is 1.
              */
             start: string;
             /**
-             * End time of the current hora in UTC.
+             * End time of the current hora, as local civil time in the requested timezone offset. Day horas and night horas have different lengths, so a hora is only approximately 60 minutes.
              */
             end: string;
         };
@@ -17000,7 +18102,7 @@ export type PostVedicAstrologyPanchangDetailedResponses = {
              * Period end time in ISO 8601 format. Timezone-adjusted based on the input timezone offset.
              */
             end: string;
-        };
+        } | null;
         /**
          * Brahma Muhurta, sacred pre-dawn period approximately 96 minutes before sunrise (14th of 15 night muhurtas). Considered the best time for meditation, mantra japa, Vedic study, and spiritual sadhana. Referenced in Ashtanga Hridaya and Dharmashastra texts.
          */
@@ -17052,7 +18154,7 @@ export type PostVedicAstrologyPanchangDetailedResponses = {
              * Period end time in ISO 8601 format. Timezone-adjusted based on the input timezone offset.
              */
             end: string;
-        };
+        } | null;
         /**
          * Pratah Sandhya, morning twilight junction period for Sandhyavandanam prayer. Spans 3 night ghatis before sunrise to sunrise. Duration varies by location and season based on ratrimana (night duration). One of the three daily Sandhya prayer times prescribed in Dharmashastra.
          */
@@ -17065,7 +18167,7 @@ export type PostVedicAstrologyPanchangDetailedResponses = {
              * Period end time in ISO 8601 format. Timezone-adjusted based on the input timezone offset.
              */
             end: string;
-        };
+        } | null;
         /**
          * Sayahna Sandhya, evening twilight junction period for Sandhyavandanam prayer. Spans sunset to 3 night ghatis after sunset. Duration varies by location and season based on ratrimana (night duration). One of the three daily Sandhya prayer times prescribed in Dharmashastra.
          */
@@ -17078,7 +18180,7 @@ export type PostVedicAstrologyPanchangDetailedResponses = {
              * Period end time in ISO 8601 format. Timezone-adjusted based on the input timezone offset.
              */
             end: string;
-        };
+        } | null;
         /**
          * Dur Muhurta (Dur Muhurtam), inauspicious muhurta periods determined by the weekday. The daytime is divided into 15 muhurtas from sunrise to sunset. Specific muhurta numbers are inauspicious each weekday per Muhurta Chintamani. Each period lasts ~48 minutes. Most days have 2 Dur Muhurtas, Wednesday and Sunday have 1. Avoid initiating important activities during these periods.
          */
@@ -17155,15 +18257,15 @@ export type PostVedicAstrologyPanchangDetailedResponses = {
             /**
              * Panchaka dosha, set by the weekday the period BEGINS (not the nakshatra): Roga (Sunday, disease), Raja (Monday, government), Agni (Tuesday, fire), Chora (Friday, theft), Mrityu (Saturday, death). Null when Panchaka begins on Wednesday or Thursday (no dosha) or when no Panchaka touches this date.
              */
-            type: string;
+            type: string | null;
             /**
              * When the Panchaka period starts (Moon enters 300 degrees, Dhanishta 3rd pada). May predate this date when Panchaka is already running. Null when no Panchaka is in force or begins on this date. In requested timezone.
              */
-            startsAt: string;
+            startsAt: string | null;
             /**
              * When the Panchaka period ends (Moon exits Revati at 360 degrees), about five days after it starts. Null when no Panchaka. In requested timezone.
              */
-            endsAt: string;
+            endsAt: string | null;
         };
         /**
          * Bhadra (Vishti Karana), the 7th movable karana, avoided for all auspicious activities. Bhadra recurs roughly every 3 to 5 days and lasts about half a tithi. active is true whenever a Bhadra is attributed to this date; startsAt and endsAt give the window, which may end on the next calendar day.
@@ -17176,11 +18278,11 @@ export type PostVedicAstrologyPanchangDetailedResponses = {
             /**
              * When the Bhadra (Vishti) period that begins on this date starts. Null when no Bhadra begins on this date. In requested timezone.
              */
-            startsAt: string;
+            startsAt: string | null;
             /**
              * When the Bhadra (Vishti) period that begins on this date ends. May fall on the next calendar day. Null when no Bhadra begins on this date. In requested timezone.
              */
-            endsAt: string;
+            endsAt: string | null;
         };
         /**
          * Panchang element transition times. exact timing of when each element (tithi, yoga, karana, nakshatra, Moon sign) changes. Calculated using binary search for ~1 minute precision. Essential for precise muhurta determination and panchang calendars.
@@ -17387,90 +18489,260 @@ export type PostVedicAstrologyPanchangChoghadiyaErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyPanchangChoghadiyaError = PostVedicAstrologyPanchangChoghadiyaErrors[keyof PostVedicAstrologyPanchangChoghadiyaErrors];
-export type PostVedicAstrologyPanchangChoghadiyaResponses = {
+export type PostVedicAstrologyPanchangChoghadiyaError = PostVedicAstrologyPanchangChoghadiyaErrors[keyof PostVedicAstrologyPanchangChoghadiyaErrors];
+export type PostVedicAstrologyPanchangChoghadiyaResponses = {
+    /**
+     * 8 daytime and 8 nighttime Choghadiya muhurta periods with names, ruling planets, auspiciousness ratings (Good/Bad), and exact start/end times based on sunrise and sunset.
+     */
+    200: {
+        /**
+         * Calendar date the choghadiya muhurta table was computed for, YYYY-MM-DD, echoed back from the request. The day periods run from that date sunrise to its sunset, and the night periods run on to the next sunrise.
+         */
+        date: string;
+        /**
+         * 8 daytime choghadiya periods (sunrise to sunset)
+         */
+        dayChoghadiya: Array<{
+            /**
+             * Choghadiya muhurta name. Auspicious: Amrit (Moon), Shubh (Jupiter), Labh (Mercury), Char (Venus). Inauspicious: Udveg (Sun), Rog (Mars), Kaal (Saturn).
+             */
+            name: 'Udveg' | 'Amrit' | 'Rog' | 'Labh' | 'Shubh' | 'Char' | 'Kaal';
+            /**
+             * Ruling planet of this Choghadiya period. Planet determines the quality and suitability of activities during this muhurta.
+             */
+            lord: string;
+            /**
+             * Auspiciousness of this period. Good periods (Amrit, Shubh, Labh, Char) are suitable for important activities. Bad periods (Udveg, Rog, Kaal) should be avoided.
+             */
+            effect: 'Good' | 'Bad';
+            /**
+             * Period start time in ISO 8601 format. Timezone-adjusted based on input timezone offset.
+             */
+            start: string;
+            /**
+             * Period end time in ISO 8601 format. Each Choghadiya period is one-eighth of the day or night duration.
+             */
+            end: string;
+        }>;
+        /**
+         * 8 nighttime choghadiya periods (sunset to next sunrise)
+         */
+        nightChoghadiya: Array<{
+            /**
+             * Choghadiya muhurta name. Auspicious: Amrit (Moon), Shubh (Jupiter), Labh (Mercury), Char (Venus). Inauspicious: Udveg (Sun), Rog (Mars), Kaal (Saturn).
+             */
+            name: 'Udveg' | 'Amrit' | 'Rog' | 'Labh' | 'Shubh' | 'Char' | 'Kaal';
+            /**
+             * Ruling planet of this Choghadiya period. Planet determines the quality and suitability of activities during this muhurta.
+             */
+            lord: string;
+            /**
+             * Auspiciousness of this period. Good periods (Amrit, Shubh, Labh, Char) are suitable for important activities. Bad periods (Udveg, Rog, Kaal) should be avoided.
+             */
+            effect: 'Good' | 'Bad';
+            /**
+             * Period start time in ISO 8601 format. Timezone-adjusted based on input timezone offset.
+             */
+            start: string;
+            /**
+             * Period end time in ISO 8601 format. Each Choghadiya period is one-eighth of the day or night duration.
+             */
+            end: string;
+        }>;
+    };
+};
+export type PostVedicAstrologyPanchangChoghadiyaResponse = PostVedicAstrologyPanchangChoghadiyaResponses[keyof PostVedicAstrologyPanchangChoghadiyaResponses];
+export type PostVedicAstrologyPanchangHoraData = {
+    body?: {
+        /**
+         * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected.
+         */
+        date: string;
+        /**
+         * Observer latitude in decimal degrees. Determines sunrise and sunset times which define day/night boundaries for muhurta calculations.
+         */
+        latitude: number;
+        /**
+         * Observer longitude in decimal degrees. Affects local time calculations for sunrise, sunset, and muhurta period boundaries.
+         */
+        longitude: number;
+        /**
+         * Timezone offset from UTC in decimal hours. Used for accurate sunrise/sunset calculation and output time formatting. Essential for correct Hora periods outside IST. Defaults to 5.5 (IST).
+         */
+        timezone?: number | string;
+    };
+    path?: never;
+    query?: never;
+    url: '/vedic-astrology/panchang/hora';
+};
+export type PostVedicAstrologyPanchangHoraErrors = {
+    /**
+     * Validation error. `issues[]` lists every failed field.
+     */
+    400: {
+        /**
+         * First issue summary.
+         */
+        error: string;
+        code: 'validation_error';
+        /**
+         * Every validation failure. Use this to rebuild a valid request.
+         */
+        issues: Array<{
+            /**
+             * Dot-separated field path, or "(root)" for top-level.
+             */
+            path: string;
+            message: string;
+            /**
+             * Zod issue code (invalid_type, too_small, too_big, invalid_string, ...).
+             */
+            code?: string;
+            /**
+             * Expected type for invalid_type.
+             */
+            expected?: string;
+            /**
+             * Minimum bound for too_small issues.
+             */
+            minimum?: number | string;
+            /**
+             * Maximum bound for too_big issues.
+             */
+            maximum?: number | string;
+            inclusive?: boolean;
+            /**
+             * Format name for string issues (regex, email, url, uuid).
+             */
+            format?: string;
+            /**
+             * Regex pattern when format is regex.
+             */
+            pattern?: string;
+        }>;
+    };
+    /**
+     * Invalid or missing API key
+     */
+    401: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
+     */
+    405: {
+        error: string;
+        code: 'method_not_allowed';
+        /**
+         * Allowed HTTP methods for this path. Mirrors the Allow response header.
+         */
+        allow: Array<string>;
+        /**
+         * Link to the product page for this domain.
+         */
+        docs?: string;
+    };
+    /**
+     * Monthly rate limit exceeded
+     */
+    429: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Internal server error
+     */
+    500: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+};
+export type PostVedicAstrologyPanchangHoraError = PostVedicAstrologyPanchangHoraErrors[keyof PostVedicAstrologyPanchangHoraErrors];
+export type PostVedicAstrologyPanchangHoraResponses = {
     /**
-     * 8 daytime and 8 nighttime Choghadiya muhurta periods with names, ruling planets, auspiciousness ratings (Good/Bad), and exact start/end times based on sunrise and sunset.
+     * 12 daytime and 12 nighttime Hora (planetary hour) periods with ruling planet, sequence number, and exact start/end times based on sunrise and sunset.
      */
     200: {
+        /**
+         * Date for which hora periods were calculated.
+         */
         date: string;
         /**
-         * 8 daytime choghadiya periods (sunrise to sunset)
+         * 12 daytime hora periods from sunrise to sunset. Duration varies by season.
          */
-        dayChoghadiya: Array<{
-            /**
-             * Choghadiya muhurta name. Auspicious: Amrit (Moon), Shubh (Jupiter), Labh (Mercury), Char (Venus). Inauspicious: Udveg (Sun), Rog (Mars), Kaal (Saturn).
-             */
-            name: 'Udveg' | 'Amrit' | 'Rog' | 'Labh' | 'Shubh' | 'Char' | 'Kaal';
+        dayHoras: Array<{
             /**
-             * Ruling planet of this Choghadiya period. Planet determines the quality and suitability of activities during this muhurta.
+             * Ruling planet of this hora period. Follows the Chaldean planetary order: Sun, Venus, Mercury, Moon, Saturn, Jupiter, Mars.
              */
-            lord: string;
+            planet: string;
             /**
-             * Auspiciousness of this period. Good periods (Amrit, Shubh, Labh, Char) are suitable for important activities. Bad periods (Udveg, Rog, Kaal) should be avoided.
+             * Hora period number within the day or night segment (1-12).
              */
-            effect: 'Good' | 'Bad';
+            number: number;
             /**
-             * Period start time in ISO 8601 format. Timezone-adjusted based on input timezone offset.
+             * Start time of the hora period in ISO 8601 format.
              */
             start: string;
             /**
-             * Period end time in ISO 8601 format. Each Choghadiya period is one-eighth of the day or night duration.
+             * End time of the hora period in ISO 8601 format.
              */
             end: string;
         }>;
         /**
-         * 8 nighttime choghadiya periods (sunset to next sunrise)
+         * 12 nighttime hora periods from sunset to next sunrise. Duration varies by season.
          */
-        nightChoghadiya: Array<{
-            /**
-             * Choghadiya muhurta name. Auspicious: Amrit (Moon), Shubh (Jupiter), Labh (Mercury), Char (Venus). Inauspicious: Udveg (Sun), Rog (Mars), Kaal (Saturn).
-             */
-            name: 'Udveg' | 'Amrit' | 'Rog' | 'Labh' | 'Shubh' | 'Char' | 'Kaal';
+        nightHoras: Array<{
             /**
-             * Ruling planet of this Choghadiya period. Planet determines the quality and suitability of activities during this muhurta.
+             * Ruling planet of this hora period. Follows the Chaldean planetary order: Sun, Venus, Mercury, Moon, Saturn, Jupiter, Mars.
              */
-            lord: string;
+            planet: string;
             /**
-             * Auspiciousness of this period. Good periods (Amrit, Shubh, Labh, Char) are suitable for important activities. Bad periods (Udveg, Rog, Kaal) should be avoided.
+             * Hora period number within the day or night segment (1-12).
              */
-            effect: 'Good' | 'Bad';
+            number: number;
             /**
-             * Period start time in ISO 8601 format. Timezone-adjusted based on input timezone offset.
+             * Start time of the hora period in ISO 8601 format.
              */
             start: string;
             /**
-             * Period end time in ISO 8601 format. Each Choghadiya period is one-eighth of the day or night duration.
+             * End time of the hora period in ISO 8601 format.
              */
             end: string;
         }>;
     };
 };
-export type PostVedicAstrologyPanchangChoghadiyaResponse = PostVedicAstrologyPanchangChoghadiyaResponses[keyof PostVedicAstrologyPanchangChoghadiyaResponses];
-export type PostVedicAstrologyPanchangHoraData = {
-    body?: {
-        /**
-         * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected.
-         */
-        date: string;
-        /**
-         * Observer latitude in decimal degrees. Determines sunrise and sunset times which define day/night boundaries for muhurta calculations.
-         */
-        latitude: number;
-        /**
-         * Observer longitude in decimal degrees. Affects local time calculations for sunrise, sunset, and muhurta period boundaries.
-         */
-        longitude: number;
+export type PostVedicAstrologyPanchangHoraResponse = PostVedicAstrologyPanchangHoraResponses[keyof PostVedicAstrologyPanchangHoraResponses];
+export type PostVedicAstrologyDoshaManglikData = {
+    body?: ManglikRequest;
+    path?: never;
+    query?: {
         /**
-         * Timezone offset from UTC in decimal hours. Used for accurate sunrise/sunset calculation and output time formatting. Essential for correct Hora periods outside IST. Defaults to 5.5 (IST).
+         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
          */
-        timezone?: number | string;
+        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
     };
-    path?: never;
-    query?: never;
-    url: '/vedic-astrology/panchang/hora';
+    url: '/vedic-astrology/dosha/manglik';
 };
-export type PostVedicAstrologyPanchangHoraErrors = {
+export type PostVedicAstrologyDoshaManglikErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -17571,68 +18843,26 @@ export type PostVedicAstrologyPanchangHoraErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyPanchangHoraError = PostVedicAstrologyPanchangHoraErrors[keyof PostVedicAstrologyPanchangHoraErrors];
-export type PostVedicAstrologyPanchangHoraResponses = {
+export type PostVedicAstrologyDoshaManglikError = PostVedicAstrologyDoshaManglikErrors[keyof PostVedicAstrologyDoshaManglikErrors];
+export type PostVedicAstrologyDoshaManglikResponses = {
     /**
-     * 12 daytime and 12 nighttime Hora (planetary hour) periods with ruling planet, sequence number, and exact start/end times based on sunrise and sunset.
+     * Manglik dosha detection result with severity, Mars house placement, cancellation exceptions, traditional remedies, and effects on marriage and personality.
      */
-    200: {
-        /**
-         * Date for which hora periods were calculated.
-         */
-        date: string;
-        /**
-         * 12 daytime hora periods from sunrise to sunset. Duration varies by season.
-         */
-        dayHoras: Array<{
-            /**
-             * Ruling planet of this hora period. Follows the Chaldean planetary order: Sun, Venus, Mercury, Moon, Saturn, Jupiter, Mars.
-             */
-            planet: string;
-            /**
-             * Hora period number within the day or night segment (1-12).
-             */
-            number: number;
-            /**
-             * Start time of the hora period in ISO 8601 format.
-             */
-            start: string;
-            /**
-             * End time of the hora period in ISO 8601 format.
-             */
-            end: string;
-        }>;
+    200: ManglikResponse;
+};
+export type PostVedicAstrologyDoshaManglikResponse = PostVedicAstrologyDoshaManglikResponses[keyof PostVedicAstrologyDoshaManglikResponses];
+export type PostVedicAstrologyDoshaKalsarpaData = {
+    body?: KalsarpaRequest;
+    path?: never;
+    query?: {
         /**
-         * 12 nighttime hora periods from sunset to next sunrise. Duration varies by season.
+         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
          */
-        nightHoras: Array<{
-            /**
-             * Ruling planet of this hora period. Follows the Chaldean planetary order: Sun, Venus, Mercury, Moon, Saturn, Jupiter, Mars.
-             */
-            planet: string;
-            /**
-             * Hora period number within the day or night segment (1-12).
-             */
-            number: number;
-            /**
-             * Start time of the hora period in ISO 8601 format.
-             */
-            start: string;
-            /**
-             * End time of the hora period in ISO 8601 format.
-             */
-            end: string;
-        }>;
+        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
     };
+    url: '/vedic-astrology/dosha/kalsarpa';
 };
-export type PostVedicAstrologyPanchangHoraResponse = PostVedicAstrologyPanchangHoraResponses[keyof PostVedicAstrologyPanchangHoraResponses];
-export type PostVedicAstrologyDoshaManglikData = {
-    body?: ManglikRequest;
-    path?: never;
-    query?: never;
-    url: '/vedic-astrology/dosha/manglik';
-};
-export type PostVedicAstrologyDoshaManglikErrors = {
+export type PostVedicAstrologyDoshaKalsarpaErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -17733,21 +18963,26 @@ export type PostVedicAstrologyDoshaManglikErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyDoshaManglikError = PostVedicAstrologyDoshaManglikErrors[keyof PostVedicAstrologyDoshaManglikErrors];
-export type PostVedicAstrologyDoshaManglikResponses = {
+export type PostVedicAstrologyDoshaKalsarpaError = PostVedicAstrologyDoshaKalsarpaErrors[keyof PostVedicAstrologyDoshaKalsarpaErrors];
+export type PostVedicAstrologyDoshaKalsarpaResponses = {
     /**
-     * Manglik dosha detection result with severity, Mars house placement, cancellation exceptions, traditional remedies, and effects on marriage and personality.
+     * Kalsarpa dosha detection result with type identification (1 of 12 types), severity, Rahu-Ketu axis details, traditional remedies, and effects on career, health, and relationships.
      */
-    200: ManglikResponse;
+    200: KalsarpaResponse;
 };
-export type PostVedicAstrologyDoshaManglikResponse = PostVedicAstrologyDoshaManglikResponses[keyof PostVedicAstrologyDoshaManglikResponses];
-export type PostVedicAstrologyDoshaKalsarpaData = {
-    body?: KalsarpaRequest;
+export type PostVedicAstrologyDoshaKalsarpaResponse = PostVedicAstrologyDoshaKalsarpaResponses[keyof PostVedicAstrologyDoshaKalsarpaResponses];
+export type PostVedicAstrologyDoshaSadhesatiData = {
+    body?: SadhesatiRequest;
     path?: never;
-    query?: never;
-    url: '/vedic-astrology/dosha/kalsarpa';
+    query?: {
+        /**
+         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
+         */
+        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
+    };
+    url: '/vedic-astrology/dosha/sadhesati';
 };
-export type PostVedicAstrologyDoshaKalsarpaErrors = {
+export type PostVedicAstrologyDoshaSadhesatiErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -17848,21 +19083,30 @@ export type PostVedicAstrologyDoshaKalsarpaErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyDoshaKalsarpaError = PostVedicAstrologyDoshaKalsarpaErrors[keyof PostVedicAstrologyDoshaKalsarpaErrors];
-export type PostVedicAstrologyDoshaKalsarpaResponses = {
+export type PostVedicAstrologyDoshaSadhesatiError = PostVedicAstrologyDoshaSadhesatiErrors[keyof PostVedicAstrologyDoshaSadhesatiErrors];
+export type PostVedicAstrologyDoshaSadhesatiResponses = {
     /**
-     * Kalsarpa dosha detection result with type identification (1 of 12 types), severity, Rahu-Ketu axis details, traditional remedies, and effects on career, health, and relationships.
+     * Sade Sati detection result with current phase (Rising/Peak/Setting), Saturn transit position relative to natal Moon, severity, traditional Shani remedies, and phase-specific effects.
      */
-    200: KalsarpaResponse;
+    200: SadhesatiResponse;
 };
-export type PostVedicAstrologyDoshaKalsarpaResponse = PostVedicAstrologyDoshaKalsarpaResponses[keyof PostVedicAstrologyDoshaKalsarpaResponses];
-export type PostVedicAstrologyDoshaSadhesatiData = {
-    body?: SadhesatiRequest;
+export type PostVedicAstrologyDoshaSadhesatiResponse = PostVedicAstrologyDoshaSadhesatiResponses[keyof PostVedicAstrologyDoshaSadhesatiResponses];
+export type GetVedicAstrologyYogaData = {
+    body?: never;
     path?: never;
-    query?: never;
-    url: '/vedic-astrology/dosha/sadhesati';
+    query?: {
+        /**
+         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
+         */
+        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
+        /**
+         * Filter the catalog to one Nabhasa family: asraya (3), dala (2), akriti (20) or sankhya (7). Omit for the full catalog. `classical` is accepted but matches nothing here, because it is a detection-verdict value for single-combination yogas rather than a catalog grouping.
+         */
+        family?: 'classical' | 'asraya' | 'dala' | 'akriti' | 'sankhya';
+    };
+    url: '/vedic-astrology/yoga';
 };
-export type PostVedicAstrologyDoshaSadhesatiErrors = {
+export type GetVedicAstrologyYogaErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -17963,30 +19207,53 @@ export type PostVedicAstrologyDoshaSadhesatiErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyDoshaSadhesatiError = PostVedicAstrologyDoshaSadhesatiErrors[keyof PostVedicAstrologyDoshaSadhesatiErrors];
-export type PostVedicAstrologyDoshaSadhesatiResponses = {
+export type GetVedicAstrologyYogaError = GetVedicAstrologyYogaErrors[keyof GetVedicAstrologyYogaErrors];
+export type GetVedicAstrologyYogaResponses = {
     /**
-     * Sade Sati detection result with current phase (Rising/Peak/Setting), Saturn transit position relative to natal Moon, severity, traditional Shani remedies, and phase-specific effects.
+     * List of all yogas (basic info)
      */
-    200: SadhesatiResponse;
+    200: {
+        /**
+         * Array of planetary yogas with basic identifiers, narrowed by `family` when that filter is supplied. Use GET /yoga/{id} for formation rules, effects, and quality classification.
+         */
+        yogas: Array<{
+            /**
+             * Unique yoga identifier in lowercase kebab-case. Use this to fetch full details via GET /yoga/{id}.
+             */
+            id: string;
+            /**
+             * Traditional Sanskrit name of the planetary yoga combination.
+             */
+            name: string;
+            /**
+             * Nabhasa family, present only on the 32 Nabhasa distribution yogas and absent on every other catalog row. Never translated, so it groups identically under any lang.
+             */
+            family?: 'classical' | 'asraya' | 'dala' | 'akriti' | 'sankhya';
+        }>;
+        /**
+         * Number of yogas in this response, which is the filtered count when `family` is supplied and the full catalog size otherwise. Includes Raj Yogas, Dhan Yogas, Pancha Mahapurusha Yogas, Nabhasa Yogas, and more.
+         */
+        total: number;
+    };
 };
-export type PostVedicAstrologyDoshaSadhesatiResponse = PostVedicAstrologyDoshaSadhesatiResponses[keyof PostVedicAstrologyDoshaSadhesatiResponses];
-export type GetVedicAstrologyYogaData = {
+export type GetVedicAstrologyYogaResponse = GetVedicAstrologyYogaResponses[keyof GetVedicAstrologyYogaResponses];
+export type GetVedicAstrologyYogaByIdData = {
     body?: never;
-    path?: never;
+    path: {
+        /**
+         * Yoga identifier (lowercase, hyphenated)
+         */
+        id: 'gajakesari' | 'sunapha' | 'anapha' | 'dhurdhura' | 'kemadruma' | 'chandramangala' | 'adhi' | 'chatussagara' | 'vasumathi' | 'rajalakshana' | 'vanchanachorabheethi' | 'sakata' | 'amala' | 'parvata' | 'kahala' | 'vesi' | 'vasi' | 'obhayachari' | 'hamsa' | 'malavya' | 'sasa' | 'ruchaka' | 'bhadra' | 'budhaaditya' | 'mahabhagya' | 'pushkala' | 'lakshmi' | 'gauri' | 'bharathi' | 'chapa' | 'sreenatha' | 'lagnamalika' | 'dhanamalika' | 'vikramamalika' | 'sukhamalika' | 'putramalika' | 'satrumalika' | 'kalatramalika' | 'randhramalika' | 'bhagyamalika' | 'karmamalika' | 'labhamalika' | 'vrayamalika' | 'sankha' | 'bheri' | 'mridanga' | 'parijatha' | 'gaja' | 'kalanidhi' | 'amsavatara' | 'hariharabrahma' | 'kusuma' | 'matsya' | 'kurma' | 'devendra' | 'makuta' | 'chandika' | 'jaya' | 'vidyut' | 'gandharva' | 'siva' | 'vishnu' | 'brahma' | 'indra' | 'ravi' | 'garuda' | 'go' | 'gola' | 'thrilochana' | 'kulavardhana' | 'yupa' | 'ishu' | 'sakti' | 'danda' | 'nav' | 'kuta' | 'chhatra' | 'chapa-2' | 'ardhachandra' | 'chandra' | 'gada' | 'sakata-2' | 'vihaga' | 'vajra' | 'yava' | 'sringhataka' | 'hala' | 'kamala' | 'vapee' | 'samudra' | 'vallaki' | 'damni' | 'pasa' | 'kedara' | 'sula' | 'yuga' | 'gola-2' | 'rajju' | 'musala' | 'nala' | 'srik' | 'mala' | 'sarpa' | 'duryoga' | 'daridra' | 'harsha' | 'sarala' | 'vimala' | 'sareerasoukhya' | 'dehapushti' | 'dehakashta' | 'rogagrastha' | 'krisanga' | 'krisanga-2' | 'dehasthoulya' | 'dehasthoulya-2' | 'dehasthoulya-3' | 'sadasanchara' | 'dhana' | 'dhana-2' | 'dhana-3' | 'dhana-4' | 'dhana-5' | 'dhana-6' | 'dhana-7' | 'dhana-8' | 'dhana-9' | 'dhana-10' | 'dhana-11' | 'bahudravyarjana' | 'swaveeryaddhana' | 'swaveeryaddhana-2' | 'swaveeryaddhana-3' | 'madhyavayasidhana' | 'anthyavayasidhana' | 'balyadhana' | 'bhratrumooladdhanaprapti' | 'bhratrumooladdhanaprapti-2' | 'matrumooladdhana' | 'putramooladdhana' | 'satrumooladdhana' | 'kalatramooladdhana' | 'amarananthadhana' | 'ayatnadhanalabha' | 'daridra-2' | 'daridra-3' | 'daridra-4' | 'daridra-5' | 'daridra-6' | 'daridra-7' | 'daridra-8' | 'daridra-9' | 'daridra-10' | 'daridra-11' | 'yukthisamanwithavagmi' | 'yukthisamanwithavagmi-2' | 'parihasaka' | 'asatyavadi' | 'jada' | 'bhaskara' | 'marud' | 'saraswathi' | 'budha' | 'mooka' | 'netranasa' | 'andha' | 'sumukha' | 'sumukha-2' | 'durmukha' | 'durmukha-2' | 'bhojanasoukhya' | 'annadana' | 'parannabhojana' | 'sraddhannabhuktha' | 'sarpaganda' | 'vakchalana' | 'vishaprayoga' | 'bhratruvriddhi' | 'sodaranasa' | 'ekabhagini' | 'dwadasasahodara' | 'sapthasankhyasahodara' | 'parakrama' | 'yuddhapraveena' | 'yuddhatpoorvadridhachitta' | 'yuddhatpaschaddrudha' | 'satkathadisravana' | 'uttamagriha' | 'vichitrasaudhaprakara' | 'ayatnagrihaprapta' | 'ayatnagrihaprapta-2' | 'grihanasa' | 'grihanasa-2' | 'bandhupujya' | 'bandhupujya-2' | 'bandhubhisthyaktha' | 'matrudeerghayur' | 'matrudeerghayur-2' | 'matrunasa' | 'matrunasa-2' | 'matrugami' | 'sahodareesangama' | 'kapata' | 'kapata-2' | 'kapata-3' | 'nishkapata' | 'nishkapata-2' | 'matrusatrutwa' | 'matrusneha' | 'vahana' | 'vahana-2' | 'anapathya' | 'sarpasapa' | 'sarpasapa-2' | 'sarpasapa-3' | 'sarpasapa-4' | 'pitrusapasutakshaya' | 'matrusapasutakshaya' | 'bhratrusapasutakshaya' | 'pretasapa' | 'bahuputra' | 'bahuputra-2' | 'dattaputra' | 'dattaputra-2' | 'aputra' | 'ekaputra' | 'suputra' | 'kalanirdesatputra' | 'kalanirdesatputra-2' | 'kalanirdesatputranasa' | 'kalanirdesatputranasa-2' | 'buddhimaturya' | 'theevrabuddhi' | 'buddhijada' | 'thrikalagnana' | 'putrasukha' | 'jara' | 'jarajaputra' | 'bahustree' | 'satkalatra' | 'bhagachumbana' | 'bhagya' | 'jananatpurvampitrumarana' | 'dhatrutwa' | 'apakeerti' | 'raja' | 'raja-2' | 'raja-3' | 'raja-4' | 'raja-5' | 'raja-6' | 'raja-7' | 'raja-8' | 'raja-9' | 'raja-10' | 'raja-11' | 'raja-12' | 'raja-13' | 'raja-14' | 'raja-15' | 'raja-16' | 'raja-17' | 'raja-18' | 'raja-19' | 'galakarna' | 'vrana' | 'sisnavyadhi' | 'kalatrashanda' | 'kushtaroga' | 'kushtaroga-2' | 'kshayaroga' | 'bandhana' | 'karascheda' | 'sirachcheda' | 'durmarana' | 'yuddhemarana' | 'sanghatakamarana' | 'sanghatakamarana-2' | 'peenasaroga' | 'pittaroga' | 'vikalangapatni' | 'putrakalatraheena' | 'bharyasahavyabhichara' | 'vamsacheda' | 'guhyaroga' | 'angaheena' | 'swetakushta' | 'pisachagrastha' | 'andha-2' | 'andha-3' | 'vatharoga' | 'matibhramana' | 'matibhramana-2' | 'matibhramana-3' | 'matibhramana-4' | 'khalwata' | 'nishturabhashi' | 'rajabhrashta' | 'raja-20' | 'raja-21' | 'gohanta';
+    };
     query?: {
         /**
          * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
          */
         lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
-        /**
-         * Filter the catalog to one Nabhasa family: asraya (3), dala (2), akriti (20) or sankhya (7). Omit for the full catalog. `classical` is accepted but matches nothing here, because it is a detection-verdict value for single-combination yogas rather than a catalog grouping.
-         */
-        family?: 'classical' | 'asraya' | 'dala' | 'akriti' | 'sankhya';
     };
-    url: '/vedic-astrology/yoga';
+    url: '/vedic-astrology/yoga/{id}';
 };
-export type GetVedicAstrologyYogaErrors = {
+export type GetVedicAstrologyYogaByIdErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -18045,6 +19312,19 @@ export type GetVedicAstrologyYogaErrors = {
          */
         code: string;
     };
+    /**
+     * Yoga not found
+     */
+    404: {
+        /**
+         * Human-readable error message. May change wording — do not parse programmatically.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier for programmatic error handling.
+         */
+        code: string;
+    };
     /**
      * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
      */
@@ -18087,53 +19367,26 @@ export type GetVedicAstrologyYogaErrors = {
         code: string;
     };
 };
-export type GetVedicAstrologyYogaError = GetVedicAstrologyYogaErrors[keyof GetVedicAstrologyYogaErrors];
-export type GetVedicAstrologyYogaResponses = {
+export type GetVedicAstrologyYogaByIdError = GetVedicAstrologyYogaByIdErrors[keyof GetVedicAstrologyYogaByIdErrors];
+export type GetVedicAstrologyYogaByIdResponses = {
     /**
-     * List of all yogas (basic info)
+     * Detailed yoga information
      */
-    200: {
-        /**
-         * Array of planetary yogas with basic identifiers, narrowed by `family` when that filter is supplied. Use GET /yoga/{id} for formation rules, effects, and quality classification.
-         */
-        yogas: Array<{
-            /**
-             * Unique yoga identifier in lowercase kebab-case. Use this to fetch full details via GET /yoga/{id}.
-             */
-            id: string;
-            /**
-             * Traditional Sanskrit name of the planetary yoga combination.
-             */
-            name: string;
-            /**
-             * Nabhasa family, present only on the 32 Nabhasa distribution yogas and absent on every other catalog row. Never translated, so it groups identically under any lang.
-             */
-            family?: 'classical' | 'asraya' | 'dala' | 'akriti' | 'sankhya';
-        }>;
-        /**
-         * Number of yogas in this response, which is the filtered count when `family` is supplied and the full catalog size otherwise. Includes Raj Yogas, Dhan Yogas, Pancha Mahapurusha Yogas, Nabhasa Yogas, and more.
-         */
-        total: number;
-    };
+    200: YogaDetail;
 };
-export type GetVedicAstrologyYogaResponse = GetVedicAstrologyYogaResponses[keyof GetVedicAstrologyYogaResponses];
-export type GetVedicAstrologyYogaByIdData = {
-    body?: never;
-    path: {
-        /**
-         * Yoga identifier (lowercase, hyphenated)
-         */
-        id: 'gajakesari' | 'sunapha' | 'anapha' | 'dhurdhura' | 'kemadruma' | 'chandramangala' | 'adhi' | 'chatussagara' | 'vasumathi' | 'rajalakshana' | 'vanchanachorabheethi' | 'sakata' | 'amala' | 'parvata' | 'kahala' | 'vesi' | 'vasi' | 'obhayachari' | 'hamsa' | 'malavya' | 'sasa' | 'ruchaka' | 'bhadra' | 'budhaaditya' | 'mahabhagya' | 'pushkala' | 'lakshmi' | 'gauri' | 'bharathi' | 'chapa' | 'sreenatha' | 'lagnamalika' | 'dhanamalika' | 'vikramamalika' | 'sukhamalika' | 'putramalika' | 'satrumalika' | 'kalatramalika' | 'randhramalika' | 'bhagyamalika' | 'karmamalika' | 'labhamalika' | 'vrayamalika' | 'sankha' | 'bheri' | 'mridanga' | 'parijatha' | 'gaja' | 'kalanidhi' | 'amsavatara' | 'hariharabrahma' | 'kusuma' | 'matsya' | 'kurma' | 'devendra' | 'makuta' | 'chandika' | 'jaya' | 'vidyut' | 'gandharva' | 'siva' | 'vishnu' | 'brahma' | 'indra' | 'ravi' | 'garuda' | 'go' | 'gola' | 'thrilochana' | 'kulavardhana' | 'yupa' | 'ishu' | 'sakti' | 'danda' | 'nav' | 'kuta' | 'chhatra' | 'chapa-2' | 'ardhachandra' | 'chandra' | 'gada' | 'sakata-2' | 'vihaga' | 'vajra' | 'yava' | 'sringhataka' | 'hala' | 'kamala' | 'vapee' | 'samudra' | 'vallaki' | 'damni' | 'pasa' | 'kedara' | 'sula' | 'yuga' | 'gola-2' | 'rajju' | 'musala' | 'nala' | 'srik' | 'mala' | 'sarpa' | 'duryoga' | 'daridra' | 'harsha' | 'sarala' | 'vimala' | 'sareerasoukhya' | 'dehapushti' | 'dehakashta' | 'rogagrastha' | 'krisanga' | 'krisanga-2' | 'dehasthoulya' | 'dehasthoulya-2' | 'dehasthoulya-3' | 'sadasanchara' | 'dhana' | 'dhana-2' | 'dhana-3' | 'dhana-4' | 'dhana-5' | 'dhana-6' | 'dhana-7' | 'dhana-8' | 'dhana-9' | 'dhana-10' | 'dhana-11' | 'bahudravyarjana' | 'swaveeryaddhana' | 'swaveeryaddhana-2' | 'swaveeryaddhana-3' | 'madhyavayasidhana' | 'anthyavayasidhana' | 'balyadhana' | 'bhratrumooladdhanaprapti' | 'bhratrumooladdhanaprapti-2' | 'matrumooladdhana' | 'putramooladdhana' | 'satrumooladdhana' | 'kalatramooladdhana' | 'amarananthadhana' | 'ayatnadhanalabha' | 'daridra-2' | 'daridra-3' | 'daridra-4' | 'daridra-5' | 'daridra-6' | 'daridra-7' | 'daridra-8' | 'daridra-9' | 'daridra-10' | 'daridra-11' | 'yukthisamanwithavagmi' | 'yukthisamanwithavagmi-2' | 'parihasaka' | 'asatyavadi' | 'jada' | 'bhaskara' | 'marud' | 'saraswathi' | 'budha' | 'mooka' | 'netranasa' | 'andha' | 'sumukha' | 'sumukha-2' | 'durmukha' | 'durmukha-2' | 'bhojanasoukhya' | 'annadana' | 'parannabhojana' | 'sraddhannabhuktha' | 'sarpaganda' | 'vakchalana' | 'vishaprayoga' | 'bhratruvriddhi' | 'sodaranasa' | 'ekabhagini' | 'dwadasasahodara' | 'sapthasankhyasahodara' | 'parakrama' | 'yuddhapraveena' | 'yuddhatpoorvadridhachitta' | 'yuddhatpaschaddrudha' | 'satkathadisravana' | 'uttamagriha' | 'vichitrasaudhaprakara' | 'ayatnagrihaprapta' | 'ayatnagrihaprapta-2' | 'grihanasa' | 'grihanasa-2' | 'bandhupujya' | 'bandhupujya-2' | 'bandhubhisthyaktha' | 'matrudeerghayur' | 'matrudeerghayur-2' | 'matrunasa' | 'matrunasa-2' | 'matrugami' | 'sahodareesangama' | 'kapata' | 'kapata-2' | 'kapata-3' | 'nishkapata' | 'nishkapata-2' | 'matrusatrutwa' | 'matrusneha' | 'vahana' | 'vahana-2' | 'anapathya' | 'sarpasapa' | 'sarpasapa-2' | 'sarpasapa-3' | 'sarpasapa-4' | 'pitrusapasutakshaya' | 'matrusapasutakshaya' | 'bhratrusapasutakshaya' | 'pretasapa' | 'bahuputra' | 'bahuputra-2' | 'dattaputra' | 'dattaputra-2' | 'aputra' | 'ekaputra' | 'suputra' | 'kalanirdesatputra' | 'kalanirdesatputra-2' | 'kalanirdesatputranasa' | 'kalanirdesatputranasa-2' | 'buddhimaturya' | 'theevrabuddhi' | 'buddhijada' | 'thrikalagnana' | 'putrasukha' | 'jara' | 'jarajaputra' | 'bahustree' | 'satkalatra' | 'bhagachumbana' | 'bhagya' | 'jananatpurvampitrumarana' | 'dhatrutwa' | 'apakeerti' | 'raja' | 'raja-2' | 'raja-3' | 'raja-4' | 'raja-5' | 'raja-6' | 'raja-7' | 'raja-8' | 'raja-9' | 'raja-10' | 'raja-11' | 'raja-12' | 'raja-13' | 'raja-14' | 'raja-15' | 'raja-16' | 'raja-17' | 'raja-18' | 'raja-19' | 'galakarna' | 'vrana' | 'sisnavyadhi' | 'kalatrashanda' | 'kushtaroga' | 'kushtaroga-2' | 'kshayaroga' | 'bandhana' | 'karascheda' | 'sirachcheda' | 'durmarana' | 'yuddhemarana' | 'sanghatakamarana' | 'sanghatakamarana-2' | 'peenasaroga' | 'pittaroga' | 'vikalangapatni' | 'putrakalatraheena' | 'bharyasahavyabhichara' | 'vamsacheda' | 'guhyaroga' | 'angaheena' | 'swetakushta' | 'pisachagrastha' | 'andha-2' | 'andha-3' | 'vatharoga' | 'matibhramana' | 'matibhramana-2' | 'matibhramana-3' | 'matibhramana-4' | 'khalwata' | 'nishturabhashi' | 'rajabhrashta' | 'raja-20' | 'raja-21' | 'gohanta';
-    };
+export type GetVedicAstrologyYogaByIdResponse = GetVedicAstrologyYogaByIdResponses[keyof GetVedicAstrologyYogaByIdResponses];
+export type PostVedicAstrologyYogaDetectData = {
+    body?: YogaDetectRequest;
+    path?: never;
     query?: {
         /**
          * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
          */
         lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
     };
-    url: '/vedic-astrology/yoga/{id}';
+    url: '/vedic-astrology/yoga/detect';
 };
-export type GetVedicAstrologyYogaByIdErrors = {
+export type PostVedicAstrologyYogaDetectErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -18192,19 +19445,6 @@ export type GetVedicAstrologyYogaByIdErrors = {
          */
         code: string;
     };
-    /**
-     * Yoga not found
-     */
-    404: {
-        /**
-         * Human-readable error message. May change wording — do not parse programmatically.
-         */
-        error: string;
-        /**
-         * Machine-readable error code. Stable identifier for programmatic error handling.
-         */
-        code: string;
-    };
     /**
      * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
      */
@@ -18247,26 +19487,34 @@ export type GetVedicAstrologyYogaByIdErrors = {
         code: string;
     };
 };
-export type GetVedicAstrologyYogaByIdError = GetVedicAstrologyYogaByIdErrors[keyof GetVedicAstrologyYogaByIdErrors];
-export type GetVedicAstrologyYogaByIdResponses = {
+export type PostVedicAstrologyYogaDetectError = PostVedicAstrologyYogaDetectErrors[keyof PostVedicAstrologyYogaDetectErrors];
+export type PostVedicAstrologyYogaDetectResponses = {
     /**
-     * Detailed yoga information
+     * List of 44 classical yogas with present/absent verdicts and classical-text evidence.
      */
-    200: YogaDetail;
+    200: YogaDetectResponse;
 };
-export type GetVedicAstrologyYogaByIdResponse = GetVedicAstrologyYogaByIdResponses[keyof GetVedicAstrologyYogaByIdResponses];
-export type PostVedicAstrologyYogaDetectData = {
-    body?: YogaDetectRequest;
+export type PostVedicAstrologyYogaDetectResponse = PostVedicAstrologyYogaDetectResponses[keyof PostVedicAstrologyYogaDetectResponses];
+export type GetVedicAstrologyKpAyanamsaData = {
+    body?: never;
     path?: never;
     query?: {
         /**
-         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
+         * Date for ayanamsa calculation in YYYY-MM-DD format. Defaults to today if not provided. Ayanamsa changes by ~0.01 degrees per month due to the precession of Earth.
          */
-        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
+        date?: string;
+        /**
+         * Time of day in 24-hour HH:MM:SS format, interpreted in the timezone below. Omit for midnight UTC. The ayanamsa moves about 0.14 arcseconds across a day, so supplying the time matters only when reconciling a chart against reference software to the arcsecond.
+         */
+        time?: string;
+        /**
+         * IANA name (e.g. "Asia/Kolkata", "America/New_York"), decimal hours (e.g. 5.5 for IST, -5 for EST), or a fixed UTC offset (e.g. "+05:30"). IANA resolved to the DST-correct offset for the given date. Applies to the time field above. Defaults to 0 (UTC).
+         */
+        timezone?: string;
     };
-    url: '/vedic-astrology/yoga/detect';
+    url: '/vedic-astrology/kp/ayanamsa';
 };
-export type PostVedicAstrologyYogaDetectErrors = {
+export type GetVedicAstrologyKpAyanamsaErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -18367,34 +19615,21 @@ export type PostVedicAstrologyYogaDetectErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyYogaDetectError = PostVedicAstrologyYogaDetectErrors[keyof PostVedicAstrologyYogaDetectErrors];
-export type PostVedicAstrologyYogaDetectResponses = {
+export type GetVedicAstrologyKpAyanamsaError = GetVedicAstrologyKpAyanamsaErrors[keyof GetVedicAstrologyKpAyanamsaErrors];
+export type GetVedicAstrologyKpAyanamsaResponses = {
     /**
-     * List of 44 classical yogas with present/absent verdicts and classical-text evidence.
+     * Successfully calculated KP-Newcomb ayanamsa
      */
-    200: YogaDetectResponse;
+    200: KpAyanamsaResponse;
 };
-export type PostVedicAstrologyYogaDetectResponse = PostVedicAstrologyYogaDetectResponses[keyof PostVedicAstrologyYogaDetectResponses];
-export type GetVedicAstrologyKpAyanamsaData = {
-    body?: never;
+export type GetVedicAstrologyKpAyanamsaResponse = GetVedicAstrologyKpAyanamsaResponses[keyof GetVedicAstrologyKpAyanamsaResponses];
+export type PostVedicAstrologyKpPlanetsData = {
+    body?: KpPlanetsRequest;
     path?: never;
-    query?: {
-        /**
-         * Date for ayanamsa calculation in YYYY-MM-DD format. Defaults to today if not provided. Ayanamsa changes by ~0.01 degrees per month due to the precession of Earth.
-         */
-        date?: string;
-        /**
-         * Time of day in 24-hour HH:MM:SS format, interpreted in the timezone below. Omit for midnight UTC. The ayanamsa moves about 0.14 arcseconds across a day, so supplying the time matters only when reconciling a chart against reference software to the arcsecond.
-         */
-        time?: string;
-        /**
-         * IANA name (e.g. "Asia/Kolkata", "America/New_York"), decimal hours (e.g. 5.5 for IST, -5 for EST), or a fixed UTC offset (e.g. "+05:30"). IANA resolved to the DST-correct offset for the given date. Applies to the time field above. Defaults to 0 (UTC).
-         */
-        timezone?: string;
-    };
-    url: '/vedic-astrology/kp/ayanamsa';
+    query?: never;
+    url: '/vedic-astrology/kp/planets';
 };
-export type GetVedicAstrologyKpAyanamsaErrors = {
+export type PostVedicAstrologyKpPlanetsErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -18495,21 +19730,30 @@ export type GetVedicAstrologyKpAyanamsaErrors = {
         code: string;
     };
 };
-export type GetVedicAstrologyKpAyanamsaError = GetVedicAstrologyKpAyanamsaErrors[keyof GetVedicAstrologyKpAyanamsaErrors];
-export type GetVedicAstrologyKpAyanamsaResponses = {
+export type PostVedicAstrologyKpPlanetsError = PostVedicAstrologyKpPlanetsErrors[keyof PostVedicAstrologyKpPlanetsErrors];
+export type PostVedicAstrologyKpPlanetsResponses = {
     /**
-     * Successfully calculated KP-Newcomb ayanamsa
+     * Successfully calculated KP planetary positions
      */
-    200: KpAyanamsaResponse;
+    200: KpPlanetsResponse;
 };
-export type GetVedicAstrologyKpAyanamsaResponse = GetVedicAstrologyKpAyanamsaResponses[keyof GetVedicAstrologyKpAyanamsaResponses];
-export type PostVedicAstrologyKpPlanetsData = {
-    body?: KpPlanetsRequest;
+export type PostVedicAstrologyKpPlanetsResponse = PostVedicAstrologyKpPlanetsResponses[keyof PostVedicAstrologyKpPlanetsResponses];
+export type PostVedicAstrologyKpCuspsData = {
+    body?: KpCuspsRequest;
     path?: never;
-    query?: never;
-    url: '/vedic-astrology/kp/planets';
+    query?: {
+        /**
+         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
+         */
+        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
+        /**
+         * Which signification vocabulary the houseThemes map returns. "general" gives the classical bhava significations (self, wealth, siblings, home, and so on). "finance" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use "finance" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to "general".
+         */
+        focus?: 'general' | 'finance';
+    };
+    url: '/vedic-astrology/kp/cusps';
 };
-export type PostVedicAstrologyKpPlanetsErrors = {
+export type PostVedicAstrologyKpCuspsErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -18610,16 +19854,16 @@ export type PostVedicAstrologyKpPlanetsErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyKpPlanetsError = PostVedicAstrologyKpPlanetsErrors[keyof PostVedicAstrologyKpPlanetsErrors];
-export type PostVedicAstrologyKpPlanetsResponses = {
+export type PostVedicAstrologyKpCuspsError = PostVedicAstrologyKpCuspsErrors[keyof PostVedicAstrologyKpCuspsErrors];
+export type PostVedicAstrologyKpCuspsResponses = {
     /**
-     * Successfully calculated KP planetary positions
+     * Successfully calculated Placidus house cusps
      */
-    200: KpPlanetsResponse;
+    200: KpCuspsResponse;
 };
-export type PostVedicAstrologyKpPlanetsResponse = PostVedicAstrologyKpPlanetsResponses[keyof PostVedicAstrologyKpPlanetsResponses];
-export type PostVedicAstrologyKpCuspsData = {
-    body?: KpCuspsRequest;
+export type PostVedicAstrologyKpCuspsResponse = PostVedicAstrologyKpCuspsResponses[keyof PostVedicAstrologyKpCuspsResponses];
+export type PostVedicAstrologyKpChartData = {
+    body?: KpChartRequest;
     path?: never;
     query?: {
         /**
@@ -18631,9 +19875,9 @@ export type PostVedicAstrologyKpCuspsData = {
          */
         focus?: 'general' | 'finance';
     };
-    url: '/vedic-astrology/kp/cusps';
+    url: '/vedic-astrology/kp/chart';
 };
-export type PostVedicAstrologyKpCuspsErrors = {
+export type PostVedicAstrologyKpChartErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -18734,16 +19978,45 @@ export type PostVedicAstrologyKpCuspsErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyKpCuspsError = PostVedicAstrologyKpCuspsErrors[keyof PostVedicAstrologyKpCuspsErrors];
-export type PostVedicAstrologyKpCuspsResponses = {
+export type PostVedicAstrologyKpChartError = PostVedicAstrologyKpChartErrors[keyof PostVedicAstrologyKpChartErrors];
+export type PostVedicAstrologyKpChartResponses = {
     /**
-     * Successfully calculated Placidus house cusps
+     * Successfully generated KP birth chart
      */
-    200: KpCuspsResponse;
+    200: KpChartResponse;
 };
-export type PostVedicAstrologyKpCuspsResponse = PostVedicAstrologyKpCuspsResponses[keyof PostVedicAstrologyKpCuspsResponses];
-export type PostVedicAstrologyKpChartData = {
-    body?: KpChartRequest;
+export type PostVedicAstrologyKpChartResponse = PostVedicAstrologyKpChartResponses[keyof PostVedicAstrologyKpChartResponses];
+export type PostVedicAstrologyKpRulingPlanetsData = {
+    body?: {
+        /**
+         * Observer latitude in decimal degrees
+         */
+        latitude: number;
+        /**
+         * Observer longitude in decimal degrees
+         */
+        longitude: number;
+        /**
+         * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC. IANA resolved to the DST-correct offset based on birthDate or datetime. Defaults to 5.5.
+         */
+        timezone?: number | string;
+        /**
+         * ISO 8601 datetime (YYYY-MM-DDTHH:MM:SS) for ruling planets. Defaults to current time. Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.
+         */
+        datetime?: string;
+        /**
+         * Birth date (YYYY-MM-DD) to calculate significators. If provided with birthTime, response includes which houses each ruling planet signifies.
+         */
+        birthDate?: string;
+        /**
+         * Birth time (HH:MM:SS) for significator calculation. Required if birthDate is provided.
+         */
+        birthTime?: string;
+        /**
+         * Lunar node type for Rahu and Ketu positions. "mean" uses the smooth mean node (traditional Vedic astrology default). "true" uses the osculating node with perturbation corrections, oscillating up to 1.5 degrees from mean with a 173-day period. Impacts KP sub-lord assignments in narrow boundary cases. Defaults to "mean".
+         */
+        nodeType?: 'mean' | 'true';
+    };
     path?: never;
     query?: {
         /**
@@ -18755,9 +20028,9 @@ export type PostVedicAstrologyKpChartData = {
          */
         focus?: 'general' | 'finance';
     };
-    url: '/vedic-astrology/kp/chart';
+    url: '/vedic-astrology/kp/ruling-planets';
 };
-export type PostVedicAstrologyKpChartErrors = {
+export type PostVedicAstrologyKpRulingPlanetsErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -18858,16 +20131,28 @@ export type PostVedicAstrologyKpChartErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyKpChartError = PostVedicAstrologyKpChartErrors[keyof PostVedicAstrologyKpChartErrors];
-export type PostVedicAstrologyKpChartResponses = {
+export type PostVedicAstrologyKpRulingPlanetsError = PostVedicAstrologyKpRulingPlanetsErrors[keyof PostVedicAstrologyKpRulingPlanetsErrors];
+export type PostVedicAstrologyKpRulingPlanetsResponses = {
     /**
-     * Successfully generated KP birth chart
+     * Ruling planets calculated successfully
      */
-    200: KpChartResponse;
+    200: KpRulingPlanetsResponse;
 };
-export type PostVedicAstrologyKpChartResponse = PostVedicAstrologyKpChartResponses[keyof PostVedicAstrologyKpChartResponses];
-export type PostVedicAstrologyKpRulingPlanetsData = {
+export type PostVedicAstrologyKpRulingPlanetsResponse = PostVedicAstrologyKpRulingPlanetsResponses[keyof PostVedicAstrologyKpRulingPlanetsResponses];
+export type PostVedicAstrologyKpRulingPlanetsIntervalData = {
     body?: {
+        /**
+         * Start of the interval range in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.
+         */
+        startDatetime: string;
+        /**
+         * End of the interval range in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.
+         */
+        endDatetime: string;
+        /**
+         * Interval between calculations in minutes (1-1440). Use 1-5 for birth time rectification.
+         */
+        intervalMinutes: number;
         /**
          * Observer latitude in decimal degrees
          */
@@ -18877,21 +20162,13 @@ export type PostVedicAstrologyKpRulingPlanetsData = {
          */
         longitude: number;
         /**
-         * Timezone: IANA name (e.g. "America/New_York", "Europe/London") OR decimal hours from UTC. IANA resolved to the DST-correct offset based on birthDate or datetime. Defaults to 5.5.
+         * Timezone offset from UTC in decimal hours. When non-zero, all datetimes are treated as local time in this timezone (Z suffix is ignored). Output times are also converted to this timezone. Defaults to 5.5 (IST).
          */
         timezone?: number | string;
         /**
-         * ISO 8601 datetime (YYYY-MM-DDTHH:MM:SS) for ruling planets. Defaults to current time. Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.
-         */
-        datetime?: string;
-        /**
-         * Birth date (YYYY-MM-DD) to calculate significators. If provided with birthTime, response includes which houses each ruling planet signifies.
-         */
-        birthDate?: string;
-        /**
-         * Birth time (HH:MM:SS) for significator calculation. Required if birthDate is provided.
+         * Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. "kp-old" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. "lahiri" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. "raman" uses the B.V. Raman ayanamsa from Hindu Predictive Astrology, a recognised traditional school that sits about 1.45 degrees below Lahiri. Defaults to "kp-newcomb".
          */
-        birthTime?: string;
+        ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri' | 'raman';
         /**
          * Lunar node type for Rahu and Ketu positions. "mean" uses the smooth mean node (traditional Vedic astrology default). "true" uses the osculating node with perturbation corrections, oscillating up to 1.5 degrees from mean with a 173-day period. Impacts KP sub-lord assignments in narrow boundary cases. Defaults to "mean".
          */
@@ -18908,9 +20185,9 @@ export type PostVedicAstrologyKpRulingPlanetsData = {
          */
         focus?: 'general' | 'finance';
     };
-    url: '/vedic-astrology/kp/ruling-planets';
+    url: '/vedic-astrology/kp/ruling-planets-interval';
 };
-export type PostVedicAstrologyKpRulingPlanetsErrors = {
+export type PostVedicAstrologyKpRulingPlanetsIntervalErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -19011,63 +20288,21 @@ export type PostVedicAstrologyKpRulingPlanetsErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyKpRulingPlanetsError = PostVedicAstrologyKpRulingPlanetsErrors[keyof PostVedicAstrologyKpRulingPlanetsErrors];
-export type PostVedicAstrologyKpRulingPlanetsResponses = {
+export type PostVedicAstrologyKpRulingPlanetsIntervalError = PostVedicAstrologyKpRulingPlanetsIntervalErrors[keyof PostVedicAstrologyKpRulingPlanetsIntervalErrors];
+export type PostVedicAstrologyKpRulingPlanetsIntervalResponses = {
     /**
-     * Ruling planets calculated successfully
+     * Ruling planets with significators at intervals
      */
-    200: KpRulingPlanetsResponse;
+    200: KpRulingPlanetsIntervalResponse;
 };
-export type PostVedicAstrologyKpRulingPlanetsResponse = PostVedicAstrologyKpRulingPlanetsResponses[keyof PostVedicAstrologyKpRulingPlanetsResponses];
-export type PostVedicAstrologyKpRulingPlanetsIntervalData = {
-    body?: {
-        /**
-         * Start of the interval range in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.
-         */
-        startDatetime: string;
-        /**
-         * End of the interval range in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC.
-         */
-        endDatetime: string;
-        /**
-         * Interval between calculations in minutes (1-1440). Use 1-5 for birth time rectification.
-         */
-        intervalMinutes: number;
-        /**
-         * Observer latitude in decimal degrees
-         */
-        latitude: number;
-        /**
-         * Observer longitude in decimal degrees
-         */
-        longitude: number;
-        /**
-         * Timezone offset from UTC in decimal hours. When non-zero, all datetimes are treated as local time in this timezone (Z suffix is ignored). Output times are also converted to this timezone. Defaults to 5.5 (IST).
-         */
-        timezone?: number | string;
-        /**
-         * Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. "kp-old" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. "lahiri" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. Defaults to "kp-newcomb".
-         */
-        ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri';
-        /**
-         * Lunar node type for Rahu and Ketu positions. "mean" uses the smooth mean node (traditional Vedic astrology default). "true" uses the osculating node with perturbation corrections, oscillating up to 1.5 degrees from mean with a 173-day period. Impacts KP sub-lord assignments in narrow boundary cases. Defaults to "mean".
-         */
-        nodeType?: 'mean' | 'true';
-    };
+export type PostVedicAstrologyKpRulingPlanetsIntervalResponse = PostVedicAstrologyKpRulingPlanetsIntervalResponses[keyof PostVedicAstrologyKpRulingPlanetsIntervalResponses];
+export type PostVedicAstrologyKpSublordChangesData = {
+    body?: KpSublordChangesRequest;
     path?: never;
-    query?: {
-        /**
-         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
-         */
-        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
-        /**
-         * Which signification vocabulary the houseThemes map returns. "general" gives the classical bhava significations (self, wealth, siblings, home, and so on). "finance" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use "finance" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to "general".
-         */
-        focus?: 'general' | 'finance';
-    };
-    url: '/vedic-astrology/kp/ruling-planets-interval';
+    query?: never;
+    url: '/vedic-astrology/kp/sublord-changes';
 };
-export type PostVedicAstrologyKpRulingPlanetsIntervalErrors = {
+export type PostVedicAstrologyKpSublordChangesErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -19168,21 +20403,21 @@ export type PostVedicAstrologyKpRulingPlanetsIntervalErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyKpRulingPlanetsIntervalError = PostVedicAstrologyKpRulingPlanetsIntervalErrors[keyof PostVedicAstrologyKpRulingPlanetsIntervalErrors];
-export type PostVedicAstrologyKpRulingPlanetsIntervalResponses = {
+export type PostVedicAstrologyKpSublordChangesError = PostVedicAstrologyKpSublordChangesErrors[keyof PostVedicAstrologyKpSublordChangesErrors];
+export type PostVedicAstrologyKpSublordChangesResponses = {
     /**
-     * Ruling planets with significators at intervals
+     * Sublord change timings calculated successfully
      */
-    200: KpRulingPlanetsIntervalResponse;
+    200: KpSublordChangesResponse;
 };
-export type PostVedicAstrologyKpRulingPlanetsIntervalResponse = PostVedicAstrologyKpRulingPlanetsIntervalResponses[keyof PostVedicAstrologyKpRulingPlanetsIntervalResponses];
-export type PostVedicAstrologyKpSublordChangesData = {
-    body?: KpSublordChangesRequest;
+export type PostVedicAstrologyKpSublordChangesResponse = PostVedicAstrologyKpSublordChangesResponses[keyof PostVedicAstrologyKpSublordChangesResponses];
+export type PostVedicAstrologyKpRasiChangesData = {
+    body?: KpRasiChangesRequest;
     path?: never;
     query?: never;
-    url: '/vedic-astrology/kp/sublord-changes';
+    url: '/vedic-astrology/kp/rasi-changes';
 };
-export type PostVedicAstrologyKpSublordChangesErrors = {
+export type PostVedicAstrologyKpRasiChangesErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -19283,21 +20518,21 @@ export type PostVedicAstrologyKpSublordChangesErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyKpSublordChangesError = PostVedicAstrologyKpSublordChangesErrors[keyof PostVedicAstrologyKpSublordChangesErrors];
-export type PostVedicAstrologyKpSublordChangesResponses = {
+export type PostVedicAstrologyKpRasiChangesError = PostVedicAstrologyKpRasiChangesErrors[keyof PostVedicAstrologyKpRasiChangesErrors];
+export type PostVedicAstrologyKpRasiChangesResponses = {
     /**
-     * Sublord change timings calculated successfully
+     * Sign ingress timings calculated successfully
      */
-    200: KpSublordChangesResponse;
+    200: KpRasiChangesResponse;
 };
-export type PostVedicAstrologyKpSublordChangesResponse = PostVedicAstrologyKpSublordChangesResponses[keyof PostVedicAstrologyKpSublordChangesResponses];
-export type PostVedicAstrologyKpRasiChangesData = {
-    body?: KpRasiChangesRequest;
+export type PostVedicAstrologyKpRasiChangesResponse = PostVedicAstrologyKpRasiChangesResponses[keyof PostVedicAstrologyKpRasiChangesResponses];
+export type PostVedicAstrologyKpPlanetsIntervalData = {
+    body?: KpPlanetsIntervalRequest;
     path?: never;
     query?: never;
-    url: '/vedic-astrology/kp/rasi-changes';
+    url: '/vedic-astrology/kp/planets-interval';
 };
-export type PostVedicAstrologyKpRasiChangesErrors = {
+export type PostVedicAstrologyKpPlanetsIntervalErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -19398,21 +20633,30 @@ export type PostVedicAstrologyKpRasiChangesErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyKpRasiChangesError = PostVedicAstrologyKpRasiChangesErrors[keyof PostVedicAstrologyKpRasiChangesErrors];
-export type PostVedicAstrologyKpRasiChangesResponses = {
+export type PostVedicAstrologyKpPlanetsIntervalError = PostVedicAstrologyKpPlanetsIntervalErrors[keyof PostVedicAstrologyKpPlanetsIntervalErrors];
+export type PostVedicAstrologyKpPlanetsIntervalResponses = {
     /**
-     * Sign ingress timings calculated successfully
+     * Planetary positions calculated at all intervals
      */
-    200: KpRasiChangesResponse;
+    200: KpPlanetsIntervalResponse;
 };
-export type PostVedicAstrologyKpRasiChangesResponse = PostVedicAstrologyKpRasiChangesResponses[keyof PostVedicAstrologyKpRasiChangesResponses];
-export type PostVedicAstrologyKpPlanetsIntervalData = {
-    body?: KpPlanetsIntervalRequest;
+export type PostVedicAstrologyKpPlanetsIntervalResponse = PostVedicAstrologyKpPlanetsIntervalResponses[keyof PostVedicAstrologyKpPlanetsIntervalResponses];
+export type PostVedicAstrologyKpHoraryData = {
+    body?: KpHoraryRequest;
     path?: never;
-    query?: never;
-    url: '/vedic-astrology/kp/planets-interval';
+    query?: {
+        /**
+         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
+         */
+        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
+        /**
+         * Which signification vocabulary the houseThemes map returns. "general" gives the classical bhava significations (self, wealth, siblings, home, and so on). "finance" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use "finance" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to "general".
+         */
+        focus?: 'general' | 'finance';
+    };
+    url: '/vedic-astrology/kp/horary';
 };
-export type PostVedicAstrologyKpPlanetsIntervalErrors = {
+export type PostVedicAstrologyKpHoraryErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -19513,14 +20757,14 @@ export type PostVedicAstrologyKpPlanetsIntervalErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyKpPlanetsIntervalError = PostVedicAstrologyKpPlanetsIntervalErrors[keyof PostVedicAstrologyKpPlanetsIntervalErrors];
-export type PostVedicAstrologyKpPlanetsIntervalResponses = {
+export type PostVedicAstrologyKpHoraryError = PostVedicAstrologyKpHoraryErrors[keyof PostVedicAstrologyKpHoraryErrors];
+export type PostVedicAstrologyKpHoraryResponses = {
     /**
-     * Planetary positions calculated at all intervals
+     * Horary chart with the Ascendant from the number, Placidus cusps, planets at the question moment, ruling planets, and four-level significators.
      */
-    200: KpPlanetsIntervalResponse;
+    200: KpHoraryResponse;
 };
-export type PostVedicAstrologyKpPlanetsIntervalResponse = PostVedicAstrologyKpPlanetsIntervalResponses[keyof PostVedicAstrologyKpPlanetsIntervalResponses];
+export type PostVedicAstrologyKpHoraryResponse = PostVedicAstrologyKpHoraryResponses[keyof PostVedicAstrologyKpHoraryResponses];
 export type PostVedicAstrologyAspectsData = {
     body?: {
         /**
@@ -20274,11 +21518,11 @@ export type PostVedicAstrologyTransitResponses = {
      */
     200: {
         /**
-         * Birth datetime used for the natal chart (UTC ISO 8601).
+         * Birth datetime used for the natal chart, echoed as the local civil date and time supplied in the request (YYYY-MM-DDTHH:MM:SS). Combine it with the timezone field to recover the UTC instant.
          */
         birthDatetime: string;
         /**
-         * Transit datetime being analyzed (UTC ISO 8601).
+         * Transit datetime being analyzed, echoed as the local civil date and time supplied in the request (YYYY-MM-DDTHH:MM:SS). Gochar positions are computed for this moment and overlaid on the natal chart.
          */
         transitDatetime: string;
         /**
@@ -20286,7 +21530,7 @@ export type PostVedicAstrologyTransitResponses = {
          */
         natalPlanets: Array<{
             /**
-             * Planet name (Sun through Ketu plus Lagna).
+             * Graha name, Sun through Ketu. The Lagna is not one of these entries; it is a house frame rather than a body, and the natal house numbers on every entry are counted from it.
              */
             name: string;
             /**
@@ -20303,7 +21547,7 @@ export type PostVedicAstrologyTransitResponses = {
             house: number;
         }>;
         /**
-         * Current planetary positions overlaid on the natal chart with house placements and aspects.
+         * Current planetary positions overlaid on the natal chart with house placements, aspects, and the Gochara Kaksha verdict for each graha.
          */
         transitingPlanets: Array<{
             /**
@@ -20339,6 +21583,35 @@ export type PostVedicAstrologyTransitResponses = {
                  */
                 orb: number;
             }>;
+            /**
+             * Gochara Kaksha: the ashtakavarga-qualified reading of this transit. The sign says where a graha is, this says whether the exact stretch it currently occupies is one its own Bhinnashtakavarga supports, which is the classical way of refining a transit verdict from sign-level to under four degrees.
+             */
+            kaksha: {
+                /**
+                 * Kaksha number 1-8 within the current sign. Each sign divides into eight kakshas of 3 degrees 45 minutes, crossed in order, so this is how far through the sign the graha has travelled.
+                 */
+                number: number;
+                /**
+                 * Graha ruling this kaksha. The eight lords run Saturn, Jupiter, Mars, Sun, Venus, Mercury, Moon, Lagna from the start of every sign, ordered by how long each takes to cross a sign.
+                 */
+                lord: string;
+                /**
+                 * Degree within the sign where this kaksha begins (0, 3.75, 7.5 and so on).
+                 */
+                startDegree: number;
+                /**
+                 * Degree within the sign where this kaksha ends.
+                 */
+                endDegree: number;
+                /**
+                 * Whether this kaksha lord gave the transiting graha a bindu in the sign being transited, which is the Gochara Kaksha verdict: true reads as a favourable stretch of the transit, false as an unfavourable one. Null means the question does not apply rather than that the answer is no, because Rahu and Ketu have no Bhinnashtakavarga to read. Never render null as unfavourable.
+                 */
+                bindu: boolean | null;
+                /**
+                 * Bindus the transiting graha holds in this whole sign, 0-8, or null for Rahu and Ketu. Context for the verdict, since the same kaksha reads differently in a sign worth 7 than in one worth 1.
+                 */
+                binduCount: number | null;
+            };
         }>;
         /**
          * Highlighted transits from slow-moving planets (Jupiter, Saturn, Rahu, Ketu), most impactful for Gochar analysis.
@@ -20694,7 +21967,7 @@ export type PostVedicAstrologyParallelsResponses = {
      */
     200: {
         /**
-         * UTC datetime used for declination calculation (ISO 8601).
+         * Datetime used for the declination calculation, echoed as the local civil date and time supplied in the request (YYYY-MM-DDTHH:MM:SS). The timezone field of the request is what converts it to the instant the declinations are computed for.
          */
         datetime: string;
         /**
@@ -21602,21 +22875,136 @@ export type GetVedicAstrologyNakshatrasByIdErrors = {
         code: string;
     };
 };
-export type GetVedicAstrologyNakshatrasByIdError = GetVedicAstrologyNakshatrasByIdErrors[keyof GetVedicAstrologyNakshatrasByIdErrors];
-export type GetVedicAstrologyNakshatrasByIdResponses = {
+export type GetVedicAstrologyNakshatrasByIdError = GetVedicAstrologyNakshatrasByIdErrors[keyof GetVedicAstrologyNakshatrasByIdErrors];
+export type GetVedicAstrologyNakshatrasByIdResponses = {
+    /**
+     * Single nakshatra with zodiac range, ruling planet, presiding deity, symbol, personality characteristics, and traditional remedies (mantras, gemstones, rituals).
+     */
+    200: NakshatraResponse;
+};
+export type GetVedicAstrologyNakshatrasByIdResponse = GetVedicAstrologyNakshatrasByIdResponses[keyof GetVedicAstrologyNakshatrasByIdResponses];
+export type PostVedicAstrologyUpagrahaData = {
+    body?: UpagrahaRequest;
+    path?: never;
+    query?: never;
+    url: '/vedic-astrology/upagraha';
+};
+export type PostVedicAstrologyUpagrahaErrors = {
+    /**
+     * Validation error. `issues[]` lists every failed field.
+     */
+    400: {
+        /**
+         * First issue summary.
+         */
+        error: string;
+        code: 'validation_error';
+        /**
+         * Every validation failure. Use this to rebuild a valid request.
+         */
+        issues: Array<{
+            /**
+             * Dot-separated field path, or "(root)" for top-level.
+             */
+            path: string;
+            message: string;
+            /**
+             * Zod issue code (invalid_type, too_small, too_big, invalid_string, ...).
+             */
+            code?: string;
+            /**
+             * Expected type for invalid_type.
+             */
+            expected?: string;
+            /**
+             * Minimum bound for too_small issues.
+             */
+            minimum?: number | string;
+            /**
+             * Maximum bound for too_big issues.
+             */
+            maximum?: number | string;
+            inclusive?: boolean;
+            /**
+             * Format name for string issues (regex, email, url, uuid).
+             */
+            format?: string;
+            /**
+             * Regex pattern when format is regex.
+             */
+            pattern?: string;
+        }>;
+    };
+    /**
+     * Invalid or missing API key
+     */
+    401: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
+     */
+    405: {
+        error: string;
+        code: 'method_not_allowed';
+        /**
+         * Allowed HTTP methods for this path. Mirrors the Allow response header.
+         */
+        allow: Array<string>;
+        /**
+         * Link to the product page for this domain.
+         */
+        docs?: string;
+    };
+    /**
+     * Monthly rate limit exceeded
+     */
+    429: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Internal server error
+     */
+    500: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+};
+export type PostVedicAstrologyUpagrahaError = PostVedicAstrologyUpagrahaErrors[keyof PostVedicAstrologyUpagrahaErrors];
+export type PostVedicAstrologyUpagrahaResponses = {
     /**
-     * Single nakshatra with zodiac range, ruling planet, presiding deity, symbol, personality characteristics, and traditional remedies (mantras, gemstones, rituals).
+     * All 11 upagraha positions with rashi, nakshatra, and pada details.
      */
-    200: NakshatraResponse;
+    200: UpagrahaResponse;
 };
-export type GetVedicAstrologyNakshatrasByIdResponse = GetVedicAstrologyNakshatrasByIdResponses[keyof GetVedicAstrologyNakshatrasByIdResponses];
-export type PostVedicAstrologyUpagrahaData = {
-    body?: UpagrahaRequest;
+export type PostVedicAstrologyUpagrahaResponse = PostVedicAstrologyUpagrahaResponses[keyof PostVedicAstrologyUpagrahaResponses];
+export type PostVedicAstrologyAshtakavargaData = {
+    body?: AshtakavargaRequest;
     path?: never;
     query?: never;
-    url: '/vedic-astrology/upagraha';
+    url: '/vedic-astrology/ashtakavarga';
 };
-export type PostVedicAstrologyUpagrahaErrors = {
+export type PostVedicAstrologyAshtakavargaErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -21717,21 +23105,26 @@ export type PostVedicAstrologyUpagrahaErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyUpagrahaError = PostVedicAstrologyUpagrahaErrors[keyof PostVedicAstrologyUpagrahaErrors];
-export type PostVedicAstrologyUpagrahaResponses = {
+export type PostVedicAstrologyAshtakavargaError = PostVedicAstrologyAshtakavargaErrors[keyof PostVedicAstrologyAshtakavargaErrors];
+export type PostVedicAstrologyAshtakavargaResponses = {
     /**
-     * All 11 upagraha positions with rashi, nakshatra, and pada details.
+     * Complete Ashtakavarga with Bhinnashtakavarga, Sarvashtakavarga (337-point), Reduced Ashtakavarga (Trikona + Ekadipati Shodhana), and Shodhya Pinda planetary strength.
      */
-    200: UpagrahaResponse;
+    200: AshtakavargaResponse;
 };
-export type PostVedicAstrologyUpagrahaResponse = PostVedicAstrologyUpagrahaResponses[keyof PostVedicAstrologyUpagrahaResponses];
-export type PostVedicAstrologyAshtakavargaData = {
-    body?: AshtakavargaRequest;
+export type PostVedicAstrologyAshtakavargaResponse = PostVedicAstrologyAshtakavargaResponses[keyof PostVedicAstrologyAshtakavargaResponses];
+export type PostVedicAstrologyShadbalaData = {
+    body?: ShadbalaRequest;
     path?: never;
-    query?: never;
-    url: '/vedic-astrology/ashtakavarga';
+    query?: {
+        /**
+         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
+         */
+        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
+    };
+    url: '/vedic-astrology/shadbala';
 };
-export type PostVedicAstrologyAshtakavargaErrors = {
+export type PostVedicAstrologyShadbalaErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -21832,21 +23225,30 @@ export type PostVedicAstrologyAshtakavargaErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyAshtakavargaError = PostVedicAstrologyAshtakavargaErrors[keyof PostVedicAstrologyAshtakavargaErrors];
-export type PostVedicAstrologyAshtakavargaResponses = {
+export type PostVedicAstrologyShadbalaError = PostVedicAstrologyShadbalaErrors[keyof PostVedicAstrologyShadbalaErrors];
+export type PostVedicAstrologyShadbalaResponses = {
     /**
-     * Complete Ashtakavarga with Bhinnashtakavarga, Sarvashtakavarga (337-point), Reduced Ashtakavarga (Trikona + Ekadipati Shodhana), and Shodhya Pinda planetary strength.
+     * Complete Shadbala with 6 strength components, Ishta/Kashta Phala, strength ratios, and relative ranking for all 7 planets.
      */
-    200: AshtakavargaResponse;
+    200: ShadbalaResponse;
 };
-export type PostVedicAstrologyAshtakavargaResponse = PostVedicAstrologyAshtakavargaResponses[keyof PostVedicAstrologyAshtakavargaResponses];
-export type PostVedicAstrologyShadbalaData = {
-    body?: ShadbalaRequest;
+export type PostVedicAstrologyShadbalaResponse = PostVedicAstrologyShadbalaResponses[keyof PostVedicAstrologyShadbalaResponses];
+export type GetVedicAstrologyAvasthasData = {
+    body?: never;
     path?: never;
-    query?: never;
-    url: '/vedic-astrology/shadbala';
+    query?: {
+        /**
+         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
+         */
+        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
+        /**
+         * Return only the states of one system: "baladi" (5), "jagradadi" (3) or "deeptadi" (9). Omit for all 17.
+         */
+        system?: 'baladi' | 'jagradadi' | 'deeptadi';
+    };
+    url: '/vedic-astrology/avasthas';
 };
-export type PostVedicAstrologyShadbalaErrors = {
+export type GetVedicAstrologyAvasthasErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -21947,30 +23349,52 @@ export type PostVedicAstrologyShadbalaErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyShadbalaError = PostVedicAstrologyShadbalaErrors[keyof PostVedicAstrologyShadbalaErrors];
-export type PostVedicAstrologyShadbalaResponses = {
+export type GetVedicAstrologyAvasthasError = GetVedicAstrologyAvasthasErrors[keyof GetVedicAstrologyAvasthasErrors];
+export type GetVedicAstrologyAvasthasResponses = {
     /**
-     * Complete Shadbala with 6 strength components, Ishta/Kashta Phala, strength ratios, and relative ranking for all 7 planets.
+     * Avastha states with their labels and interpretations, in system order.
      */
-    200: ShadbalaResponse;
+    200: Array<{
+        /**
+         * Unique slug for the avastha state. It is the lowercased form of the state name the birth chart returns, so a chart value maps straight onto this record.
+         */
+        id: string;
+        /**
+         * Sanskrit name of the state, exactly as it appears in the `awastha`, `jagradadi` or `deeptadi` field of a birth chart.
+         */
+        name: string;
+        /**
+         * Which avastha system the state belongs to, and therefore which birth-chart field it appears in. "baladi" is the five-fold age state set by degree within the sign and appears in `awastha`. "jagradadi" is the three-fold waking state set by sign dignity. "deeptadi" is the nine-fold dispositional state. Baladi applies to every body; the other two apply to the seven classical grahas only.
+         */
+        system: 'baladi' | 'jagradadi' | 'deeptadi';
+        /**
+         * Short label for the state, sized for a table cell beside the graha.
+         */
+        meaning: string;
+        /**
+         * What the state means for the results the graha delivers, which is the whole purpose of reading an avastha: the chart says where a graha is, the avastha says how much of its promise it can keep.
+         */
+        interpretation: string;
+    }>;
 };
-export type PostVedicAstrologyShadbalaResponse = PostVedicAstrologyShadbalaResponses[keyof PostVedicAstrologyShadbalaResponses];
-export type GetVedicAstrologyAvasthasData = {
+export type GetVedicAstrologyAvasthasResponse = GetVedicAstrologyAvasthasResponses[keyof GetVedicAstrologyAvasthasResponses];
+export type GetVedicAstrologyAvasthasByIdData = {
     body?: never;
-    path?: never;
+    path: {
+        /**
+         * Avastha slug. Baladi: bala, kumara, yuva, vriddha, mrita. Jagradadi: jagrat, swapna, sushupti. Deeptadi: dipta, svastha, pramudita, shanta, dina, duhkhita, vikala, khala, kopa.
+         */
+        id: 'bala' | 'kumara' | 'yuva' | 'vriddha' | 'mrita' | 'jagrat' | 'swapna' | 'sushupti' | 'dipta' | 'svastha' | 'pramudita' | 'shanta' | 'dina' | 'duhkhita' | 'vikala' | 'khala' | 'kopa';
+    };
     query?: {
         /**
          * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
          */
         lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
-        /**
-         * Return only the states of one system: "baladi" (5), "jagradadi" (3) or "deeptadi" (9). Omit for all 17.
-         */
-        system?: 'baladi' | 'jagradadi' | 'deeptadi';
     };
-    url: '/vedic-astrology/avasthas';
+    url: '/vedic-astrology/avasthas/{id}';
 };
-export type GetVedicAstrologyAvasthasErrors = {
+export type GetVedicAstrologyAvasthasByIdErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -22029,6 +23453,19 @@ export type GetVedicAstrologyAvasthasErrors = {
          */
         code: string;
     };
+    /**
+     * No avastha state matches that slug.
+     */
+    404: {
+        /**
+         * Human-readable error message. May change wording — do not parse programmatically.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier for programmatic error handling.
+         */
+        code: string;
+    };
     /**
      * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
      */
@@ -22071,12 +23508,12 @@ export type GetVedicAstrologyAvasthasErrors = {
         code: string;
     };
 };
-export type GetVedicAstrologyAvasthasError = GetVedicAstrologyAvasthasErrors[keyof GetVedicAstrologyAvasthasErrors];
-export type GetVedicAstrologyAvasthasResponses = {
+export type GetVedicAstrologyAvasthasByIdError = GetVedicAstrologyAvasthasByIdErrors[keyof GetVedicAstrologyAvasthasByIdErrors];
+export type GetVedicAstrologyAvasthasByIdResponses = {
     /**
-     * Avastha states with their labels and interpretations, in system order.
+     * The avastha state with its system, label and interpretation.
      */
-    200: Array<{
+    200: {
         /**
          * Unique slug for the avastha state. It is the lowercased form of the state name the birth chart returns, so a chart value maps straight onto this record.
          */
@@ -22097,26 +23534,141 @@ export type GetVedicAstrologyAvasthasResponses = {
          * What the state means for the results the graha delivers, which is the whole purpose of reading an avastha: the chart says where a graha is, the avastha says how much of its promise it can keep.
          */
         interpretation: string;
-    }>;
+    };
 };
-export type GetVedicAstrologyAvasthasResponse = GetVedicAstrologyAvasthasResponses[keyof GetVedicAstrologyAvasthasResponses];
-export type GetVedicAstrologyAvasthasByIdData = {
-    body?: never;
-    path: {
+export type GetVedicAstrologyAvasthasByIdResponse = GetVedicAstrologyAvasthasByIdResponses[keyof GetVedicAstrologyAvasthasByIdResponses];
+export type PostVedicAstrologyArudhaData = {
+    body?: ArudhaRequest;
+    path?: never;
+    query?: {
         /**
-         * Avastha slug. Baladi: bala, kumara, yuva, vriddha, mrita. Jagradadi: jagrat, swapna, sushupti. Deeptadi: dipta, svastha, pramudita, shanta, dina, duhkhita, vikala, khala, kopa.
+         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
          */
-        id: 'bala' | 'kumara' | 'yuva' | 'vriddha' | 'mrita' | 'jagrat' | 'swapna' | 'sushupti' | 'dipta' | 'svastha' | 'pramudita' | 'shanta' | 'dina' | 'duhkhita' | 'vikala' | 'khala' | 'kopa';
+        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
     };
+    url: '/vedic-astrology/arudha';
+};
+export type PostVedicAstrologyArudhaErrors = {
+    /**
+     * Validation error. `issues[]` lists every failed field.
+     */
+    400: {
+        /**
+         * First issue summary.
+         */
+        error: string;
+        code: 'validation_error';
+        /**
+         * Every validation failure. Use this to rebuild a valid request.
+         */
+        issues: Array<{
+            /**
+             * Dot-separated field path, or "(root)" for top-level.
+             */
+            path: string;
+            message: string;
+            /**
+             * Zod issue code (invalid_type, too_small, too_big, invalid_string, ...).
+             */
+            code?: string;
+            /**
+             * Expected type for invalid_type.
+             */
+            expected?: string;
+            /**
+             * Minimum bound for too_small issues.
+             */
+            minimum?: number | string;
+            /**
+             * Maximum bound for too_big issues.
+             */
+            maximum?: number | string;
+            inclusive?: boolean;
+            /**
+             * Format name for string issues (regex, email, url, uuid).
+             */
+            format?: string;
+            /**
+             * Regex pattern when format is regex.
+             */
+            pattern?: string;
+        }>;
+    };
+    /**
+     * Invalid or missing API key
+     */
+    401: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
+     */
+    405: {
+        error: string;
+        code: 'method_not_allowed';
+        /**
+         * Allowed HTTP methods for this path. Mirrors the Allow response header.
+         */
+        allow: Array<string>;
+        /**
+         * Link to the product page for this domain.
+         */
+        docs?: string;
+    };
+    /**
+     * Monthly rate limit exceeded
+     */
+    429: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Internal server error
+     */
+    500: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+};
+export type PostVedicAstrologyArudhaError = PostVedicAstrologyArudhaErrors[keyof PostVedicAstrologyArudhaErrors];
+export type PostVedicAstrologyArudhaResponses = {
+    /**
+     * All twelve Arudha padas with derivation detail, plus the Arudha Lagna and Upapada lifted to the top level.
+     */
+    200: ArudhaResponse;
+};
+export type PostVedicAstrologyArudhaResponse = PostVedicAstrologyArudhaResponses[keyof PostVedicAstrologyArudhaResponses];
+export type PostVedicAstrologyCharaKarakasData = {
+    body?: CharaKarakaRequest;
+    path?: never;
     query?: {
         /**
          * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
          */
         lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
     };
-    url: '/vedic-astrology/avasthas/{id}';
+    url: '/vedic-astrology/chara-karakas';
 };
-export type GetVedicAstrologyAvasthasByIdErrors = {
+export type PostVedicAstrologyCharaKarakasErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -22175,19 +23727,6 @@ export type GetVedicAstrologyAvasthasByIdErrors = {
          */
         code: string;
     };
-    /**
-     * No avastha state matches that slug.
-     */
-    404: {
-        /**
-         * Human-readable error message. May change wording — do not parse programmatically.
-         */
-        error: string;
-        /**
-         * Machine-readable error code. Stable identifier for programmatic error handling.
-         */
-        code: string;
-    };
     /**
      * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
      */
@@ -22230,47 +23769,154 @@ export type GetVedicAstrologyAvasthasByIdErrors = {
         code: string;
     };
 };
-export type GetVedicAstrologyAvasthasByIdError = GetVedicAstrologyAvasthasByIdErrors[keyof GetVedicAstrologyAvasthasByIdErrors];
-export type GetVedicAstrologyAvasthasByIdResponses = {
+export type PostVedicAstrologyCharaKarakasError = PostVedicAstrologyCharaKarakasErrors[keyof PostVedicAstrologyCharaKarakasErrors];
+export type PostVedicAstrologyCharaKarakasResponses = {
     /**
-     * The avastha state with its system, label and interpretation.
+     * Karaka offices in descending rank with the ranking degree for each, plus the Atmakaraka and Darakaraka lifted to the top level.
      */
-    200: {
+    200: CharaKarakaResponse;
+};
+export type PostVedicAstrologyCharaKarakasResponse = PostVedicAstrologyCharaKarakasResponses[keyof PostVedicAstrologyCharaKarakasResponses];
+export type PostVedicAstrologyBhavaBalaData = {
+    body?: BhavaBalaRequest;
+    path?: never;
+    query?: {
         /**
-         * Unique slug for the avastha state. It is the lowercased form of the state name the birth chart returns, so a chart value maps straight onto this record.
+         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
          */
-        id: string;
+        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
         /**
-         * Sanskrit name of the state, exactly as it appears in the `awastha`, `jagradadi` or `deeptadi` field of a birth chart.
+         * Which signification vocabulary the houseThemes map returns. "general" gives the classical bhava significations (self, wealth, siblings, home, and so on). "finance" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use "finance" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to "general".
          */
-        name: string;
+        focus?: 'general' | 'finance';
+    };
+    url: '/vedic-astrology/bhava-bala';
+};
+export type PostVedicAstrologyBhavaBalaErrors = {
+    /**
+     * Validation error. `issues[]` lists every failed field.
+     */
+    400: {
         /**
-         * Which avastha system the state belongs to, and therefore which birth-chart field it appears in. "baladi" is the five-fold age state set by degree within the sign and appears in `awastha`. "jagradadi" is the three-fold waking state set by sign dignity. "deeptadi" is the nine-fold dispositional state. Baladi applies to every body; the other two apply to the seven classical grahas only.
+         * First issue summary.
          */
-        system: 'baladi' | 'jagradadi' | 'deeptadi';
+        error: string;
+        code: 'validation_error';
         /**
-         * Short label for the state, sized for a table cell beside the graha.
+         * Every validation failure. Use this to rebuild a valid request.
          */
-        meaning: string;
+        issues: Array<{
+            /**
+             * Dot-separated field path, or "(root)" for top-level.
+             */
+            path: string;
+            message: string;
+            /**
+             * Zod issue code (invalid_type, too_small, too_big, invalid_string, ...).
+             */
+            code?: string;
+            /**
+             * Expected type for invalid_type.
+             */
+            expected?: string;
+            /**
+             * Minimum bound for too_small issues.
+             */
+            minimum?: number | string;
+            /**
+             * Maximum bound for too_big issues.
+             */
+            maximum?: number | string;
+            inclusive?: boolean;
+            /**
+             * Format name for string issues (regex, email, url, uuid).
+             */
+            format?: string;
+            /**
+             * Regex pattern when format is regex.
+             */
+            pattern?: string;
+        }>;
+    };
+    /**
+     * Invalid or missing API key
+     */
+    401: {
         /**
-         * What the state means for the results the graha delivers, which is the whole purpose of reading an avastha: the chart says where a graha is, the avastha says how much of its promise it can keep.
+         * Human-readable error message. May change wording.
          */
-        interpretation: string;
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
+     */
+    405: {
+        error: string;
+        code: 'method_not_allowed';
+        /**
+         * Allowed HTTP methods for this path. Mirrors the Allow response header.
+         */
+        allow: Array<string>;
+        /**
+         * Link to the product page for this domain.
+         */
+        docs?: string;
+    };
+    /**
+     * Monthly rate limit exceeded
+     */
+    429: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Internal server error
+     */
+    500: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
     };
 };
-export type GetVedicAstrologyAvasthasByIdResponse = GetVedicAstrologyAvasthasByIdResponses[keyof GetVedicAstrologyAvasthasByIdResponses];
-export type PostVedicAstrologyArudhaData = {
-    body?: ArudhaRequest;
+export type PostVedicAstrologyBhavaBalaError = PostVedicAstrologyBhavaBalaErrors[keyof PostVedicAstrologyBhavaBalaErrors];
+export type PostVedicAstrologyBhavaBalaResponses = {
+    /**
+     * Bhava Bala for all twelve houses with the three components, totals in virupas and rupas, ranking, and the localized house-theme legend.
+     */
+    200: BhavaBalaResponse;
+};
+export type PostVedicAstrologyBhavaBalaResponse = PostVedicAstrologyBhavaBalaResponses[keyof PostVedicAstrologyBhavaBalaResponses];
+export type PostVedicAstrologyBhavChalitData = {
+    body?: BhavChalitRequest;
     path?: never;
     query?: {
         /**
          * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
          */
         lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
+        /**
+         * Which signification vocabulary the houseThemes map returns. "general" gives the classical bhava significations (self, wealth, siblings, home, and so on). "finance" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use "finance" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to "general".
+         */
+        focus?: 'general' | 'finance';
     };
-    url: '/vedic-astrology/arudha';
+    url: '/vedic-astrology/bhav-chalit';
 };
-export type PostVedicAstrologyArudhaErrors = {
+export type PostVedicAstrologyBhavChalitErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -22371,26 +24017,21 @@ export type PostVedicAstrologyArudhaErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyArudhaError = PostVedicAstrologyArudhaErrors[keyof PostVedicAstrologyArudhaErrors];
-export type PostVedicAstrologyArudhaResponses = {
+export type PostVedicAstrologyBhavChalitError = PostVedicAstrologyBhavChalitErrors[keyof PostVedicAstrologyBhavChalitErrors];
+export type PostVedicAstrologyBhavChalitResponses = {
     /**
-     * All twelve Arudha padas with derivation detail, plus the Arudha Lagna and Upapada lifted to the top level.
+     * Bhav Chalit chart with the twelve Sripati bhavas, every graha in both frames, and the localized house-theme legend.
      */
-    200: ArudhaResponse;
+    200: BhavChalitResponse;
 };
-export type PostVedicAstrologyArudhaResponse = PostVedicAstrologyArudhaResponses[keyof PostVedicAstrologyArudhaResponses];
-export type PostVedicAstrologyCharaKarakasData = {
-    body?: CharaKarakaRequest;
+export type PostVedicAstrologyBhavChalitResponse = PostVedicAstrologyBhavChalitResponses[keyof PostVedicAstrologyBhavChalitResponses];
+export type PostVedicAstrologyHeliacalData = {
+    body?: HeliacalRequest;
     path?: never;
-    query?: {
-        /**
-         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
-         */
-        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
-    };
-    url: '/vedic-astrology/chara-karakas';
+    query?: never;
+    url: '/vedic-astrology/heliacal';
 };
-export type PostVedicAstrologyCharaKarakasErrors = {
+export type PostVedicAstrologyHeliacalErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -22491,14 +24132,14 @@ export type PostVedicAstrologyCharaKarakasErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyCharaKarakasError = PostVedicAstrologyCharaKarakasErrors[keyof PostVedicAstrologyCharaKarakasErrors];
-export type PostVedicAstrologyCharaKarakasResponses = {
+export type PostVedicAstrologyHeliacalError = PostVedicAstrologyHeliacalErrors[keyof PostVedicAstrologyHeliacalErrors];
+export type PostVedicAstrologyHeliacalResponses = {
     /**
-     * Karaka offices in descending rank with the ranking degree for each, plus the Atmakaraka and Darakaraka lifted to the top level.
+     * Heliacal visibility and the surrounding udaya and asta events for each graha.
      */
-    200: CharaKarakaResponse;
+    200: HeliacalResponse;
 };
-export type PostVedicAstrologyCharaKarakasResponse = PostVedicAstrologyCharaKarakasResponses[keyof PostVedicAstrologyCharaKarakasResponses];
+export type PostVedicAstrologyHeliacalResponse = PostVedicAstrologyHeliacalResponses[keyof PostVedicAstrologyHeliacalResponses];
 export type PostForecastTimelineData = {
     body?: {
         /**
@@ -23546,20 +25187,50 @@ export type PostForecastDigestResponses = {
              * Count of events in this window broken down by domain. Only domains with at least one event in the window are present. The values sum to count.
              */
             byDomain: {
+                /**
+                 * Number of events in this window produced by this forecast domain. Absent when the domain contributed nothing, so a zero is never written.
+                 */
                 western?: number;
+                /**
+                 * Number of events in this window produced by this forecast domain. Absent when the domain contributed nothing, so a zero is never written.
+                 */
                 vedic?: number;
+                /**
+                 * Number of events in this window produced by this forecast domain. Absent when the domain contributed nothing, so a zero is never written.
+                 */
                 biorhythm?: number;
             };
             /**
              * Count of events in this window broken down by event type. Only types with at least one event in the window are present. The values sum to count.
              */
             byType: {
+                /**
+                 * Number of events in this window of this event type. Absent when the type did not occur, so a zero is never written.
+                 */
                 'transit-aspect'?: number;
+                /**
+                 * Number of events in this window of this event type. Absent when the type did not occur, so a zero is never written.
+                 */
                 'sign-ingress'?: number;
+                /**
+                 * Number of events in this window of this event type. Absent when the type did not occur, so a zero is never written.
+                 */
                 'retrograde-station'?: number;
+                /**
+                 * Number of events in this window of this event type. Absent when the type did not occur, so a zero is never written.
+                 */
                 eclipse?: number;
+                /**
+                 * Number of events in this window of this event type. Absent when the type did not occur, so a zero is never written.
+                 */
                 'lunar-phase'?: number;
+                /**
+                 * Number of events in this window of this event type. Absent when the type did not occur, so a zero is never written.
+                 */
                 'dasha-change'?: number;
+                /**
+                 * Number of events in this window of this event type. Absent when the type did not occur, so a zero is never written.
+                 */
                 'critical-day'?: number;
             };
             /**
@@ -25570,7 +27241,7 @@ export type GetHumanDesignGatesByNumberData = {
         /**
          * Gate number from 1 to 64.
          */
-        number: number;
+        number: number | null;
     };
     query?: {
         /**
@@ -26667,7 +28338,13 @@ export type PostHumanDesignVariablesResponses = {
              * Cognition, the strongest sense, read off the Determination Tone. Present on the determination arrow ONLY: no authority supports reading Cognition from the other three arrows, so it is omitted rather than invented.
              */
             cognition?: {
+                /**
+                 * Name of the Cognition, the strongest sense. One of six read off the Determination Tone: Smell, Taste, Outer Vision, Inner Vision, Feeling, Touch.
+                 */
                 label: string;
+                /**
+                 * How this Cognition discriminates what is correct for the body, and the conditions that sharpen it. Renderable as the Cognition paragraph of a Variables or Primary Health System report.
+                 */
                 description: string;
             };
             /**
@@ -29877,7 +31554,7 @@ export type PostNumerologyChartResponses = {
                 /**
                  * Age when this phase ends. Null for the 4th Pinnacle (lasts rest of life).
                  */
-                endAge: number;
+                endAge: number | null;
                 /**
                  * Meaning and interpretation for this Pinnacle number.
                  */
@@ -29919,7 +31596,7 @@ export type PostNumerologyChartResponses = {
                 /**
                  * Age when this period ends. Null for the 4th Challenge.
                  */
-                endAge: number;
+                endAge: number | null;
                 /**
                  * Meaning and resolution guidance for this Challenge number.
                  */
@@ -30642,7 +32319,7 @@ export type PostNumerologyChaldeanResponses = {
             /**
              * The interpretable compound number (10 to 52), the hidden influence behind the name, or null when the total resolves below 10.
              */
-            compound: number;
+            compound: number | null;
             /**
              * The single-digit root (1 to 9), the outward expression. Chaldean does not preserve master numbers.
              */
@@ -30662,7 +32339,7 @@ export type PostNumerologyChaldeanResponses = {
                 /**
                  * Classical symbolic title from Cheiro, or null when the number has no named symbol.
                  */
-                name: string;
+                name: string | null;
                 /**
                  * Overall tenor of the compound. "mixed" covers conditional numbers that are fortunate only alongside a favorable single number or in a specific domain.
                  */
@@ -30675,7 +32352,7 @@ export type PostNumerologyChaldeanResponses = {
                  * For numbers 33 to 52, the lower compound in the same series whose meaning this number shares.
                  */
                 sameAs?: number;
-            };
+            } | null;
         };
         /**
          * The Soul Urge number from the vowels, revealing inner desire. Root may be 0 when the name has no vowels.
@@ -30688,7 +32365,7 @@ export type PostNumerologyChaldeanResponses = {
             /**
              * The interpretable compound number (10 to 52), the hidden influence behind the name, or null when the total resolves below 10.
              */
-            compound: number;
+            compound: number | null;
             /**
              * The single-digit root (1 to 9), the outward expression. Chaldean does not preserve master numbers.
              */
@@ -30708,7 +32385,7 @@ export type PostNumerologyChaldeanResponses = {
                 /**
                  * Classical symbolic title from Cheiro, or null when the number has no named symbol.
                  */
-                name: string;
+                name: string | null;
                 /**
                  * Overall tenor of the compound. "mixed" covers conditional numbers that are fortunate only alongside a favorable single number or in a specific domain.
                  */
@@ -30721,7 +32398,7 @@ export type PostNumerologyChaldeanResponses = {
                  * For numbers 33 to 52, the lower compound in the same series whose meaning this number shares.
                  */
                 sameAs?: number;
-            };
+            } | null;
         };
         /**
          * The Personality number from the consonants, revealing the outer impression. Root may be 0 when the name has no consonants.
@@ -30734,7 +32411,7 @@ export type PostNumerologyChaldeanResponses = {
             /**
              * The interpretable compound number (10 to 52), the hidden influence behind the name, or null when the total resolves below 10.
              */
-            compound: number;
+            compound: number | null;
             /**
              * The single-digit root (1 to 9), the outward expression. Chaldean does not preserve master numbers.
              */
@@ -30754,7 +32431,7 @@ export type PostNumerologyChaldeanResponses = {
                 /**
                  * Classical symbolic title from Cheiro, or null when the number has no named symbol.
                  */
-                name: string;
+                name: string | null;
                 /**
                  * Overall tenor of the compound. "mixed" covers conditional numbers that are fortunate only alongside a favorable single number or in a specific domain.
                  */
@@ -30767,7 +32444,7 @@ export type PostNumerologyChaldeanResponses = {
                  * For numbers 33 to 52, the lower compound in the same series whose meaning this number shares.
                  */
                 sameAs?: number;
-            };
+            } | null;
         };
         numberMeaning: {
             /**
@@ -30936,7 +32613,7 @@ export type GetNumerologyCompoundNumberByNumberResponses = {
         /**
          * Classical symbolic title from Cheiro, or null when none is given.
          */
-        name: string;
+        name: string | null;
         /**
          * Overall tenor of the number. "mixed" marks conditional numbers, fortunate only with a favorable single number or in one domain.
          */
@@ -31109,7 +32786,7 @@ export type PostNumerologyDualResponses = {
             /**
              * Chaldean compound number (10 to 52), the hidden influence, or null.
              */
-            compound: number;
+            compound: number | null;
             /**
              * Chaldean root (1 to 9).
              */
@@ -31145,7 +32822,7 @@ export type PostNumerologyDualResponses = {
                 /**
                  * Symbolic title.
                  */
-                name: string;
+                name: string | null;
                 /**
                  * Tenor of the compound.
                  */
@@ -31158,7 +32835,7 @@ export type PostNumerologyDualResponses = {
                  * Series equivalent for 33 to 52.
                  */
                 sameAs?: number;
-            };
+            } | null;
         };
         /**
          * True when both systems reduce to the same single-digit energy (Pythagorean number reduced to one digit equals the Chaldean root). Agreement is read as a name whose vibrations are in harmony.
@@ -31305,7 +32982,7 @@ export type PostNumerologyBusinessNameResponses = {
         /**
          * Chaldean compound number (10 to 52), the hidden influence, or null.
          */
-        compound: number;
+        compound: number | null;
         /**
          * Single-digit business root (1 to 9), the outward commercial expression.
          */
@@ -31345,7 +33022,7 @@ export type PostNumerologyBusinessNameResponses = {
             /**
              * Symbolic title, if any.
              */
-            name: string;
+            name: string | null;
             /**
              * Tenor of the compound.
              */
@@ -31358,7 +33035,7 @@ export type PostNumerologyBusinessNameResponses = {
              * Series equivalent for 33 to 52.
              */
             sameAs?: number;
-        };
+        } | null;
         /**
          * One-line plain-language verdict for the business name.
          */
@@ -31381,7 +33058,7 @@ export type GetTarotCardsData = {
         /**
          * Number of items to skip for pagination. Default 0.
          */
-        offset?: number;
+        offset?: number | null;
         /**
          * Filter by arcana type. Major arcana (0-21) represents life lessons and spiritual themes. Minor arcana (Ace-King in 4 suits) represents daily situations and practical matters.
          */
@@ -31393,7 +33070,7 @@ export type GetTarotCardsData = {
         /**
          * Filter by card number. Major Arcana: 0 (The Fool) through 21 (The World). Minor Arcana: 1 (Ace) through 14 (King). Combine with arcana or suit filters for precise results.
          */
-        number?: number;
+        number?: number | null;
     };
     url: '/tarot/cards';
 };
@@ -32284,7 +33961,7 @@ export type PostTarotSpreadsThreeCardResponses = {
             card: DrawnCard;
         }>;
         /**
-         * AI-generated narrative connecting all cards in the spread into a cohesive reading.
+         * Narrative summary that connects the cards drawn across the spread positions into one cohesive reading.
          */
         summary?: string;
     };
@@ -32292,7 +33969,13 @@ export type PostTarotSpreadsThreeCardResponses = {
 export type PostTarotSpreadsThreeCardResponse = PostTarotSpreadsThreeCardResponses[keyof PostTarotSpreadsThreeCardResponses];
 export type PostTarotSpreadsCelticCrossData = {
     body: {
+        /**
+         * Optional querent question to focus the Celtic Cross. It is echoed back on the reading and gives the ten positions their context. Omit for a general reading of the situation.
+         */
         question?: string;
+        /**
+         * Optional seed for reproducible results. The same seed always draws the same ten cards into the same Celtic Cross positions, which is what lets a reading be shared or re-rendered. Omit for a random draw.
+         */
         seed?: string;
     };
     path?: never;
@@ -32442,7 +34125,7 @@ export type PostTarotSpreadsCelticCrossResponses = {
             card: DrawnCard;
         }>;
         /**
-         * AI-generated narrative connecting all cards in the spread into a cohesive reading.
+         * Narrative summary that connects the cards drawn across the spread positions into one cohesive reading.
          */
         summary?: string;
     };
@@ -32450,7 +34133,13 @@ export type PostTarotSpreadsCelticCrossResponses = {
 export type PostTarotSpreadsCelticCrossResponse = PostTarotSpreadsCelticCrossResponses[keyof PostTarotSpreadsCelticCrossResponses];
 export type PostTarotSpreadsLoveData = {
     body: {
+        /**
+         * Optional querent question to focus the love spread. It is echoed back on the reading and gives the five relationship positions their context. Omit for general relationship guidance.
+         */
         question?: string;
+        /**
+         * Optional seed for reproducible results. The same seed always draws the same five cards into the same love positions, which is what lets a reading be shared or re-rendered. Omit for a random draw.
+         */
         seed?: string;
     };
     path?: never;
@@ -32600,7 +34289,7 @@ export type PostTarotSpreadsLoveResponses = {
             card: DrawnCard;
         }>;
         /**
-         * AI-generated narrative connecting all cards in the spread into a cohesive reading.
+         * Narrative summary that connects the cards drawn across the spread positions into one cohesive reading.
          */
         summary?: string;
     };
@@ -32608,7 +34297,13 @@ export type PostTarotSpreadsLoveResponses = {
 export type PostTarotSpreadsLoveResponse = PostTarotSpreadsLoveResponses[keyof PostTarotSpreadsLoveResponses];
 export type PostTarotSpreadsCareerData = {
     body: {
+        /**
+         * Optional querent question to focus the career spread. It is echoed back on the reading and gives the five career positions their context. Omit for general work and vocation guidance.
+         */
         question?: string;
+        /**
+         * Optional seed for reproducible results. The same seed always draws the same five cards into the same career positions, which is what lets a reading be shared or re-rendered. Omit for a random draw.
+         */
         seed?: string;
     };
     path?: never;
@@ -32758,7 +34453,7 @@ export type PostTarotSpreadsCareerResponses = {
             card: DrawnCard;
         }>;
         /**
-         * AI-generated narrative connecting all cards in the spread into a cohesive reading.
+         * Narrative summary that connects the cards drawn across the spread positions into one cohesive reading.
          */
         summary?: string;
     };
@@ -32938,10 +34633,6 @@ export type PostTarotSpreadsCustomResponses = {
             interpretation: string;
             card: DrawnCard;
         }>;
-        /**
-         * AI-generated narrative connecting all cards in the spread into a cohesive reading.
-         */
-        summary?: string;
     };
 };
 export type PostTarotSpreadsCustomResponse = PostTarotSpreadsCustomResponses[keyof PostTarotSpreadsCustomResponses];
@@ -33567,7 +35258,7 @@ export type PostBiorhythmCriticalDaysResponses = {
         /**
          * Date where all 3 primary cycles cross zero simultaneously. Extremely rare event. Null if none found in range.
          */
-        tripleCriticalDay: string;
+        tripleCriticalDay: string | null;
     };
 };
 export type PostBiorhythmCriticalDaysResponse = PostBiorhythmCriticalDaysResponses[keyof PostBiorhythmCriticalDaysResponses];
@@ -34656,7 +36347,7 @@ export type GetIchingHexagramsData = {
         /**
          * Number of items to skip for pagination. Default 0.
          */
-        offset?: number;
+        offset?: number | null;
     };
     url: '/iching/hexagrams';
 };
@@ -35620,7 +37311,7 @@ export type GetCrystalsZodiacBySignData = {
         /**
          * Number of items to skip for pagination. Default 0.
          */
-        offset?: number;
+        offset?: number | null;
     };
     url: '/crystals/zodiac/{sign}';
 };
@@ -35762,11 +37453,11 @@ export type GetCrystalsZodiacBySignResponses = {
             /**
              * URL to crystal photograph for visual identification.
              */
-            imageUrl: string;
+            imageUrl: string | null;
             /**
              * Primary colors of this crystal variety. Null when color data is unavailable.
              */
-            colors: Array<string>;
+            colors: Array<string> | null;
         }>;
     };
 };
@@ -35791,7 +37482,7 @@ export type GetCrystalsChakraByChakraData = {
         /**
          * Number of items to skip for pagination. Default 0.
          */
-        offset?: number;
+        offset?: number | null;
     };
     url: '/crystals/chakra/{chakra}';
 };
@@ -35933,11 +37624,11 @@ export type GetCrystalsChakraByChakraResponses = {
             /**
              * URL to crystal photograph for visual identification.
              */
-            imageUrl: string;
+            imageUrl: string | null;
             /**
              * Primary colors of this crystal variety. Null when color data is unavailable.
              */
-            colors: Array<string>;
+            colors: Array<string> | null;
         }>;
     };
 };
@@ -35962,7 +37653,7 @@ export type GetCrystalsElementByElementData = {
         /**
          * Number of items to skip for pagination. Default 0.
          */
-        offset?: number;
+        offset?: number | null;
     };
     url: '/crystals/element/{element}';
 };
@@ -36104,11 +37795,11 @@ export type GetCrystalsElementByElementResponses = {
             /**
              * URL to crystal photograph for visual identification.
              */
-            imageUrl: string;
+            imageUrl: string | null;
             /**
              * Primary colors of this crystal variety. Null when color data is unavailable.
              */
-            colors: Array<string>;
+            colors: Array<string> | null;
         }>;
     };
 };
@@ -36263,11 +37954,11 @@ export type GetCrystalsBirthstoneByMonthResponses = {
             /**
              * URL to crystal photograph for visual identification.
              */
-            imageUrl: string;
+            imageUrl: string | null;
             /**
              * Primary colors of this crystal variety. Null when color data is unavailable.
              */
-            colors: Array<string>;
+            colors: Array<string> | null;
         }>;
     };
 };
@@ -36291,7 +37982,7 @@ export type GetCrystalsSearchData = {
         /**
          * Number of items to skip for pagination. Default 0.
          */
-        offset?: number;
+        offset?: number | null;
     };
     url: '/crystals/search';
 };
@@ -36433,11 +38124,11 @@ export type GetCrystalsSearchResponses = {
             /**
              * URL to crystal photograph for visual identification.
              */
-            imageUrl: string;
+            imageUrl: string | null;
             /**
              * Primary colors of this crystal variety. Null when color data is unavailable.
              */
-            colors: Array<string>;
+            colors: Array<string> | null;
         }>;
     };
 };
@@ -36605,7 +38296,7 @@ export type GetCrystalsPairingsByIdResponses = {
             /**
              * URL to paired crystal photograph.
              */
-            imageUrl: string;
+            imageUrl: string | null;
             /**
              * Brief overview of the paired crystal.
              */
@@ -36617,7 +38308,7 @@ export type GetCrystalsPairingsByIdResponses = {
             /**
              * Healing property keywords for the paired crystal. Null when keyword data is unavailable.
              */
-            keywords: Array<string>;
+            keywords: Array<string> | null;
         }>;
     };
 };
@@ -36768,7 +38459,7 @@ export type PostCrystalsDailyResponses = {
         /**
          * URL to crystal photograph. Use for daily crystal card display and visual features.
          */
-        imageUrl: string;
+        imageUrl: string | null;
         /**
          * Overview of the crystal covering primary healing purpose and benefits.
          */
@@ -36780,7 +38471,7 @@ export type PostCrystalsDailyResponses = {
         /**
          * Zodiac signs this crystal is traditionally associated with. Null when zodiac data is unavailable.
          */
-        zodiacSigns: Array<string>;
+        zodiacSigns: Array<string> | null;
         /**
          * Positive affirmation aligned with the selected crystal. Use for daily affirmation features and meditation guidance.
          */
@@ -36917,7 +38608,7 @@ export type GetCrystalsRandomResponses = {
         /**
          * URL to crystal photograph for visual display.
          */
-        imageUrl: string;
+        imageUrl: string | null;
         /**
          * Overview of the crystal covering primary healing purpose and benefits.
          */
@@ -36929,7 +38620,7 @@ export type GetCrystalsRandomResponses = {
         /**
          * Zodiac signs this crystal is traditionally associated with. Null when zodiac data is unavailable.
          */
-        zodiacSigns: Array<string>;
+        zodiacSigns: Array<string> | null;
         /**
          * Positive affirmation aligned with the selected crystal energy.
          */
@@ -37220,7 +38911,7 @@ export type GetCrystalsData = {
         /**
          * Number of items to skip for pagination. Default 0.
          */
-        offset?: number;
+        offset?: number | null;
     };
     url: '/crystals';
 };
@@ -37358,11 +39049,11 @@ export type GetCrystalsResponses = {
             /**
              * URL to crystal photograph for visual identification.
              */
-            imageUrl: string;
+            imageUrl: string | null;
             /**
              * Primary colors of this crystal variety. Null when color data is unavailable.
              */
-            colors: Array<string>;
+            colors: Array<string> | null;
             /**
              * Chakra energy centers this crystal resonates with. One of: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown.
              */
@@ -37518,7 +39209,7 @@ export type GetCrystalsByIdResponses = {
         /**
          * URL to a high-quality crystal photograph. Use for visual crystal guides, product listings, and crystal identification features.
          */
-        imageUrl: string;
+        imageUrl: string | null;
         /**
          * Overview of the crystal covering its primary healing purpose, spiritual significance, and key benefits.
          */
@@ -37530,7 +39221,7 @@ export type GetCrystalsByIdResponses = {
             /**
              * Spiritual and metaphysical healing properties including energy work, meditation benefits, and higher consciousness connections. Null when spiritual interpretation is unavailable.
              */
-            spiritual: string;
+            spiritual: string | null;
             /**
              * Emotional healing properties including stress relief, relationship support, and emotional balance benefits.
              */
@@ -37538,7 +39229,7 @@ export type GetCrystalsByIdResponses = {
             /**
              * Physical healing associations traditionally attributed to this crystal in crystal healing practice. Null when physical healing data is unavailable.
              */
-            physical: string;
+            physical: string | null;
         };
         /**
          * Chakra energy centers this crystal resonates with. One of: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown.
@@ -37547,19 +39238,19 @@ export type GetCrystalsByIdResponses = {
         /**
          * Zodiac signs this crystal is traditionally associated with. Null when zodiac data is unavailable. Useful for personalized crystal recommendations based on birth chart.
          */
-        zodiacSigns: Array<string>;
+        zodiacSigns: Array<string> | null;
         /**
          * Ruling planet or celestial body associated with this crystal in astrological tradition. Null when planetary association is unavailable.
          */
-        planet: string;
+        planet: string | null;
         /**
          * Elemental associations (Earth, Water, Fire, Air, Storm) connecting the crystal to natural forces and energy types. Null when elemental data is unavailable.
          */
-        elements: Array<string>;
+        elements: Array<string> | null;
         /**
          * Primary colors of this crystal variety. Null when color data is unavailable. Useful for color-based crystal selection and filtering.
          */
-        colors: Array<string>;
+        colors: Array<string> | null;
         /**
          * Mohs hardness scale rating (1-10). Indicates durability for jewelry use. Quartz family is 7, Diamond is 10, Selenite is 2.
          */
@@ -37569,13 +39260,13 @@ export type GetCrystalsByIdResponses = {
          */
         numericalVibration: number;
         /**
-         * Five to nine keywords capturing the core healing properties and spiritual themes of this crystal. Null when keyword data is unavailable.
+         * Keywords capturing the core healing properties and spiritual themes of this crystal. The count varies by stone, from a single keyword up to twenty. Null when keyword data is unavailable.
          */
-        keywords: Array<string>;
+        keywords: Array<string> | null;
         /**
          * Birth month (1-12) if this crystal is a traditional birthstone. Null if not a birthstone. January is 1, December is 12.
          */
-        birthMonth: number;
+        birthMonth: number | null;
         /**
          * Positive affirmation aligned with this crystal energy. Use for meditation, journaling, or daily affirmation features.
          */
@@ -37606,7 +39297,7 @@ export type GetDreamsSymbolsData = {
         /**
          * Number of items to skip for pagination. Default 0.
          */
-        offset?: number;
+        offset?: number | null;
     };
     url: '/dreams/symbols';
 };
@@ -38287,7 +39978,7 @@ export type GetAngelNumbersNumbersData = {
         /**
          * Number of items to skip for pagination. Default 0.
          */
-        offset?: number;
+        offset?: number | null;
         /**
          * Filter results by angel number pattern type. "repeating" returns numbers like 111, 444, 7777. "sequential" returns patterns like 1234. "mirror" returns palindrome or alternating patterns like 1212, 717. "master" returns 11, 22, 33. "root" returns single digits 0-9. "compound" returns mixed sequences with no pure pattern like 911, 1122.
          */
@@ -38870,7 +40561,7 @@ export type GetAngelNumbersLookupResponses = {
              * Actionable steps when you see this number.
              */
             actionSteps: Array<string>;
-        };
+        } | null;
         /**
          * The foundational meaning of this number based on its digit root. Every number reduces to a root digit (0-9) or master number (11, 22, 33), which provides the base interpretation even for unknown sequences.
          */
@@ -38891,10 +40582,25 @@ export type GetAngelNumbersLookupResponses = {
              * Full life-area interpretation of the underlying root digit. For an unknown sequence this is the substantive reading to display, so a synchronicity app never dead-ends on an arbitrary number.
              */
             meaning: {
+                /**
+                 * Spiritual interpretation of the root digit, covering divine guidance, higher purpose, and metaphysical significance.
+                 */
                 spiritual: string;
+                /**
+                 * Love and relationship interpretation of the root digit, for singles, couples, and those healing from past relationships.
+                 */
                 love: string;
+                /**
+                 * Career and vocation guidance for the root digit. Money and finances are returned separately in the money field.
+                 */
                 career: string;
+                /**
+                 * Money, finances, and material abundance guidance for the root digit, kept distinct from career.
+                 */
                 money: string;
+                /**
+                 * Twin flame interpretation of the root digit, covering union, separation, and spiritual growth.
+                 */
                 twinFlame: string;
             };
             /**
@@ -38905,7 +40611,7 @@ export type GetAngelNumbersLookupResponses = {
              * Affirmation for the root digit.
              */
             affirmation: string;
-        };
+        } | null;
         /**
          * Present only when the context query parameter is supplied. A short reading layered on top of the meaning that accounts for WHERE the number was seen (clock, receipt, license plate, phone, address, price), since the place of a sighting shifts its emphasis.
          */
@@ -39135,7 +40841,7 @@ export type GetLocationSearchData = {
         /**
          * Number of items to skip for pagination. Default 0.
          */
-        offset?: number;
+        offset?: number | null;
     };
     url: '/location/search';
 };
@@ -39313,7 +41019,7 @@ export type GetLocationCountriesData = {
         /**
          * Number of items to skip for pagination. Default 0.
          */
-        offset?: number;
+        offset?: number | null;
     };
     url: '/location/countries';
 };
@@ -39476,7 +41182,7 @@ export type GetLocationCountriesByIso2Data = {
         /**
          * Number of items to skip for pagination. Default 0.
          */
-        offset?: number;
+        offset?: number | null;
     };
     url: '/location/countries/{iso2}';
 };
@@ -39762,12 +41468,33 @@ export type GetUsageResponses = {
      * Usage statistics retrieved
      */
     200: {
+        /**
+         * Name of the subscription plan the API key belongs to. One flat plan covers every domain and the Remote MCP servers, so this is a quota tier, never a per product entitlement.
+         */
         plan: string;
+        /**
+         * Billable requests counted against the current calendar month. Read from the same counter the rate limiter enforces on, so it never reports a rosier number than the limit that will 429 you. Cached responses still count.
+         */
         usedThisMonth: number;
+        /**
+         * Monthly request allowance for the plan. One request, API or MCP, equals one unit: there is no credit weighting and no per domain fee.
+         */
         requestsPerMonth: number;
+        /**
+         * Requests left before the monthly allowance is exhausted, floored at zero. Equal to requestsPerMonth minus usedThisMonth.
+         */
         remainingThisMonth: number;
+        /**
+         * Billing email the subscription is registered under.
+         */
         email: string;
+        /**
+         * Subscription lifecycle state. Values: active, cancelled (no longer renewing but usable until endDate), suspended (payment failed, usable until endDate), expired (past endDate), pending (checkout started, payment not captured).
+         */
         status: string;
+        /**
+         * ISO 8601 timestamp when the current billing period ends. A renewal extends this date in place. API access survives a cancelled or suspended status until this moment passes.
+         */
         endDate: string;
     };
 };