@roxyapi/sdk 1.2.54 → 1.2.56

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.
@@ -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;
         /**
@@ -2873,9 +2894,17 @@ export type BirthChartResponse = {
          */
         quality: 'Positive' | 'Negative' | 'Both';
         /**
-         * True if every classical condition for the yoga is satisfied by the given chart. False if any rule fails, including "almost-present" cases where dignity is met but kendra/aspect is not, and Nabhasa cases where the yoga matched its own rule but a stronger family outranked it under the classical precedence norms. Read `evidence` to tell those apart.
+         * Classical grouping, ALWAYS present on a detection verdict: one of the four Nabhasa families (asraya, dala, akriti, sankhya) or classical for the twelve single-combination yogas such as Gajakesari and the Pancha Mahapurusha. Group the verdict list on this key to render a Nabhasa result the way the tradition arranges it. Never translated, so grouping works identically under any lang.
+         */
+        family: 'classical' | 'asraya' | 'dala' | 'akriti' | 'sankhya';
+        /**
+         * True if every classical condition for the yoga is satisfied by the given chart. False means one of TWO different things: the rule failed, or the rule held and a stronger family outranked it. Read `suppressedBy` to tell those apart, which is exact and locale-independent; `evidence` says the same thing in English prose.
          */
         present: boolean;
+        /**
+         * Set ONLY when this yoga matched its own classical rule and was then silenced by a higher-ranking family, so `present` is false for a reason a practitioner reads very differently from a failed rule. Names the family that took precedence, under the four classical norms: Akriti outranks Asraya, and Akriti, Asraya and Dala each outrank Sankhya. Absent means the rule genuinely did not hold.
+         */
+        suppressedBy?: 'classical' | 'asraya' | 'dala' | 'akriti' | 'sankhya';
         /**
          * Human-readable rationale naming the specific rule that triggered or failed the detection, including planetary positions, dignity, kendradhipati status, lordship, malefic drishti, sign modality, or whole-chart bhava distribution. For a Nabhasa yoga that matched its own rule but was outranked, this names the precedence norm that silenced it, for example that an Akriti yoga outranks Asraya or that any other Nabhasa family suppresses Sankhya.
          */
@@ -2903,11 +2932,11 @@ export type BirthChartResponse = {
              */
             nakshatra: {
                 /**
-                 * Nakshatra (lunar mansion) the planet occupies. One of 27 Vedic nakshatras spanning 13 degrees 20 arcminutes each. Determines dasha lord and behavioral qualities.
+                 * Nakshatra (lunar mansion) the planet occupies. One of 27 Vedic nakshatras spanning 13 degrees 20 minutes each. Determines dasha lord and behavioral qualities.
                  */
                 name: string;
                 /**
-                 * Nakshatra pada (quarter, 1-4). Each nakshatra divides into 4 padas of 3 degrees 20 arcminutes. Pada determines Navamsa sign and refines personality traits.
+                 * Nakshatra pada (quarter, 1-4). Each nakshatra divides into 4 padas of 3 degrees 20 minutes. Pada determines Navamsa sign and refines personality traits.
                  */
                 pada: number;
                 /**
@@ -2927,6 +2956,41 @@ export type BirthChartResponse = {
              * Bhava (house) number 1-12, counted whole-sign from the Lagna (house 1 is the Lagna rashi; Lagna itself is house 1). Present on the D1 birth chart; divisional charts omit it.
              */
             house?: number;
+            /**
+             * Localized readings for this graha avastha states, present only when avasthaInfo true was sent. Each key mirrors the state field of the same name and carries a short meaning plus a one-sentence classical interpretation, so a client can label Yuva or Swapna without a second lookup call.
+             */
+            avasthaInfo?: {
+                awastha?: {
+                    /**
+                     * One or two word gloss of the state, suitable for a table cell beside the graha.
+                     */
+                    meaning: string;
+                    /**
+                     * Single-sentence classical reading of what the state does to the graha results, sourced from BPHS ch. 45, Saravali ch. 5 and Phaladeepika ch. 9. Localized by the lang query parameter.
+                     */
+                    interpretation: string;
+                };
+                jagradadi?: {
+                    /**
+                     * One or two word gloss of the state, suitable for a table cell beside the graha.
+                     */
+                    meaning: string;
+                    /**
+                     * Single-sentence classical reading of what the state does to the graha results, sourced from BPHS ch. 45, Saravali ch. 5 and Phaladeepika ch. 9. Localized by the lang query parameter.
+                     */
+                    interpretation: string;
+                };
+                deeptadi?: {
+                    /**
+                     * One or two word gloss of the state, suitable for a table cell beside the graha.
+                     */
+                    meaning: string;
+                    /**
+                     * Single-sentence classical reading of what the state does to the graha results, sourced from BPHS ch. 45, Saravali ch. 5 and Phaladeepika ch. 9. Localized by the lang query parameter.
+                     */
+                    interpretation: string;
+                };
+            };
             /**
              * Baladi avastha, the planetary age-state set by the graha degree within its sign: Bala (infant), Kumara (child), Yuva (adult, strongest results), Vriddha (old), Mrita (dead, weakest). Bands run forward in odd signs and reversed in even signs. D1 birth chart only.
              */
@@ -2963,6 +3027,10 @@ 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;
+    /**
+     * 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;
 };
 export type NavamsaResponse = {
     /**
@@ -2991,11 +3059,11 @@ export type NavamsaResponse = {
                  */
                 nakshatra: {
                     /**
-                     * Nakshatra (lunar mansion) the planet occupies. One of 27 Vedic nakshatras spanning 13 degrees 20 arcminutes each. Determines dasha lord and behavioral qualities.
+                     * Nakshatra (lunar mansion) the planet occupies. One of 27 Vedic nakshatras spanning 13 degrees 20 minutes each. Determines dasha lord and behavioral qualities.
                      */
                     name: string;
                     /**
-                     * Nakshatra pada (quarter, 1-4). Each nakshatra divides into 4 padas of 3 degrees 20 arcminutes. Pada determines Navamsa sign and refines personality traits.
+                     * Nakshatra pada (quarter, 1-4). Each nakshatra divides into 4 padas of 3 degrees 20 minutes. Pada determines Navamsa sign and refines personality traits.
                      */
                     pada: number;
                     /**
@@ -3022,7 +3090,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;
             /**
@@ -3153,11 +3221,11 @@ export type DivisionalChartResponse = {
                  */
                 nakshatra: {
                     /**
-                     * Nakshatra (lunar mansion) the planet occupies. One of 27 Vedic nakshatras spanning 13 degrees 20 arcminutes each. Determines dasha lord and behavioral qualities.
+                     * Nakshatra (lunar mansion) the planet occupies. One of 27 Vedic nakshatras spanning 13 degrees 20 minutes each. Determines dasha lord and behavioral qualities.
                      */
                     name: string;
                     /**
-                     * Nakshatra pada (quarter, 1-4). Each nakshatra divides into 4 padas of 3 degrees 20 arcminutes. Pada determines Navamsa sign and refines personality traits.
+                     * Nakshatra pada (quarter, 1-4). Each nakshatra divides into 4 padas of 3 degrees 20 minutes. Pada determines Navamsa sign and refines personality traits.
                      */
                     pada: number;
                     /**
@@ -3184,7 +3252,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;
             /**
@@ -3410,11 +3478,11 @@ export type PlanetaryPositionsResponse = {
          */
         nakshatra: {
             /**
-             * Nakshatra (lunar mansion) the planet occupies. One of 27 Vedic nakshatras spanning 13 degrees 20 arcminutes each.
+             * Nakshatra (lunar mansion) the planet occupies. One of 27 Vedic nakshatras spanning 13 degrees 20 minutes each.
              */
             name: string;
             /**
-             * Nakshatra pada (quarter, 1-4). Each nakshatra divides into 4 padas of 3 degrees 20 arcminutes. Determines Navamsa sign.
+             * Nakshatra pada (quarter, 1-4). Each nakshatra divides into 4 padas of 3 degrees 20 minutes. Determines Navamsa sign.
              */
             pada: number;
             /**
@@ -3713,6 +3781,10 @@ export type YogaDetail = {
      * Overall nature. Auspicious yogas (Pancha Mahapurusha, Gajakesari) bestow benefits; inauspicious yogas (Kemadruma) indicate challenges; Both denotes context-dependent effects.
      */
     quality: 'Positive' | 'Negative' | 'Both';
+    /**
+     * Nabhasa family this yoga belongs to, present only on the 32 Nabhasa distribution yogas: asraya (3, sign modality), dala (2, benefic or malefic kendra tenancy), akriti (20, bhava shape) and sankhya (7, count of occupied rasis). Absent on every other glossary row, which is most of the catalog, since those are single-combination yogas outside the Nabhasa scheme. Group or filter the catalog on this key; it is never translated.
+     */
+    family?: 'classical' | 'asraya' | 'dala' | 'akriti' | 'sankhya';
 };
 export type YogaDetectResponse = {
     /**
@@ -3740,9 +3812,17 @@ export type YogaDetectResponse = {
          */
         quality: 'Positive' | 'Negative' | 'Both';
         /**
-         * True if every classical condition for the yoga is satisfied by the given chart. False if any rule fails, including "almost-present" cases where dignity is met but kendra/aspect is not, and Nabhasa cases where the yoga matched its own rule but a stronger family outranked it under the classical precedence norms. Read `evidence` to tell those apart.
+         * Classical grouping, ALWAYS present on a detection verdict: one of the four Nabhasa families (asraya, dala, akriti, sankhya) or classical for the twelve single-combination yogas such as Gajakesari and the Pancha Mahapurusha. Group the verdict list on this key to render a Nabhasa result the way the tradition arranges it. Never translated, so grouping works identically under any lang.
+         */
+        family: 'classical' | 'asraya' | 'dala' | 'akriti' | 'sankhya';
+        /**
+         * True if every classical condition for the yoga is satisfied by the given chart. False means one of TWO different things: the rule failed, or the rule held and a stronger family outranked it. Read `suppressedBy` to tell those apart, which is exact and locale-independent; `evidence` says the same thing in English prose.
          */
         present: boolean;
+        /**
+         * Set ONLY when this yoga matched its own classical rule and was then silenced by a higher-ranking family, so `present` is false for a reason a practitioner reads very differently from a failed rule. Names the family that took precedence, under the four classical norms: Akriti outranks Asraya, and Akriti, Asraya and Dala each outrank Sankhya. Absent means the rule genuinely did not hold.
+         */
+        suppressedBy?: 'classical' | 'asraya' | 'dala' | 'akriti' | 'sankhya';
         /**
          * Human-readable rationale naming the specific rule that triggered or failed the detection, including planetary positions, dignity, kendradhipati status, lordship, malefic drishti, sign modality, or whole-chart bhava distribution. For a Nabhasa yoga that matched its own rule but was outranked, this names the precedence norm that silenced it, for example that an Akriti yoga outranks Asraya or that any other Nabhasa family suppresses Sankhya.
          */
@@ -3756,10 +3836,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;
     };
 };
@@ -3893,9 +3988,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.
      */
@@ -3966,6 +4061,10 @@ export type KpCuspsResponse = {
     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 KpCuspsRequest = {
     /**
@@ -3989,9 +4088,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.
      */
@@ -4027,7 +4126,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;
         /**
@@ -4316,6 +4415,10 @@ export type KpChartResponse = {
     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 KpChartRequest = {
     /**
@@ -4339,9 +4442,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.
      */
@@ -4360,8 +4463,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;
     };
     /**
@@ -4423,6 +4535,10 @@ export type KpRulingPlanetsResponse = {
     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 KpRulingPlanetsIntervalResponse = {
     /**
@@ -4618,6 +4734,10 @@ export type KpRulingPlanetsIntervalResponse = {
     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 KpSublordChangesResponse = {
     /**
@@ -4696,9 +4816,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".
      */
@@ -4773,9 +4893,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".
      */
@@ -4897,9 +5017,9 @@ 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';
+    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".
      */
@@ -5297,7 +5417,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;
         /**
@@ -5305,7 +5425,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;
         /**
@@ -5540,6 +5660,207 @@ export type CharaKarakaRequest = {
      */
     scheme?: 'seven' | 'eight';
 };
+/**
+ * Complete Bhava Bala (house strength) analysis per Brihat Parashara Hora Shastra, with a localized house-meaning legend.
+ */
+export type BhavaBalaResponse = {
+    /**
+     * 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;
+};
+/**
+ * Bhav Chalit (Chalit Kundli): every graha placed by unequal Sripati bhava, with the whole-sign placement beside it for comparison.
+ */
+export type BhavChalitResponse = {
+    /**
+     * 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;
+};
 export type BasicCard = {
     /**
      * Unique card identifier in kebab-case (e.g. fool, ace-of-cups, queen-of-swords).
@@ -8746,7 +9067,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;
                 /**
@@ -13539,9 +13860,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.
          */
@@ -13681,6 +14002,10 @@ export type PostVedicAstrologyDashaCurrentResponses = {
         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';
         /**
          * Birth Moon nakshatra number (1-27). This nakshatra determines the starting dasha lord in the Vimshottari 120-year cycle.
          */
@@ -13704,7 +14029,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.
          */
@@ -14349,9 +14674,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.
          */
@@ -14491,6 +14816,10 @@ export type PostVedicAstrologyDashaMajorResponses = {
         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';
         /**
          * Birth Moon nakshatra number (1-27) that determines the Vimshottari starting point.
          */
@@ -14514,7 +14843,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.
          */
@@ -14658,9 +14987,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.
          */
@@ -14805,6 +15134,10 @@ export type PostVedicAstrologyDashaSubByMahadashaResponses = {
         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';
         /**
          * Ruling planet of the requested Mahadasha period.
          */
@@ -14820,7 +15153,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.
          */
@@ -15035,9 +15368,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.
          */
@@ -15186,6 +15519,10 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses = {
         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';
         /**
          * Ruling planet of the requested Mahadasha period.
          */
@@ -15205,7 +15542,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.
          */
@@ -15428,9 +15765,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.
          */
@@ -15583,6 +15920,10 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaRe
         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';
         /**
          * Ruling planet of the requested Mahadasha period.
          */
@@ -15606,7 +15947,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.
          */
@@ -15837,9 +16178,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.
          */
@@ -15996,6 +16337,10 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBy
         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';
         /**
          * Ruling planet of the requested Mahadasha period.
          */
@@ -16023,7 +16368,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.
          */
@@ -16654,20 +16999,24 @@ 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;
         /**
@@ -16842,11 +17191,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;
         };
@@ -17294,6 +17643,9 @@ 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)
@@ -17880,6 +18232,10 @@ export type GetVedicAstrologyYogaData = {
          * 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';
 };
@@ -17991,20 +18347,24 @@ export type GetVedicAstrologyYogaResponses = {
      */
     200: {
         /**
-         * Array of all planetary yogas with basic identifiers. Use GET /yogas/:id for formation rules, effects, and quality classification.
+         * 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 /yogas/:id.
+             * 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';
         }>;
         /**
-         * Total count of planetary yogas in the database. Includes Raj Yogas, Dhan Yogas, Pancha Mahapurusha Yogas, Nabhasa Yogas, and more.
+         * 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;
     };
@@ -18939,9 +19299,9 @@ export type PostVedicAstrologyKpRulingPlanetsIntervalData = {
          */
         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".
          */
@@ -20167,11 +20527,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;
         /**
@@ -20587,7 +20947,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;
         /**
@@ -21964,12 +22324,171 @@ export type GetVedicAstrologyAvasthasErrors = {
         code: string;
     };
 };
-export type GetVedicAstrologyAvasthasError = GetVedicAstrologyAvasthasErrors[keyof GetVedicAstrologyAvasthasErrors];
-export type GetVedicAstrologyAvasthasResponses = {
+export type GetVedicAstrologyAvasthasError = GetVedicAstrologyAvasthasErrors[keyof GetVedicAstrologyAvasthasErrors];
+export type GetVedicAstrologyAvasthasResponses = {
+    /**
+     * Avastha states with their labels and interpretations, in system order.
+     */
+    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 GetVedicAstrologyAvasthasResponse = GetVedicAstrologyAvasthasResponses[keyof GetVedicAstrologyAvasthasResponses];
+export type GetVedicAstrologyAvasthasByIdData = {
+    body?: 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';
+    };
+    url: '/vedic-astrology/avasthas/{id}';
+};
+export type GetVedicAstrologyAvasthasByIdErrors = {
+    /**
+     * 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;
+    };
+    /**
+     * 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.
+     */
+    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 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.
          */
@@ -21990,26 +22509,21 @@ 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: {
-        /**
-         * 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';
     };
+};
+export type GetVedicAstrologyAvasthasByIdResponse = GetVedicAstrologyAvasthasByIdResponses[keyof GetVedicAstrologyAvasthasByIdResponses];
+export type PostVedicAstrologyArudhaData = {
+    body?: ArudhaRequest;
+    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/arudha';
 };
-export type GetVedicAstrologyAvasthasByIdErrors = {
+export type PostVedicAstrologyArudhaErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -22068,19 +22582,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.
      */
@@ -22123,47 +22624,150 @@ export type GetVedicAstrologyAvasthasByIdErrors = {
         code: string;
     };
 };
-export type GetVedicAstrologyAvasthasByIdError = GetVedicAstrologyAvasthasByIdErrors[keyof GetVedicAstrologyAvasthasByIdErrors];
-export type GetVedicAstrologyAvasthasByIdResponses = {
+export type PostVedicAstrologyArudhaError = PostVedicAstrologyArudhaErrors[keyof PostVedicAstrologyArudhaErrors];
+export type PostVedicAstrologyArudhaResponses = {
     /**
-     * The avastha state with its system, label and interpretation.
+     * All twelve Arudha padas with derivation detail, plus the Arudha Lagna and Upapada lifted to the top level.
      */
-    200: {
+    200: ArudhaResponse;
+};
+export type PostVedicAstrologyArudhaResponse = PostVedicAstrologyArudhaResponses[keyof PostVedicAstrologyArudhaResponses];
+export type PostVedicAstrologyCharaKarakasData = {
+    body?: CharaKarakaRequest;
+    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';
+    };
+    url: '/vedic-astrology/chara-karakas';
+};
+export type PostVedicAstrologyCharaKarakasErrors = {
+    /**
+     * Validation error. `issues[]` lists every failed field.
+     */
+    400: {
         /**
-         * Sanskrit name of the state, exactly as it appears in the `awastha`, `jagradadi` or `deeptadi` field of a birth chart.
+         * First issue summary.
          */
-        name: string;
+        error: string;
+        code: 'validation_error';
         /**
-         * 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.
+         * Every validation failure. Use this to rebuild a valid request.
          */
-        system: 'baladi' | 'jagradadi' | 'deeptadi';
+        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: {
         /**
-         * Short label for the state, sized for a table cell beside the graha.
+         * Human-readable error message. May change wording.
          */
-        meaning: string;
+        error: 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.
+         * Machine-readable error code. Stable identifier.
          */
-        interpretation: string;
+        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 PostVedicAstrologyCharaKarakasError = PostVedicAstrologyCharaKarakasErrors[keyof PostVedicAstrologyCharaKarakasErrors];
+export type PostVedicAstrologyCharaKarakasResponses = {
+    /**
+     * Karaka offices in descending rank with the ranking degree for each, plus the Atmakaraka and Darakaraka lifted to the top level.
+     */
+    200: CharaKarakaResponse;
+};
+export type PostVedicAstrologyCharaKarakasResponse = PostVedicAstrologyCharaKarakasResponses[keyof PostVedicAstrologyCharaKarakasResponses];
+export type PostVedicAstrologyBhavaBalaData = {
+    body?: BhavaBalaRequest;
     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/bhava-bala';
 };
-export type PostVedicAstrologyArudhaErrors = {
+export type PostVedicAstrologyBhavaBalaErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -22264,26 +22868,30 @@ export type PostVedicAstrologyArudhaErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyArudhaError = PostVedicAstrologyArudhaErrors[keyof PostVedicAstrologyArudhaErrors];
-export type PostVedicAstrologyArudhaResponses = {
+export type PostVedicAstrologyBhavaBalaError = PostVedicAstrologyBhavaBalaErrors[keyof PostVedicAstrologyBhavaBalaErrors];
+export type PostVedicAstrologyBhavaBalaResponses = {
     /**
-     * All twelve Arudha padas with derivation detail, plus the Arudha Lagna and Upapada lifted to the top level.
+     * Bhava Bala for all twelve houses with the three components, totals in virupas and rupas, ranking, and the localized house-theme legend.
      */
-    200: ArudhaResponse;
+    200: BhavaBalaResponse;
 };
-export type PostVedicAstrologyArudhaResponse = PostVedicAstrologyArudhaResponses[keyof PostVedicAstrologyArudhaResponses];
-export type PostVedicAstrologyCharaKarakasData = {
-    body?: CharaKarakaRequest;
+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/chara-karakas';
+    url: '/vedic-astrology/bhav-chalit';
 };
-export type PostVedicAstrologyCharaKarakasErrors = {
+export type PostVedicAstrologyBhavChalitErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -22384,14 +22992,14 @@ export type PostVedicAstrologyCharaKarakasErrors = {
         code: string;
     };
 };
-export type PostVedicAstrologyCharaKarakasError = PostVedicAstrologyCharaKarakasErrors[keyof PostVedicAstrologyCharaKarakasErrors];
-export type PostVedicAstrologyCharaKarakasResponses = {
+export type PostVedicAstrologyBhavChalitError = PostVedicAstrologyBhavChalitErrors[keyof PostVedicAstrologyBhavChalitErrors];
+export type PostVedicAstrologyBhavChalitResponses = {
     /**
-     * Karaka offices in descending rank with the ranking degree for each, plus the Atmakaraka and Darakaraka 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: CharaKarakaResponse;
+    200: BhavChalitResponse;
 };
-export type PostVedicAstrologyCharaKarakasResponse = PostVedicAstrologyCharaKarakasResponses[keyof PostVedicAstrologyCharaKarakasResponses];
+export type PostVedicAstrologyBhavChalitResponse = PostVedicAstrologyBhavChalitResponses[keyof PostVedicAstrologyBhavChalitResponses];
 export type PostForecastTimelineData = {
     body?: {
         /**
@@ -22582,9 +23190,9 @@ export type PostForecastTimelineResponses = {
              */
             time: string;
             /**
-             * IANA name (e.g. "America/New_York", "Europe/London", "UTC"), decimal hours (e.g. -5 for EST, 1 for CET), or a fixed UTC offset (e.g. "-05:00", "+01:00"). Prefer the IANA name: it is resolved to the DST-correct offset for the birth date, while a fixed offset or decimal is taken literally and will be wrong if it does not match the daylight-saving state on that date. Invalid timezones return 400 with a validation error.
+             * Decimal UTC offset the forecast was computed with, resolved from whatever the request sent. An IANA name is resolved to the DST-correct offset for the birth date, so this is the literal number applied, never the name.
              */
-            timezone: number | string;
+            timezone: number;
             /**
              * Birth latitude in decimal degrees. Optional and does not affect the timeline. Defaults to 0.
              */
@@ -22839,9 +23447,9 @@ export type PostForecastTransitsResponses = {
              */
             time: string;
             /**
-             * IANA name (e.g. "America/New_York", "Europe/London", "UTC"), decimal hours (e.g. -5 for EST, 1 for CET), or a fixed UTC offset (e.g. "-05:00", "+01:00"). Prefer the IANA name: it is resolved to the DST-correct offset for the birth date, while a fixed offset or decimal is taken literally and will be wrong if it does not match the daylight-saving state on that date. Invalid timezones return 400 with a validation error.
+             * Decimal UTC offset the forecast was computed with, resolved from whatever the request sent. An IANA name is resolved to the DST-correct offset for the birth date, so this is the literal number applied, never the name.
              */
-            timezone: number | string;
+            timezone: number;
             /**
              * Birth latitude in decimal degrees. Optional and does not affect the timeline. Defaults to 0.
              */
@@ -23117,9 +23725,9 @@ export type PostForecastSignificantDatesResponses = {
              */
             time: string;
             /**
-             * IANA name (e.g. "America/New_York", "Europe/London", "UTC"), decimal hours (e.g. -5 for EST, 1 for CET), or a fixed UTC offset (e.g. "-05:00", "+01:00"). Prefer the IANA name: it is resolved to the DST-correct offset for the birth date, while a fixed offset or decimal is taken literally and will be wrong if it does not match the daylight-saving state on that date. Invalid timezones return 400 with a validation error.
+             * Decimal UTC offset the forecast was computed with, resolved from whatever the request sent. An IANA name is resolved to the DST-correct offset for the birth date, so this is the literal number applied, never the name.
              */
-            timezone: number | string;
+            timezone: number;
             /**
              * Birth latitude in decimal degrees. Optional and does not affect the timeline. Defaults to 0.
              */
@@ -23395,9 +24003,9 @@ export type PostForecastDigestResponses = {
              */
             time: string;
             /**
-             * IANA name (e.g. "America/New_York", "Europe/London", "UTC"), decimal hours (e.g. -5 for EST, 1 for CET), or a fixed UTC offset (e.g. "-05:00", "+01:00"). Prefer the IANA name: it is resolved to the DST-correct offset for the birth date, while a fixed offset or decimal is taken literally and will be wrong if it does not match the daylight-saving state on that date. Invalid timezones return 400 with a validation error.
+             * Decimal UTC offset the forecast was computed with, resolved from whatever the request sent. An IANA name is resolved to the DST-correct offset for the birth date, so this is the literal number applied, never the name.
              */
-            timezone: number | string;
+            timezone: number;
             /**
              * Birth latitude in decimal degrees. Optional and does not affect the timeline. Defaults to 0.
              */
@@ -23439,20 +24047,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;
             };
             /**
@@ -26560,7 +27198,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;
             };
             /**
@@ -31974,6 +32618,10 @@ export type PostTarotYesNoResponses = {
          * The querent question that was asked, if one was provided.
          */
         question?: string;
+        /**
+         * The seed used for this draw, echoed back when one was supplied. Present only if the request carried a seed. Makes a cached or forwarded response self describing, so a reading can be reproduced or shared without the original request beside it.
+         */
+        seed?: string;
         /**
          * Tarot-derived answer. Yes = upright card supports a positive outcome. No = reversed card suggests obstacles. Maybe = inherently ambiguous card drawn (The Hanged Man, Wheel of Fortune, Temperance, Two of Swords, Four of Swords) signaling pause, reflection, or shifting circumstances.
          */
@@ -32173,7 +32821,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;
     };
@@ -32181,7 +32829,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;
@@ -32331,7 +32985,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;
     };
@@ -32339,7 +32993,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;
@@ -32489,7 +33149,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;
     };
@@ -32497,7 +33157,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;
@@ -32647,7 +33313,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;
     };
@@ -32827,10 +33493,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];
@@ -37458,7 +38120,7 @@ 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>;
         /**
@@ -38780,10 +39442,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;
             };
             /**
@@ -39651,12 +40328,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;
     };
 };