@roxyapi/sdk 1.2.26 → 1.2.28

package/src/types.gen.ts

@@ -146,6 +146,57 @@ export type NatalChartResponse = {
          */
         interpretation: string;
     }>;
+    /**
+     * Detected multi-planet aspect configurations (Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle, Stellium). Grand Cross suppresses contained T-Squares, Kite suppresses underlying Grand Trine.
+     */
+    patterns?: Array<{
+        /**
+         * Pattern kind identifier. GRAND_TRINE (3 trines, harmonious flow), KITE (Grand Trine with a focal outlet planet), T_SQUARE (opposition with squared apex, growth engine), GRAND_CROSS (4 planets in 2 oppositions and 4 squares, peak tension), YOD (Finger of Fate, fated adjustment), MYSTIC_RECTANGLE (oppositions softened by trines and sextiles), STELLIUM (3+ planets clustered in a sign or 10-degree arc).
+         */
+        kind: 'GRAND_TRINE' | 'KITE' | 'T_SQUARE' | 'GRAND_CROSS' | 'YOD' | 'MYSTIC_RECTANGLE' | 'STELLIUM';
+        /**
+         * Human-readable name of the configuration as used in astrological literature.
+         */
+        name: string;
+        /**
+         * Participating bodies in canonical order. For Kite, T-Square, and Yod the apex planet appears first.
+         */
+        planets: Array<string>;
+        /**
+         * Focal planet for Kite, T-Square, and Yod patterns. Receives the released energy of the configuration and is the recommended integration point.
+         */
+        apex?: string;
+        /**
+         * Dominant element when the pattern is element-coherent (Grand Trine, Kite). Reported lowercase. Absent for patterns whose meaning does not pivot on element.
+         */
+        element?: 'fire' | 'earth' | 'air' | 'water';
+        /**
+         * Dominant modality for tension-based patterns (T-Square, Grand Cross). Cardinal initiates, Fixed sustains, Mutable adapts.
+         */
+        modality?: 'cardinal' | 'fixed' | 'mutable';
+        /**
+         * True if the pattern is out-of-sign (one or more planets in a neighboring element or modality). Dissociate patterns are still valid but operate with weakened thematic coherence.
+         */
+        dissociate?: boolean;
+        /**
+         * Tightness score (0-100) derived from the average orb tightness across all defining aspects. Higher means closer to exact and stronger thematic expression.
+         */
+        tightness: number;
+        /**
+         * Concise one-line interpretation naming the participating planets and theme. Localized to the requested language via the lang query parameter (defaults to English).
+         */
+        interpretation: string;
+        /**
+         * Stable template identifier used to render the interpretation. Useful for clients that wish to swap in a custom narrative template while preserving the structured variables.
+         */
+        interpretationKey: string;
+        /**
+         * Variables that were interpolated into the interpretation template. Names already resolved to the requested language where appropriate.
+         */
+        interpretationVars: {
+            [key: string]: string;
+        };
+    }>;
     /**
      * Aspect pattern analysis showing the balance of harmonious vs challenging energies in the chart.
      */
@@ -205,6 +256,44 @@ export type NatalChartResponse = {
          */
         longitude: number;
     };
+    /**
+     * Part of Fortune (Lot of Fortune). A point derived from the Ascendant and the two luminaries that marks an area of ease, vitality, and material wellbeing in the chart.
+     */
+    partOfFortune: {
+        /**
+         * Zodiac sign holding the Part of Fortune.
+         */
+        sign: string;
+        /**
+         * Degree within the Part of Fortune sign (0-29.999).
+         */
+        degree: number;
+        /**
+         * Absolute ecliptic longitude of the Part of Fortune (0-360).
+         */
+        longitude: number;
+        /**
+         * Chart sect used for the calculation. Day (diurnal) when the Sun is above the horizon, night (nocturnal) when below. Day charts use Ascendant plus Moon minus Sun, night charts use Ascendant plus Sun minus Moon.
+         */
+        sect: 'day' | 'night';
+    };
+    /**
+     * Vertex. The western intersection of the prime vertical with the ecliptic, often read as a point of fated encounters and turning-point relationships. The opposite point is the Anti-Vertex.
+     */
+    vertex: {
+        /**
+         * Zodiac sign holding the Vertex.
+         */
+        sign: string;
+        /**
+         * Degree within the Vertex sign (0-29.999).
+         */
+        degree: number;
+        /**
+         * Absolute ecliptic longitude of the Vertex (0-360).
+         */
+        longitude: number;
+    };
     /**
      * Chart summary with dominant element, modality, retrograde planets, and distribution analysis.
      */
@@ -442,6 +531,57 @@ export type AspectsResponse = {
             nature: string;
         };
     }>;
+    /**
+     * Detected multi-planet aspect configurations (Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle, Stellium).
+     */
+    patterns?: Array<{
+        /**
+         * Pattern kind identifier. GRAND_TRINE (3 trines, harmonious flow), KITE (Grand Trine with a focal outlet planet), T_SQUARE (opposition with squared apex, growth engine), GRAND_CROSS (4 planets in 2 oppositions and 4 squares, peak tension), YOD (Finger of Fate, fated adjustment), MYSTIC_RECTANGLE (oppositions softened by trines and sextiles), STELLIUM (3+ planets clustered in a sign or 10-degree arc).
+         */
+        kind: 'GRAND_TRINE' | 'KITE' | 'T_SQUARE' | 'GRAND_CROSS' | 'YOD' | 'MYSTIC_RECTANGLE' | 'STELLIUM';
+        /**
+         * Human-readable name of the configuration as used in astrological literature.
+         */
+        name: string;
+        /**
+         * Participating bodies in canonical order. For Kite, T-Square, and Yod the apex planet appears first.
+         */
+        planets: Array<string>;
+        /**
+         * Focal planet for Kite, T-Square, and Yod patterns. Receives the released energy of the configuration and is the recommended integration point.
+         */
+        apex?: string;
+        /**
+         * Dominant element when the pattern is element-coherent (Grand Trine, Kite). Reported lowercase. Absent for patterns whose meaning does not pivot on element.
+         */
+        element?: 'fire' | 'earth' | 'air' | 'water';
+        /**
+         * Dominant modality for tension-based patterns (T-Square, Grand Cross). Cardinal initiates, Fixed sustains, Mutable adapts.
+         */
+        modality?: 'cardinal' | 'fixed' | 'mutable';
+        /**
+         * True if the pattern is out-of-sign (one or more planets in a neighboring element or modality). Dissociate patterns are still valid but operate with weakened thematic coherence.
+         */
+        dissociate?: boolean;
+        /**
+         * Tightness score (0-100) derived from the average orb tightness across all defining aspects. Higher means closer to exact and stronger thematic expression.
+         */
+        tightness: number;
+        /**
+         * Concise one-line interpretation naming the participating planets and theme. Localized to the requested language via the lang query parameter (defaults to English).
+         */
+        interpretation: string;
+        /**
+         * Stable template identifier used to render the interpretation. Useful for clients that wish to swap in a custom narrative template while preserving the structured variables.
+         */
+        interpretationKey: string;
+        /**
+         * Variables that were interpolated into the interpretation template. Names already resolved to the requested language where appropriate.
+         */
+        interpretationVars: {
+            [key: string]: string;
+        };
+    }>;
     /**
      * Aspect summary with counts by nature and type.
      */
@@ -494,6 +634,100 @@ export type AspectsRequest = {
     aspectTypes?: Array<string>;
 };
 
+export type AspectPatternsResponse = {
+    /**
+     * All aspect patterns detected in the chart, in detection order: Grand Cross first, then Kite, Grand Trine, T-Square, Yod, Mystic Rectangle, Stellium. Patterns absorbed by a higher-priority detection (T-Squares inside a Grand Cross, Grand Trines absorbed by a Kite) are not reported separately.
+     */
+    patterns: Array<{
+        /**
+         * Pattern kind identifier. GRAND_TRINE (3 trines, harmonious flow), KITE (Grand Trine with a focal outlet planet), T_SQUARE (opposition with squared apex, growth engine), GRAND_CROSS (4 planets in 2 oppositions and 4 squares, peak tension), YOD (Finger of Fate, fated adjustment), MYSTIC_RECTANGLE (oppositions softened by trines and sextiles), STELLIUM (3+ planets clustered in a sign or 10-degree arc).
+         */
+        kind: 'GRAND_TRINE' | 'KITE' | 'T_SQUARE' | 'GRAND_CROSS' | 'YOD' | 'MYSTIC_RECTANGLE' | 'STELLIUM';
+        /**
+         * Human-readable name of the configuration as used in astrological literature.
+         */
+        name: string;
+        /**
+         * Participating bodies in canonical order. For Kite, T-Square, and Yod the apex planet appears first.
+         */
+        planets: Array<string>;
+        /**
+         * Focal planet for Kite, T-Square, and Yod patterns. Receives the released energy of the configuration and is the recommended integration point.
+         */
+        apex?: string;
+        /**
+         * Dominant element when the pattern is element-coherent (Grand Trine, Kite). Reported lowercase. Absent for patterns whose meaning does not pivot on element.
+         */
+        element?: 'fire' | 'earth' | 'air' | 'water';
+        /**
+         * Dominant modality for tension-based patterns (T-Square, Grand Cross). Cardinal initiates, Fixed sustains, Mutable adapts.
+         */
+        modality?: 'cardinal' | 'fixed' | 'mutable';
+        /**
+         * True if the pattern is out-of-sign (one or more planets in a neighboring element or modality). Dissociate patterns are still valid but operate with weakened thematic coherence.
+         */
+        dissociate?: boolean;
+        /**
+         * Tightness score (0-100) derived from the average orb tightness across all defining aspects. Higher means closer to exact and stronger thematic expression.
+         */
+        tightness: number;
+        /**
+         * Concise one-line interpretation naming the participating planets and theme. Localized to the requested language via the lang query parameter (defaults to English).
+         */
+        interpretation: string;
+        /**
+         * Stable template identifier used to render the interpretation. Useful for clients that wish to swap in a custom narrative template while preserving the structured variables.
+         */
+        interpretationKey: string;
+        /**
+         * Variables that were interpolated into the interpretation template. Names already resolved to the requested language where appropriate.
+         */
+        interpretationVars: {
+            [key: string]: string;
+        };
+    }>;
+    /**
+     * Total number of detected aspect patterns in this chart.
+     */
+    total: number;
+    /**
+     * Echo of the options used for this detection run. Useful for reproducibility and for downstream UI display.
+     */
+    options: {
+        /**
+         * Whether the strict (Pontopia-style) orb budget was used. False uses industry-standard orbs (8 for major aspects, 9 for square, 6 for sextile, 3 for quincunx).
+         */
+        strictOrbs: boolean;
+        /**
+         * Optional bodies included beyond the default Sun-Pluto set. Empty means classical 10-planet detection only.
+         */
+        include: Array<'chiron' | 'northNode'>;
+    };
+};
+
+export type AspectPatternsRequest = {
+    /**
+     * Birth date in YYYY-MM-DD format. Determines planetary positions for the specific calendar day.
+     */
+    date: string;
+    /**
+     * Birth time in 24-hour HH:MM:SS format. Determines the Ascendant (rising sign) and house cusps. Use 12:00:00 if unknown.
+     */
+    time: string;
+    /**
+     * Birth location latitude in decimal degrees (-90 to 90). Positive = North, negative = South.
+     */
+    latitude: number;
+    /**
+     * Birth location longitude in decimal degrees (-180 to 180). Positive = East, negative = West.
+     */
+    longitude: number;
+    /**
+     * Timezone: decimal hours from UTC (e.g. -5 for EST, 5.5 for IST) OR IANA name (e.g. "America/New_York", "Asia/Kolkata"). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly.
+     */
+    timezone: number | string;
+};
+
 export type TransitsResponse = {
     /**
      * Date of the transit calculation (YYYY-MM-DD).
@@ -684,13 +918,58 @@ export type BirthChartResponse = {
                  * Nakshatra index (1-27) in the zodiac sequence starting from Ashwini.
                  */
                 key: number;
+                /**
+                 * Vimshottari ruling planet of this nakshatra. One of the nine grahas (Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury). Drives the dasha sequence and the nakshatra qualities.
+                 */
+                lord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
             };
             /**
              * True if planet is in retrograde motion (appears to move backward). Retrograde planets have altered significations.
              */
             isRetrograde: boolean;
+            /**
+             * Bhava (house) number 1-12, counted whole-sign from the Lagna (house 1 is the Lagna rashi). Present on the D1 birth chart; divisional charts (navamsa, varga) omit it.
+             */
+            house?: number;
+            /**
+             * 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.
+             */
+            awastha?: 'Bala' | 'Kumara' | 'Yuva' | 'Vriddha' | 'Mrita';
         }>;
     };
+    /**
+     * Twelve classical yogas detected against this chart: Gajakesari (three-rule parashara definition), Sunapha, Anapha, Dhurdhura, Kemadruma, Chandra Mangala, Budha-Aditya, and the five Pancha Mahapurusha (Ruchaka, Bhadra, Hamsa, Malavya, Sasa). Each entry carries an `id` (matches `GET /yoga/{id}` for full glossary lookup), a `present` boolean, and classical-text `evidence` for the rule that triggered or failed.
+     */
+    yogas?: Array<{
+        /**
+         * Glossary id (lowercase, kebab-case) matching an entry in the 300-entry planetary-yoga catalog. Use with GET /yoga/{id} to retrieve the full glossary text.
+         */
+        id: string;
+        /**
+         * Classical Sanskrit name of the yoga as referenced in BPHS (Brihat Parashara Hora Shastra), Phaladeepika, and B.V. Raman *Three Hundred Important Combinations*.
+         */
+        name: string;
+        /**
+         * Brief classical formation rule. Identifies the planetary placement, lordship, dignity, or aspect pattern required for the yoga to form.
+         */
+        description: string;
+        /**
+         * Classical phala (life-effect) description of the yoga when present, sourced from the parashari and phaladeepika tradition.
+         */
+        result: string;
+        /**
+         * Overall nature. Auspicious yogas (Pancha Mahapurusha, Gajakesari) bestow benefits; inauspicious yogas (Kemadruma) indicate challenges; Both denotes context-dependent effects.
+         */
+        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.
+         */
+        present: boolean;
+        /**
+         * Human-readable rationale naming the specific rule that triggered or failed the detection, including planetary positions, dignity, kendrādhipati status, lordship, or malefic drishti.
+         */
+        evidence?: string;
+    }>;
     /**
      * Quick lookup of all planet positions keyed by planet name. Contains Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu, and Lagna (Ascendant).
      */
@@ -724,11 +1003,23 @@ export type BirthChartResponse = {
                  * Nakshatra sequence number (1-27) in zodiac order starting from Ashwini. Used for Tara Bala compatibility and dasha calculations.
                  */
                 key: number;
+                /**
+                 * Vimshottari ruling planet of this nakshatra. One of the nine grahas (Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury). Drives the dasha sequence and the nakshatra qualities.
+                 */
+                lord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
             };
             /**
              * True if the planet is in retrograde motion (appears to move backward through the zodiac). Retrograde planets carry intensified or internalized significations in Vedic interpretation.
              */
             isRetrograde: boolean;
+            /**
+             * 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;
+            /**
+             * 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.
+             */
+            awastha?: 'Bala' | 'Kumara' | 'Yuva' | 'Vriddha' | 'Mrita';
         };
     };
 };
@@ -794,13 +1085,72 @@ export type NavamsaResponse = {
                      * Nakshatra sequence number (1-27) in zodiac order starting from Ashwini. Used for Tara Bala compatibility and dasha calculations.
                      */
                     key: number;
+                    /**
+                     * Vimshottari ruling planet of this nakshatra. One of the nine grahas (Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury). Carried over from the D1 nakshatra.
+                     */
+                    lord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
                 };
                 /**
                  * True if the planet is in retrograde motion (appears to move backward through the zodiac). Retrograde planets carry intensified or internalized significations in Vedic interpretation.
                  */
                 isRetrograde: boolean;
+                /**
+                 * Bhava (house) number 1-12 in the Navamsa chart, counted whole-sign from the D9 Lagna. This is the Navamsa-specific house and differs from the D1 birth-chart house.
+                 */
+                house?: number;
             };
         };
+        /**
+         * One of the 12 navamsa rashi-house buckets (aries shown; taurus through pisces follow the identical shape). Each lists the planets placed in that sign.
+         */
+        aries: {
+            /**
+             * Zodiac sign name in lowercase.
+             */
+            rashi: string;
+            /**
+             * Planets placed in this navamsa sign.
+             */
+            signs: Array<{
+                /**
+                 * Planet (graha) placed in this navamsa sign.
+                 */
+                graha: string;
+                /**
+                 * Original sidereal longitude in degrees (0-360), same as the D1 birth chart. Preserved for cross-chart reference.
+                 */
+                longitude: number;
+                /**
+                 * Nakshatra (lunar mansion) data for this planet, carried over from the D1 chart.
+                 */
+                nakshatra: {
+                    /**
+                     * Nakshatra (lunar mansion) the planet occupies.
+                     */
+                    name: string;
+                    /**
+                     * Nakshatra pada (quarter, 1-4).
+                     */
+                    pada: number;
+                    /**
+                     * Nakshatra index in the zodiac sequence starting from Ashwini.
+                     */
+                    key: number;
+                    /**
+                     * Vimshottari ruling planet of this nakshatra.
+                     */
+                    lord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
+                };
+                /**
+                 * True if the planet is in retrograde motion.
+                 */
+                isRetrograde: boolean;
+                /**
+                 * Bhava (house) number 1-12 in the Navamsa chart, counted whole-sign from the D9 Lagna.
+                 */
+                house?: number;
+            }>;
+        };
         [key: string]: unknown;
     };
     /**
@@ -899,13 +1249,72 @@ export type DivisionalChartResponse = {
                      * Nakshatra sequence number (1-27) in zodiac order starting from Ashwini. Used for Tara Bala compatibility and dasha calculations.
                      */
                     key: number;
+                    /**
+                     * Vimshottari ruling planet of this nakshatra. One of the nine grahas (Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury). Carried over from the D1 nakshatra.
+                     */
+                    lord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
                 };
                 /**
                  * True if the planet is in retrograde motion (appears to move backward through the zodiac). Retrograde planets carry intensified or internalized significations in Vedic interpretation.
                  */
                 isRetrograde: boolean;
+                /**
+                 * Bhava (house) number 1-12 in this divisional chart, counted whole-sign from the divisional Lagna. Specific to this varga and differs from the D1 birth-chart house.
+                 */
+                house?: number;
             };
         };
+        /**
+         * One of the 12 divisional rashi-house buckets (aries shown; taurus through pisces follow the identical shape). Each lists the planets placed in that sign.
+         */
+        aries: {
+            /**
+             * Zodiac sign name in lowercase.
+             */
+            rashi: string;
+            /**
+             * Planets placed in this divisional sign.
+             */
+            signs: Array<{
+                /**
+                 * Planet (graha) placed in this divisional sign.
+                 */
+                graha: string;
+                /**
+                 * Original sidereal longitude in degrees (0-360), same as the D1 birth chart. Preserved for cross-chart reference.
+                 */
+                longitude: number;
+                /**
+                 * Nakshatra (lunar mansion) data for this planet, carried over from the D1 chart.
+                 */
+                nakshatra: {
+                    /**
+                     * Nakshatra (lunar mansion) the planet occupies.
+                     */
+                    name: string;
+                    /**
+                     * Nakshatra pada (quarter, 1-4).
+                     */
+                    pada: number;
+                    /**
+                     * Nakshatra index in the zodiac sequence starting from Ashwini.
+                     */
+                    key: number;
+                    /**
+                     * Vimshottari ruling planet of this nakshatra.
+                     */
+                    lord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
+                };
+                /**
+                 * True if the planet is in retrograde motion.
+                 */
+                isRetrograde: boolean;
+                /**
+                 * Bhava (house) number 1-12 in this divisional chart, counted whole-sign from the divisional Lagna.
+                 */
+                house?: number;
+            }>;
+        };
         [key: string]: unknown;
     };
     /**
@@ -1372,6 +1781,79 @@ export type SadhesatiRequest = {
     timezone?: number | string;
 };
 
+export type YogaDetectResponse = {
+    /**
+     * Array of 12 detected yogas. Every entry carries a present boolean; filter on present === true for active yogas. Evidence text names the rule that triggered or failed.
+     */
+    yogas: Array<{
+        /**
+         * Glossary id (lowercase, kebab-case) matching an entry in the 300-entry planetary-yoga catalog. Use with GET /yoga/{id} to retrieve the full glossary text.
+         */
+        id: string;
+        /**
+         * Classical Sanskrit name of the yoga as referenced in BPHS (Brihat Parashara Hora Shastra), Phaladeepika, and B.V. Raman *Three Hundred Important Combinations*.
+         */
+        name: string;
+        /**
+         * Brief classical formation rule. Identifies the planetary placement, lordship, dignity, or aspect pattern required for the yoga to form.
+         */
+        description: string;
+        /**
+         * Classical phala (life-effect) description of the yoga when present, sourced from the parashari and phaladeepika tradition.
+         */
+        result: string;
+        /**
+         * Overall nature. Auspicious yogas (Pancha Mahapurusha, Gajakesari) bestow benefits; inauspicious yogas (Kemadruma) indicate challenges; Both denotes context-dependent effects.
+         */
+        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.
+         */
+        present: boolean;
+        /**
+         * Human-readable rationale naming the specific rule that triggered or failed the detection, including planetary positions, dignity, kendrādhipati status, lordship, or malefic drishti.
+         */
+        evidence?: string;
+    }>;
+    /**
+     * Count of yogas where present === true in this chart. Range 0-12.
+     */
+    total: number;
+    /**
+     * 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: {
+        date: string;
+        time: string;
+        latitude: number;
+        longitude: number;
+        timezone: number;
+    };
+};
+
+export type YogaDetectRequest = {
+    /**
+     * 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 - changes every ~2 hours. 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: decimal hours from UTC (e.g. 5.5 for IST, -5 for EST) OR IANA name (e.g. "Asia/Kolkata", "America/New_York"). 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 (IST).
+     */
+    timezone?: number | string;
+};
+
 export type KpAyanamsaResponse = {
     /**
      * Date for which ayanamsa was calculated
@@ -5325,20 +5807,145 @@ export type PostAstrologyHousesData = {
         /**
          * Birth location latitude in decimal degrees. Location determines the local horizon and meridian, which are fundamental to house division. Higher latitudes cause more distortion in time-based systems like Placidus.
          */
-        latitude: number;
+        latitude: number;
+        /**
+         * Birth location longitude in decimal degrees. Affects local time and horizon calculations for house cusps.
+         */
+        longitude: number;
+        /**
+         * Decimal hours from UTC (e.g. -5 for EST, 5.5 for IST, 9 for JST) OR IANA name (e.g. "America/New_York"). IANA resolved to the DST-correct offset for the chart date.
+         */
+        timezone: number | string;
+        /**
+         * House system for dividing ecliptic into 12 houses. Placidus (most popular) uses time, Whole Sign (ancient) uses signs, Equal divides from Ascendant. Use "all" to compare all 4 systems side-by-side for educational purposes.
+         */
+        houseSystem?: 'placidus' | 'whole-sign' | 'equal' | 'koch' | 'all';
+    };
+    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: '/astrology/houses';
+};
+
+export type PostAstrologyHousesErrors = {
+    /**
+     * Validation error. `issues[]` lists every failed field.
+     */
+    400: {
+        /**
+         * First issue summary.
+         */
+        error: string;
+        code: 'validation_error';
+        /**
+         * Every validation failure. Use this to rebuild a valid request.
+         */
+        issues: Array<{
+            /**
+             * Dot-separated field path, or "(root)" for top-level.
+             */
+            path: string;
+            message: string;
+            /**
+             * Zod issue code (invalid_type, too_small, too_big, invalid_string, ...).
+             */
+            code?: string;
+            /**
+             * Expected type for invalid_type.
+             */
+            expected?: string;
+            /**
+             * Minimum bound for too_small issues.
+             */
+            minimum?: number | string;
+            /**
+             * Maximum bound for too_big issues.
+             */
+            maximum?: number | string;
+            inclusive?: boolean;
+            /**
+             * Format name for string issues (regex, email, url, uuid).
+             */
+            format?: string;
+            /**
+             * Regex pattern when format is regex.
+             */
+            pattern?: string;
+        }>;
+    };
+    /**
+     * Invalid or missing API key
+     */
+    401: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
+     */
+    405: {
+        error: string;
+        code: 'method_not_allowed';
+        /**
+         * Allowed HTTP methods for this path. Mirrors the Allow response header.
+         */
+        allow: Array<string>;
+        /**
+         * Link to the product page for this domain.
+         */
+        docs?: string;
+    };
+    /**
+     * Monthly rate limit exceeded
+     */
+    429: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
         /**
-         * Birth location longitude in decimal degrees. Affects local time and horizon calculations for house cusps.
+         * Machine-readable error code. Stable identifier.
          */
-        longitude: number;
+        code: string;
+    };
+    /**
+     * Internal server error
+     */
+    500: {
         /**
-         * Decimal hours from UTC (e.g. -5 for EST, 5.5 for IST, 9 for JST) OR IANA name (e.g. "America/New_York"). IANA resolved to the DST-correct offset for the chart date.
+         * Human-readable error message. May change wording.
          */
-        timezone: number | string;
+        error: string;
         /**
-         * House system for dividing ecliptic into 12 houses. Placidus (most popular) uses time, Whole Sign (ancient) uses signs, Equal divides from Ascendant. Use "all" to compare all 4 systems side-by-side for educational purposes.
+         * Machine-readable error code. Stable identifier.
          */
-        houseSystem?: 'placidus' | 'whole-sign' | 'equal' | 'koch' | 'all';
+        code: string;
     };
+};
+
+export type PostAstrologyHousesError = PostAstrologyHousesErrors[keyof PostAstrologyHousesErrors];
+
+export type PostAstrologyHousesResponses = {
+    /**
+     * House cusps calculated successfully
+     */
+    200: HousesResponse;
+};
+
+export type PostAstrologyHousesResponse = PostAstrologyHousesResponses[keyof PostAstrologyHousesResponses];
+
+export type PostAstrologyAspectsData = {
+    body?: AspectsRequest;
     path?: never;
     query?: {
         /**
@@ -5346,10 +5953,10 @@ export type PostAstrologyHousesData = {
          */
         lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
     };
-    url: '/astrology/houses';
+    url: '/astrology/aspects';
 };
 
-export type PostAstrologyHousesErrors = {
+export type PostAstrologyAspectsErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -5451,30 +6058,38 @@ export type PostAstrologyHousesErrors = {
     };
 };
 
-export type PostAstrologyHousesError = PostAstrologyHousesErrors[keyof PostAstrologyHousesErrors];
+export type PostAstrologyAspectsError = PostAstrologyAspectsErrors[keyof PostAstrologyAspectsErrors];
 
-export type PostAstrologyHousesResponses = {
+export type PostAstrologyAspectsResponses = {
     /**
-     * House cusps calculated successfully
+     * Aspects calculated successfully
      */
-    200: HousesResponse;
+    200: AspectsResponse;
 };
 
-export type PostAstrologyHousesResponse = PostAstrologyHousesResponses[keyof PostAstrologyHousesResponses];
+export type PostAstrologyAspectsResponse = PostAstrologyAspectsResponses[keyof PostAstrologyAspectsResponses];
 
-export type PostAstrologyAspectsData = {
-    body?: AspectsRequest;
+export type PostAstrologyAspectPatternsData = {
+    body?: AspectPatternsRequest;
     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';
+        /**
+         * Use tighter orbs (Pontopia "optimal" recommendations). Truthy values (true, 1, yes, on; case-insensitive) narrow trine to 5, square to 5, sextile to 4, quincunx to 2. Defaults to false (industry-standard orbs).
+         */
+        strictOrbs?: string;
+        /**
+         * Comma-separated list of optional bodies to include beyond the classical 10 planets. Valid tokens (case-insensitive): chiron, northNode (also accepts north_node, north-node, northnode). Empty by default.
+         */
+        include?: string;
     };
-    url: '/astrology/aspects';
+    url: '/astrology/aspect-patterns';
 };
 
-export type PostAstrologyAspectsErrors = {
+export type PostAstrologyAspectPatternsErrors = {
     /**
      * Validation error. `issues[]` lists every failed field.
      */
@@ -5576,16 +6191,16 @@ export type PostAstrologyAspectsErrors = {
     };
 };
 
-export type PostAstrologyAspectsError = PostAstrologyAspectsErrors[keyof PostAstrologyAspectsErrors];
+export type PostAstrologyAspectPatternsError = PostAstrologyAspectPatternsErrors[keyof PostAstrologyAspectPatternsErrors];
 
-export type PostAstrologyAspectsResponses = {
+export type PostAstrologyAspectPatternsResponses = {
     /**
-     * Aspects calculated successfully
+     * Aspect patterns detected successfully
      */
-    200: AspectsResponse;
+    200: AspectPatternsResponse;
 };
 
-export type PostAstrologyAspectsResponse = PostAstrologyAspectsResponses[keyof PostAstrologyAspectsResponses];
+export type PostAstrologyAspectPatternsResponse = PostAstrologyAspectPatternsResponses[keyof PostAstrologyAspectPatternsResponses];
 
 export type PostAstrologyTransitsData = {
     body?: TransitsRequest;
@@ -6392,6 +7007,44 @@ export type PostAstrologySolarReturnResponses = {
                  */
                 interpretation: 'harmonious' | 'challenging' | 'neutral';
             }>;
+            /**
+             * Part of Fortune (Lot of Fortune). A point derived from the Ascendant and the two luminaries that marks an area of ease, vitality, and material wellbeing in the chart.
+             */
+            partOfFortune: {
+                /**
+                 * Zodiac sign holding the Part of Fortune.
+                 */
+                sign: string;
+                /**
+                 * Degree within the Part of Fortune sign (0-29.999).
+                 */
+                degree: number;
+                /**
+                 * Absolute ecliptic longitude of the Part of Fortune (0-360).
+                 */
+                longitude: number;
+                /**
+                 * Chart sect used for the calculation. Day (diurnal) when the Sun is above the horizon, night (nocturnal) when below. Day charts use Ascendant plus Moon minus Sun, night charts use Ascendant plus Sun minus Moon.
+                 */
+                sect: 'day' | 'night';
+            };
+            /**
+             * Vertex. The western intersection of the prime vertical with the ecliptic, often read as a point of fated encounters and turning-point relationships. The opposite point is the Anti-Vertex.
+             */
+            vertex: {
+                /**
+                 * Zodiac sign holding the Vertex.
+                 */
+                sign: string;
+                /**
+                 * Degree within the Vertex sign (0-29.999).
+                 */
+                degree: number;
+                /**
+                 * Absolute ecliptic longitude of the Vertex (0-360).
+                 */
+                longitude: number;
+            };
         };
         /**
          * Original natal Sun position that the transiting Sun returns to. This conjunction defines the solar return moment.
@@ -6735,6 +7388,44 @@ export type PostAstrologyLunarReturnResponses = {
                  */
                 interpretation: 'harmonious' | 'challenging' | 'neutral';
             }>;
+            /**
+             * Part of Fortune (Lot of Fortune). A point derived from the Ascendant and the two luminaries that marks an area of ease, vitality, and material wellbeing in the chart.
+             */
+            partOfFortune: {
+                /**
+                 * Zodiac sign holding the Part of Fortune.
+                 */
+                sign: string;
+                /**
+                 * Degree within the Part of Fortune sign (0-29.999).
+                 */
+                degree: number;
+                /**
+                 * Absolute ecliptic longitude of the Part of Fortune (0-360).
+                 */
+                longitude: number;
+                /**
+                 * Chart sect used for the calculation. Day (diurnal) when the Sun is above the horizon, night (nocturnal) when below. Day charts use Ascendant plus Moon minus Sun, night charts use Ascendant plus Sun minus Moon.
+                 */
+                sect: 'day' | 'night';
+            };
+            /**
+             * Vertex. The western intersection of the prime vertical with the ecliptic, often read as a point of fated encounters and turning-point relationships. The opposite point is the Anti-Vertex.
+             */
+            vertex: {
+                /**
+                 * Zodiac sign holding the Vertex.
+                 */
+                sign: string;
+                /**
+                 * Degree within the Vertex sign (0-29.999).
+                 */
+                degree: number;
+                /**
+                 * Absolute ecliptic longitude of the Vertex (0-360).
+                 */
+                longitude: number;
+            };
         };
         /**
          * Original natal Moon position that the transiting Moon returns to. This conjunction defines the lunar return moment.
@@ -8587,6 +9278,44 @@ export type PostAstrologyPlanetaryReturnsResponses = {
                  */
                 interpretation: 'harmonious' | 'challenging' | 'neutral';
             }>;
+            /**
+             * Part of Fortune (Lot of Fortune). A point derived from the Ascendant and the two luminaries that marks an area of ease, vitality, and material wellbeing in the chart.
+             */
+            partOfFortune: {
+                /**
+                 * Zodiac sign holding the Part of Fortune.
+                 */
+                sign: string;
+                /**
+                 * Degree within the Part of Fortune sign (0-29.999).
+                 */
+                degree: number;
+                /**
+                 * Absolute ecliptic longitude of the Part of Fortune (0-360).
+                 */
+                longitude: number;
+                /**
+                 * Chart sect used for the calculation. Day (diurnal) when the Sun is above the horizon, night (nocturnal) when below. Day charts use Ascendant plus Moon minus Sun, night charts use Ascendant plus Sun minus Moon.
+                 */
+                sect: 'day' | 'night';
+            };
+            /**
+             * Vertex. The western intersection of the prime vertical with the ecliptic, often read as a point of fated encounters and turning-point relationships. The opposite point is the Anti-Vertex.
+             */
+            vertex: {
+                /**
+                 * Zodiac sign holding the Vertex.
+                 */
+                sign: string;
+                /**
+                 * Degree within the Vertex sign (0-29.999).
+                 */
+                degree: number;
+                /**
+                 * Absolute ecliptic longitude of the Vertex (0-360).
+                 */
+                longitude: number;
+            };
         };
         /**
          * Original natal planet position that defines the return. The transiting planet conjuncts this longitude to trigger the return.
@@ -12117,6 +12846,131 @@ export type GetVedicAstrologyYogaByIdResponses = {
 
 export type GetVedicAstrologyYogaByIdResponse = GetVedicAstrologyYogaByIdResponses[keyof GetVedicAstrologyYogaByIdResponses];
 
+export type PostVedicAstrologyYogaDetectData = {
+    body?: YogaDetectRequest;
+    path?: never;
+    query?: {
+        /**
+         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
+         */
+        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
+    };
+    url: '/vedic-astrology/yoga/detect';
+};
+
+export type PostVedicAstrologyYogaDetectErrors = {
+    /**
+     * Validation error. `issues[]` lists every failed field.
+     */
+    400: {
+        /**
+         * First issue summary.
+         */
+        error: string;
+        code: 'validation_error';
+        /**
+         * Every validation failure. Use this to rebuild a valid request.
+         */
+        issues: Array<{
+            /**
+             * Dot-separated field path, or "(root)" for top-level.
+             */
+            path: string;
+            message: string;
+            /**
+             * Zod issue code (invalid_type, too_small, too_big, invalid_string, ...).
+             */
+            code?: string;
+            /**
+             * Expected type for invalid_type.
+             */
+            expected?: string;
+            /**
+             * Minimum bound for too_small issues.
+             */
+            minimum?: number | string;
+            /**
+             * Maximum bound for too_big issues.
+             */
+            maximum?: number | string;
+            inclusive?: boolean;
+            /**
+             * Format name for string issues (regex, email, url, uuid).
+             */
+            format?: string;
+            /**
+             * Regex pattern when format is regex.
+             */
+            pattern?: string;
+        }>;
+    };
+    /**
+     * Invalid or missing API key
+     */
+    401: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
+     */
+    405: {
+        error: string;
+        code: 'method_not_allowed';
+        /**
+         * Allowed HTTP methods for this path. Mirrors the Allow response header.
+         */
+        allow: Array<string>;
+        /**
+         * Link to the product page for this domain.
+         */
+        docs?: string;
+    };
+    /**
+     * Monthly rate limit exceeded
+     */
+    429: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Internal server error
+     */
+    500: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+};
+
+export type PostVedicAstrologyYogaDetectError = PostVedicAstrologyYogaDetectErrors[keyof PostVedicAstrologyYogaDetectErrors];
+
+export type PostVedicAstrologyYogaDetectResponses = {
+    /**
+     * List of 12 classical yogas with present/absent verdicts and classical-text evidence.
+     */
+    200: YogaDetectResponse;
+};
+
+export type PostVedicAstrologyYogaDetectResponse = PostVedicAstrologyYogaDetectResponses[keyof PostVedicAstrologyYogaDetectResponses];
+
 export type GetVedicAstrologyKpAyanamsaData = {
     body?: never;
     path?: never;