@roxyapi/sdk 1.2.50 → 1.2.52

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/src/types.gen.ts CHANGED
@@ -4436,19 +4436,19 @@ export type KpRulingPlanetsIntervalResponse = {
4436
4436
  */
4437
4437
  moonSignLordSignifies: {
4438
4438
  /**
4439
- * Level 1 (strongest signification). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes L1 houses from agent planets (conjoined, aspecting, sign lord).
4439
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
4440
4440
  */
4441
4441
  L1: Array<number>;
4442
4442
  /**
4443
- * Level 2. The house this planet physically occupies in the chart. For Rahu and Ketu, also includes houses occupied by agent planets (conjoined, aspecting, sign lord).
4443
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
4444
4444
  */
4445
4445
  L2: Array<number>;
4446
4446
  /**
4447
- * Level 3. Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes L3 houses from agent planets.
4447
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
4448
4448
  */
4449
4449
  L3: Array<number>;
4450
4450
  /**
4451
- * Level 4 (weakest signification). Houses this planet rules by zodiac sign ownership. For Sun through Saturn, can be up to 2 houses. For Rahu and Ketu, includes houses owned by agent planets (conjoined, aspecting, sign lord).
4451
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
4452
4452
  */
4453
4453
  L4: Array<number>;
4454
4454
  };
@@ -4457,19 +4457,19 @@ export type KpRulingPlanetsIntervalResponse = {
4457
4457
  */
4458
4458
  moonStarLordSignifies: {
4459
4459
  /**
4460
- * Level 1 (strongest signification). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes L1 houses from agent planets (conjoined, aspecting, sign lord).
4460
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
4461
4461
  */
4462
4462
  L1: Array<number>;
4463
4463
  /**
4464
- * Level 2. The house this planet physically occupies in the chart. For Rahu and Ketu, also includes houses occupied by agent planets (conjoined, aspecting, sign lord).
4464
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
4465
4465
  */
4466
4466
  L2: Array<number>;
4467
4467
  /**
4468
- * Level 3. Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes L3 houses from agent planets.
4468
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
4469
4469
  */
4470
4470
  L3: Array<number>;
4471
4471
  /**
4472
- * Level 4 (weakest signification). Houses this planet rules by zodiac sign ownership. For Sun through Saturn, can be up to 2 houses. For Rahu and Ketu, includes houses owned by agent planets (conjoined, aspecting, sign lord).
4472
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
4473
4473
  */
4474
4474
  L4: Array<number>;
4475
4475
  };
@@ -4478,19 +4478,19 @@ export type KpRulingPlanetsIntervalResponse = {
4478
4478
  */
4479
4479
  moonSublordSignifies: {
4480
4480
  /**
4481
- * Level 1 (strongest signification). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes L1 houses from agent planets (conjoined, aspecting, sign lord).
4481
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
4482
4482
  */
4483
4483
  L1: Array<number>;
4484
4484
  /**
4485
- * Level 2. The house this planet physically occupies in the chart. For Rahu and Ketu, also includes houses occupied by agent planets (conjoined, aspecting, sign lord).
4485
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
4486
4486
  */
4487
4487
  L2: Array<number>;
4488
4488
  /**
4489
- * Level 3. Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes L3 houses from agent planets.
4489
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
4490
4490
  */
4491
4491
  L3: Array<number>;
4492
4492
  /**
4493
- * Level 4 (weakest signification). Houses this planet rules by zodiac sign ownership. For Sun through Saturn, can be up to 2 houses. For Rahu and Ketu, includes houses owned by agent planets (conjoined, aspecting, sign lord).
4493
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
4494
4494
  */
4495
4495
  L4: Array<number>;
4496
4496
  };
@@ -4499,19 +4499,19 @@ export type KpRulingPlanetsIntervalResponse = {
4499
4499
  */
4500
4500
  moonSignifies: {
4501
4501
  /**
4502
- * Level 1 (strongest signification). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes L1 houses from agent planets (conjoined, aspecting, sign lord).
4502
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
4503
4503
  */
4504
4504
  L1: Array<number>;
4505
4505
  /**
4506
- * Level 2. The house this planet physically occupies in the chart. For Rahu and Ketu, also includes houses occupied by agent planets (conjoined, aspecting, sign lord).
4506
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
4507
4507
  */
4508
4508
  L2: Array<number>;
4509
4509
  /**
4510
- * Level 3. Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes L3 houses from agent planets.
4510
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
4511
4511
  */
4512
4512
  L3: Array<number>;
4513
4513
  /**
4514
- * Level 4 (weakest signification). Houses this planet rules by zodiac sign ownership. For Sun through Saturn, can be up to 2 houses. For Rahu and Ketu, includes houses owned by agent planets (conjoined, aspecting, sign lord).
4514
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
4515
4515
  */
4516
4516
  L4: Array<number>;
4517
4517
  };
@@ -7303,6 +7303,10 @@ export type GetAstrologyMoonPhaseCalendarByYearByMonthResponses = {
7303
7303
  * Calendar month for this lunar calendar.
7304
7304
  */
7305
7305
  month: number;
7306
+ /**
7307
+ * Month name, localized to the requested language. Saves the caller a lookup table when labelling a calendar heading, since the numeric month alone cannot be rendered without one.
7308
+ */
7309
+ monthName: string;
7306
7310
  /**
7307
7311
  * Daily moon phase and illumination for every day of the month.
7308
7312
  */
@@ -7504,7 +7508,7 @@ export type PostAstrologySynastryResponses = {
7504
7508
  */
7505
7509
  200: {
7506
7510
  /**
7507
- * Person 1 chart highlights: Ascendant, Sun sign, and Moon sign.
7511
+ * Person 1 chart highlights: Ascendant, Sun sign, Moon sign, and plotting positions.
7508
7512
  */
7509
7513
  person1: {
7510
7514
  /**
@@ -7532,9 +7536,38 @@ export type PostAstrologySynastryResponses = {
7532
7536
  * Moon sign of this person. Emotional nature and inner needs.
7533
7537
  */
7534
7538
  moonSign: string;
7539
+ /**
7540
+ * Planet positions for person 1, enough to render this side of a dual wheel without a second request. Per-planet interpretations are not repeated here; call the natal chart endpoint for an individual reading.
7541
+ */
7542
+ planets: Array<{
7543
+ /**
7544
+ * Planet or point name. Matches the names used in interAspects.
7545
+ */
7546
+ name: string;
7547
+ /**
7548
+ * Ecliptic longitude in degrees (0-360) measured from 0 Aries. This is the value a wheel plots.
7549
+ */
7550
+ longitude: number;
7551
+ /**
7552
+ * Zodiac sign containing the planet.
7553
+ */
7554
+ sign: string;
7555
+ /**
7556
+ * Degree within the sign (0-29.999).
7557
+ */
7558
+ degree: number;
7559
+ /**
7560
+ * House this planet occupies in the person 1 chart (1-12).
7561
+ */
7562
+ house: number;
7563
+ /**
7564
+ * True when the planet is retrograde at this moment.
7565
+ */
7566
+ isRetrograde: boolean;
7567
+ }>;
7535
7568
  };
7536
7569
  /**
7537
- * Person 2 chart highlights: Ascendant, Sun sign, and Moon sign.
7570
+ * Person 2 chart highlights: Ascendant, Sun sign, Moon sign, and plotting positions.
7538
7571
  */
7539
7572
  person2: {
7540
7573
  /**
@@ -7542,7 +7575,7 @@ export type PostAstrologySynastryResponses = {
7542
7575
  */
7543
7576
  name?: string;
7544
7577
  /**
7545
- * Ascendant position for person 2.
7578
+ * Ascendant position for person 2. Determines first house cusp and outward personality.
7546
7579
  */
7547
7580
  ascendant: {
7548
7581
  /**
@@ -7555,13 +7588,42 @@ export type PostAstrologySynastryResponses = {
7555
7588
  degree: number;
7556
7589
  };
7557
7590
  /**
7558
- * Sun sign of this person.
7591
+ * Sun sign (zodiac sign) of this person. Core identity and ego expression.
7559
7592
  */
7560
7593
  sunSign: string;
7561
7594
  /**
7562
- * Moon sign of this person.
7595
+ * Moon sign of this person. Emotional nature and inner needs.
7563
7596
  */
7564
7597
  moonSign: string;
7598
+ /**
7599
+ * Planet positions for person 2, enough to render this side of a dual wheel without a second request. Per-planet interpretations are not repeated here; call the natal chart endpoint for an individual reading.
7600
+ */
7601
+ planets: Array<{
7602
+ /**
7603
+ * Planet or point name. Matches the names used in interAspects.
7604
+ */
7605
+ name: string;
7606
+ /**
7607
+ * Ecliptic longitude in degrees (0-360) measured from 0 Aries. This is the value a wheel plots.
7608
+ */
7609
+ longitude: number;
7610
+ /**
7611
+ * Zodiac sign containing the planet.
7612
+ */
7613
+ sign: string;
7614
+ /**
7615
+ * Degree within the sign (0-29.999).
7616
+ */
7617
+ degree: number;
7618
+ /**
7619
+ * House this planet occupies in the person 2 chart (1-12).
7620
+ */
7621
+ house: number;
7622
+ /**
7623
+ * True when the planet is retrograde at this moment.
7624
+ */
7625
+ isRetrograde: boolean;
7626
+ }>;
7565
7627
  };
7566
7628
  /**
7567
7629
  * Overall compatibility score (0-100). Calculated from the balance of harmonious vs challenging inter-chart aspects weighted by planet importance.
@@ -10805,6 +10867,10 @@ export type GetAstrologyHoroscopeBySignMonthlyResponses = {
10805
10867
  * Monthly financial outlook and guidance.
10806
10868
  */
10807
10869
  finance: string;
10870
+ /**
10871
+ * Actionable guidance for the month as a whole, derived from the Mercury house activation for this sign. Distinct from the per-week advice inside weekByWeek: this is the single takeaway for the month.
10872
+ */
10873
+ advice: string;
10808
10874
  /**
10809
10875
  * Week-by-week breakdown with sign-specific focus areas based on transit house positions.
10810
10876
  */
@@ -13393,6 +13459,14 @@ export type PostVedicAstrologyDashaCurrentData = {
13393
13459
  * 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. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
13394
13460
  */
13395
13461
  ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri';
13462
+ /**
13463
+ * Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above.
13464
+ */
13465
+ significators?: boolean;
13466
+ /**
13467
+ * Lunar node type for Rahu and Ketu, used ONLY when "significators" is true. Dasha dates themselves come from the Moon and never move with this field. "mean" uses the smooth mean node (traditional default). "true" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to "mean".
13468
+ */
13469
+ nodeType?: 'mean' | 'true';
13396
13470
  };
13397
13471
  path?: never;
13398
13472
  query?: {
@@ -13510,9 +13584,15 @@ export type PostVedicAstrologyDashaCurrentError = PostVedicAstrologyDashaCurrent
13510
13584
 
13511
13585
  export type PostVedicAstrologyDashaCurrentResponses = {
13512
13586
  /**
13513
- * Currently active Mahadasha, Antardasha, Pratyantardasha, and Sookshma dasha with start/end dates, remaining balance, Moon nakshatra, and Vedic interpretations for each period.
13587
+ * Currently active Mahadasha, Antardasha, Pratyantardasha, Sookshma and Prana dasha with start/end dates, remaining balance, Moon nakshatra, and Vedic interpretations for each period.
13514
13588
  */
13515
13589
  200: {
13590
+ /**
13591
+ * What each house MEANS, keyed by house number 1 to 12, in the requested language. Turns a house list into words without the client writing any interpretation copy: for a period signifying houses 2, 7 and 8, join houseThemes for those keys to render the "nature" line of a KP dasha table. Sent once per response rather than repeated on every period, so look the houses up from signifiedHouses or strongHouses. Localized by the lang query, like every other interpretation field.
13592
+ */
13593
+ houseThemes?: {
13594
+ [key: string]: Array<string>;
13595
+ };
13516
13596
  /**
13517
13597
  * Birth Moon nakshatra number (1-27). This nakshatra determines the starting dasha lord in the Vimshottari 120-year cycle.
13518
13598
  */
@@ -13565,6 +13645,69 @@ export type PostVedicAstrologyDashaCurrentResponses = {
13565
13645
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
13566
13646
  */
13567
13647
  interpretation?: string;
13648
+ /**
13649
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
13650
+ */
13651
+ significators?: {
13652
+ /**
13653
+ * House 1-12 this lord occupies in the Placidus birth chart. Its own Level 2 signification, repeated here because the occupied house is the first thing a KP reading looks at.
13654
+ */
13655
+ house: number;
13656
+ /**
13657
+ * Lord of the nakshatra this planet sits in, one of the 9 grahas. In KP the star lord outranks the planet itself: a period lord mainly delivers the houses its star lord occupies and owns, which is why those appear at L1 and L3 rather than the planet own house.
13658
+ */
13659
+ starLord: string;
13660
+ /**
13661
+ * KP sub lord of this planet, the 1 of 249 subdivision its longitude falls in, one of the 9 grahas. The star lord says WHAT results the period gives, the sub lord says WHETHER they materialize, so KP judgement checks both.
13662
+ */
13663
+ subLord?: string;
13664
+ /**
13665
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
13666
+ */
13667
+ signifies: {
13668
+ /**
13669
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
13670
+ */
13671
+ L1: Array<number>;
13672
+ /**
13673
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
13674
+ */
13675
+ L2: Array<number>;
13676
+ /**
13677
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
13678
+ */
13679
+ L3: Array<number>;
13680
+ /**
13681
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
13682
+ */
13683
+ L4: Array<number>;
13684
+ };
13685
+ /**
13686
+ * Every house this lord signifies, deduplicated and ordered strongest tier first. Where a house is reached at more than one level it is listed once, at its strongest. This is the flat "houses signified" column of a KP dasha table.
13687
+ */
13688
+ signifiedHouses: Array<number>;
13689
+ /**
13690
+ * Subset of signifiedHouses reached at grade A or B (levels L1 and L2). These are the houses a KP reading acts on for this period; the rest are supporting connections.
13691
+ */
13692
+ strongHouses: Array<number>;
13693
+ /**
13694
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
13695
+ */
13696
+ strength: {
13697
+ /**
13698
+ * Mean KP percentage weight across signifiedHouses, each house counted at its strongest level (A 100, B 75, C 50, D 25). A mean rather than a total, so signifying many houses weakly does not outrank signifying two houses at grade A.
13699
+ */
13700
+ score: number;
13701
+ /**
13702
+ * Band the score falls in, on the standard KP significator grading: A planets in the constellation of the occupant, B occupants, C planets in the constellation of the house owner, D the house owner. Band edges are the midpoints between the four weights.
13703
+ */
13704
+ grade: 'A' | 'B' | 'C' | 'D';
13705
+ /**
13706
+ * Plain-language form of grade: "very-strong" for A, "strong" for B, "moderate" for C, "weak" for D. Says how firmly this lord is connected to the houses it signifies, NOT whether those houses are favourable, which depends on the matter being judged.
13707
+ */
13708
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
13709
+ };
13710
+ };
13568
13711
  };
13569
13712
  /**
13570
13713
  * Antardasha (bhukti), sub-period within a Mahadasha. Each Mahadasha contains 9 Antardashas proportional to the Vimshottari years of each planet.
@@ -13594,6 +13737,69 @@ export type PostVedicAstrologyDashaCurrentResponses = {
13594
13737
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
13595
13738
  */
13596
13739
  interpretation?: string;
13740
+ /**
13741
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
13742
+ */
13743
+ significators?: {
13744
+ /**
13745
+ * House 1-12 this lord occupies in the Placidus birth chart. Its own Level 2 signification, repeated here because the occupied house is the first thing a KP reading looks at.
13746
+ */
13747
+ house: number;
13748
+ /**
13749
+ * Lord of the nakshatra this planet sits in, one of the 9 grahas. In KP the star lord outranks the planet itself: a period lord mainly delivers the houses its star lord occupies and owns, which is why those appear at L1 and L3 rather than the planet own house.
13750
+ */
13751
+ starLord: string;
13752
+ /**
13753
+ * KP sub lord of this planet, the 1 of 249 subdivision its longitude falls in, one of the 9 grahas. The star lord says WHAT results the period gives, the sub lord says WHETHER they materialize, so KP judgement checks both.
13754
+ */
13755
+ subLord?: string;
13756
+ /**
13757
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
13758
+ */
13759
+ signifies: {
13760
+ /**
13761
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
13762
+ */
13763
+ L1: Array<number>;
13764
+ /**
13765
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
13766
+ */
13767
+ L2: Array<number>;
13768
+ /**
13769
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
13770
+ */
13771
+ L3: Array<number>;
13772
+ /**
13773
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
13774
+ */
13775
+ L4: Array<number>;
13776
+ };
13777
+ /**
13778
+ * Every house this lord signifies, deduplicated and ordered strongest tier first. Where a house is reached at more than one level it is listed once, at its strongest. This is the flat "houses signified" column of a KP dasha table.
13779
+ */
13780
+ signifiedHouses: Array<number>;
13781
+ /**
13782
+ * Subset of signifiedHouses reached at grade A or B (levels L1 and L2). These are the houses a KP reading acts on for this period; the rest are supporting connections.
13783
+ */
13784
+ strongHouses: Array<number>;
13785
+ /**
13786
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
13787
+ */
13788
+ strength: {
13789
+ /**
13790
+ * Mean KP percentage weight across signifiedHouses, each house counted at its strongest level (A 100, B 75, C 50, D 25). A mean rather than a total, so signifying many houses weakly does not outrank signifying two houses at grade A.
13791
+ */
13792
+ score: number;
13793
+ /**
13794
+ * Band the score falls in, on the standard KP significator grading: A planets in the constellation of the occupant, B occupants, C planets in the constellation of the house owner, D the house owner. Band edges are the midpoints between the four weights.
13795
+ */
13796
+ grade: 'A' | 'B' | 'C' | 'D';
13797
+ /**
13798
+ * Plain-language form of grade: "very-strong" for A, "strong" for B, "moderate" for C, "weak" for D. Says how firmly this lord is connected to the houses it signifies, NOT whether those houses are favourable, which depends on the matter being judged.
13799
+ */
13800
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
13801
+ };
13802
+ };
13597
13803
  /**
13598
13804
  * Parent Mahadasha lord under which this Antardasha sub-period runs.
13599
13805
  */
@@ -13627,6 +13833,69 @@ export type PostVedicAstrologyDashaCurrentResponses = {
13627
13833
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
13628
13834
  */
13629
13835
  interpretation?: string;
13836
+ /**
13837
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
13838
+ */
13839
+ significators?: {
13840
+ /**
13841
+ * House 1-12 this lord occupies in the Placidus birth chart. Its own Level 2 signification, repeated here because the occupied house is the first thing a KP reading looks at.
13842
+ */
13843
+ house: number;
13844
+ /**
13845
+ * Lord of the nakshatra this planet sits in, one of the 9 grahas. In KP the star lord outranks the planet itself: a period lord mainly delivers the houses its star lord occupies and owns, which is why those appear at L1 and L3 rather than the planet own house.
13846
+ */
13847
+ starLord: string;
13848
+ /**
13849
+ * KP sub lord of this planet, the 1 of 249 subdivision its longitude falls in, one of the 9 grahas. The star lord says WHAT results the period gives, the sub lord says WHETHER they materialize, so KP judgement checks both.
13850
+ */
13851
+ subLord?: string;
13852
+ /**
13853
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
13854
+ */
13855
+ signifies: {
13856
+ /**
13857
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
13858
+ */
13859
+ L1: Array<number>;
13860
+ /**
13861
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
13862
+ */
13863
+ L2: Array<number>;
13864
+ /**
13865
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
13866
+ */
13867
+ L3: Array<number>;
13868
+ /**
13869
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
13870
+ */
13871
+ L4: Array<number>;
13872
+ };
13873
+ /**
13874
+ * Every house this lord signifies, deduplicated and ordered strongest tier first. Where a house is reached at more than one level it is listed once, at its strongest. This is the flat "houses signified" column of a KP dasha table.
13875
+ */
13876
+ signifiedHouses: Array<number>;
13877
+ /**
13878
+ * Subset of signifiedHouses reached at grade A or B (levels L1 and L2). These are the houses a KP reading acts on for this period; the rest are supporting connections.
13879
+ */
13880
+ strongHouses: Array<number>;
13881
+ /**
13882
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
13883
+ */
13884
+ strength: {
13885
+ /**
13886
+ * Mean KP percentage weight across signifiedHouses, each house counted at its strongest level (A 100, B 75, C 50, D 25). A mean rather than a total, so signifying many houses weakly does not outrank signifying two houses at grade A.
13887
+ */
13888
+ score: number;
13889
+ /**
13890
+ * Band the score falls in, on the standard KP significator grading: A planets in the constellation of the occupant, B occupants, C planets in the constellation of the house owner, D the house owner. Band edges are the midpoints between the four weights.
13891
+ */
13892
+ grade: 'A' | 'B' | 'C' | 'D';
13893
+ /**
13894
+ * Plain-language form of grade: "very-strong" for A, "strong" for B, "moderate" for C, "weak" for D. Says how firmly this lord is connected to the houses it signifies, NOT whether those houses are favourable, which depends on the matter being judged.
13895
+ */
13896
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
13897
+ };
13898
+ };
13630
13899
  /**
13631
13900
  * Parent Mahadasha lord under which this Antardasha sub-period runs.
13632
13901
  */
@@ -13637,7 +13906,7 @@ export type PostVedicAstrologyDashaCurrentResponses = {
13637
13906
  antardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
13638
13907
  };
13639
13908
  /**
13640
- * Sookshma dasha (sookshma antardasha), the fourth level of the Vimshottari dasha hierarchy. Each Pratyantardasha divides into 9 Sookshma periods running roughly 3 to 30 days each, the finest level exposed by this API and the one used for day-level event timing and muhurta style selection.
13909
+ * Sookshma dasha (sookshma antardasha), the fourth level of the Vimshottari dasha hierarchy. Each Pratyantardasha divides into 9 Sookshma periods running roughly 3 to 30 days each, used for day-level event timing and muhurta style selection.
13641
13910
  */
13642
13911
  sookshmaDasha: {
13643
13912
  /**
@@ -13664,6 +13933,69 @@ export type PostVedicAstrologyDashaCurrentResponses = {
13664
13933
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
13665
13934
  */
13666
13935
  interpretation?: string;
13936
+ /**
13937
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
13938
+ */
13939
+ significators?: {
13940
+ /**
13941
+ * House 1-12 this lord occupies in the Placidus birth chart. Its own Level 2 signification, repeated here because the occupied house is the first thing a KP reading looks at.
13942
+ */
13943
+ house: number;
13944
+ /**
13945
+ * Lord of the nakshatra this planet sits in, one of the 9 grahas. In KP the star lord outranks the planet itself: a period lord mainly delivers the houses its star lord occupies and owns, which is why those appear at L1 and L3 rather than the planet own house.
13946
+ */
13947
+ starLord: string;
13948
+ /**
13949
+ * KP sub lord of this planet, the 1 of 249 subdivision its longitude falls in, one of the 9 grahas. The star lord says WHAT results the period gives, the sub lord says WHETHER they materialize, so KP judgement checks both.
13950
+ */
13951
+ subLord?: string;
13952
+ /**
13953
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
13954
+ */
13955
+ signifies: {
13956
+ /**
13957
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
13958
+ */
13959
+ L1: Array<number>;
13960
+ /**
13961
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
13962
+ */
13963
+ L2: Array<number>;
13964
+ /**
13965
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
13966
+ */
13967
+ L3: Array<number>;
13968
+ /**
13969
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
13970
+ */
13971
+ L4: Array<number>;
13972
+ };
13973
+ /**
13974
+ * Every house this lord signifies, deduplicated and ordered strongest tier first. Where a house is reached at more than one level it is listed once, at its strongest. This is the flat "houses signified" column of a KP dasha table.
13975
+ */
13976
+ signifiedHouses: Array<number>;
13977
+ /**
13978
+ * Subset of signifiedHouses reached at grade A or B (levels L1 and L2). These are the houses a KP reading acts on for this period; the rest are supporting connections.
13979
+ */
13980
+ strongHouses: Array<number>;
13981
+ /**
13982
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
13983
+ */
13984
+ strength: {
13985
+ /**
13986
+ * Mean KP percentage weight across signifiedHouses, each house counted at its strongest level (A 100, B 75, C 50, D 25). A mean rather than a total, so signifying many houses weakly does not outrank signifying two houses at grade A.
13987
+ */
13988
+ score: number;
13989
+ /**
13990
+ * Band the score falls in, on the standard KP significator grading: A planets in the constellation of the occupant, B occupants, C planets in the constellation of the house owner, D the house owner. Band edges are the midpoints between the four weights.
13991
+ */
13992
+ grade: 'A' | 'B' | 'C' | 'D';
13993
+ /**
13994
+ * Plain-language form of grade: "very-strong" for A, "strong" for B, "moderate" for C, "weak" for D. Says how firmly this lord is connected to the houses it signifies, NOT whether those houses are favourable, which depends on the matter being judged.
13995
+ */
13996
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
13997
+ };
13998
+ };
13667
13999
  /**
13668
14000
  * Parent Mahadasha lord under which this Antardasha sub-period runs.
13669
14001
  */
@@ -13678,69 +14010,190 @@ export type PostVedicAstrologyDashaCurrentResponses = {
13678
14010
  pratyantardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
13679
14011
  };
13680
14012
  /**
13681
- * Time remaining in the currently running Mahadasha (major period).
13682
- */
13683
- remainingInMahadasha: {
13684
- /**
13685
- * Full years remaining in this Vimshottari dasha period.
13686
- */
13687
- years: number;
13688
- /**
13689
- * Additional months remaining beyond full years.
13690
- */
13691
- months: number;
13692
- /**
13693
- * Additional days remaining beyond full months.
13694
- */
13695
- days: number;
13696
- /**
13697
- * Total remaining days in this dasha period. Useful for progress calculations.
13698
- */
13699
- totalDays: number;
13700
- };
13701
- /**
13702
- * Time remaining in the currently running Antardasha (sub-period) within the Mahadasha.
14013
+ * Prana dasha (praana antardasha), the fifth and finest level of the Vimshottari dasha hierarchy. Each Sookshma dasha divides into 9 Prana periods, running from about 20 minutes inside a Sun Mahadasha to about 4 days inside a Saturn one. This is the level that takes Vimshottari from day-level to hour-level timing, used for muhurta selection and pinpointing the trigger inside an already identified window.
13703
14014
  */
13704
- remainingInAntardasha: {
13705
- /**
13706
- * Full years remaining in this Vimshottari dasha period.
13707
- */
13708
- years: number;
14015
+ pranaDasha: {
13709
14016
  /**
13710
- * Additional months remaining beyond full years.
14017
+ * Ruling graha of this Vimshottari dasha period. One of 9 planets in the Ketu-Venus-Sun-Moon-Mars-Rahu-Jupiter-Saturn-Mercury sequence.
13711
14018
  */
13712
- months: number;
14019
+ planet: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
13713
14020
  /**
13714
- * Additional days remaining beyond full months.
14021
+ * Start datetime of this dasha period. Adjusted to the requested timezone offset.
13715
14022
  */
13716
- days: number;
14023
+ startDate: string;
13717
14024
  /**
13718
- * Total remaining days in this dasha period. Useful for progress calculations.
14025
+ * End datetime of this dasha period. Adjusted to the requested timezone offset.
13719
14026
  */
13720
- totalDays: number;
13721
- };
13722
- /**
13723
- * Time remaining in the currently running Pratyantardasha (sub-sub-period).
13724
- */
13725
- remainingInPratyantardasha: {
14027
+ endDate: string;
13726
14028
  /**
13727
- * Full years remaining in this Vimshottari dasha period.
14029
+ * Duration of this dasha period in years. Mahadasha durations range from 6 years (Sun) to 20 years (Venus).
13728
14030
  */
13729
- years: number;
14031
+ durationYears: number;
13730
14032
  /**
13731
- * Additional months remaining beyond full years.
14033
+ * Theoretical start of this period, present ONLY when the birth date truncated it. The Vimshottari cycle is already running when a native is born, so the period in force at birth began earlier: startDate is clipped to the birth moment while this field keeps the real start. Its presence is also why the first period of a chart can contain fewer than 9 sub-periods, the earlier ones having finished before birth. Absent on every period that runs its full length.
13732
14034
  */
13733
- months: number;
14035
+ nominalStartDate?: string;
13734
14036
  /**
13735
- * Additional days remaining beyond full months.
14037
+ * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
13736
14038
  */
13737
- days: number;
14039
+ interpretation?: string;
13738
14040
  /**
13739
- * Total remaining days in this dasha period. Useful for progress calculations.
14041
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
13740
14042
  */
13741
- totalDays: number;
13742
- };
13743
- /**
14043
+ significators?: {
14044
+ /**
14045
+ * House 1-12 this lord occupies in the Placidus birth chart. Its own Level 2 signification, repeated here because the occupied house is the first thing a KP reading looks at.
14046
+ */
14047
+ house: number;
14048
+ /**
14049
+ * Lord of the nakshatra this planet sits in, one of the 9 grahas. In KP the star lord outranks the planet itself: a period lord mainly delivers the houses its star lord occupies and owns, which is why those appear at L1 and L3 rather than the planet own house.
14050
+ */
14051
+ starLord: string;
14052
+ /**
14053
+ * KP sub lord of this planet, the 1 of 249 subdivision its longitude falls in, one of the 9 grahas. The star lord says WHAT results the period gives, the sub lord says WHETHER they materialize, so KP judgement checks both.
14054
+ */
14055
+ subLord?: string;
14056
+ /**
14057
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
14058
+ */
14059
+ signifies: {
14060
+ /**
14061
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
14062
+ */
14063
+ L1: Array<number>;
14064
+ /**
14065
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
14066
+ */
14067
+ L2: Array<number>;
14068
+ /**
14069
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
14070
+ */
14071
+ L3: Array<number>;
14072
+ /**
14073
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
14074
+ */
14075
+ L4: Array<number>;
14076
+ };
14077
+ /**
14078
+ * Every house this lord signifies, deduplicated and ordered strongest tier first. Where a house is reached at more than one level it is listed once, at its strongest. This is the flat "houses signified" column of a KP dasha table.
14079
+ */
14080
+ signifiedHouses: Array<number>;
14081
+ /**
14082
+ * Subset of signifiedHouses reached at grade A or B (levels L1 and L2). These are the houses a KP reading acts on for this period; the rest are supporting connections.
14083
+ */
14084
+ strongHouses: Array<number>;
14085
+ /**
14086
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
14087
+ */
14088
+ strength: {
14089
+ /**
14090
+ * Mean KP percentage weight across signifiedHouses, each house counted at its strongest level (A 100, B 75, C 50, D 25). A mean rather than a total, so signifying many houses weakly does not outrank signifying two houses at grade A.
14091
+ */
14092
+ score: number;
14093
+ /**
14094
+ * Band the score falls in, on the standard KP significator grading: A planets in the constellation of the occupant, B occupants, C planets in the constellation of the house owner, D the house owner. Band edges are the midpoints between the four weights.
14095
+ */
14096
+ grade: 'A' | 'B' | 'C' | 'D';
14097
+ /**
14098
+ * Plain-language form of grade: "very-strong" for A, "strong" for B, "moderate" for C, "weak" for D. Says how firmly this lord is connected to the houses it signifies, NOT whether those houses are favourable, which depends on the matter being judged.
14099
+ */
14100
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
14101
+ };
14102
+ };
14103
+ /**
14104
+ * Parent Mahadasha lord under which this Antardasha sub-period runs.
14105
+ */
14106
+ mahadashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14107
+ /**
14108
+ * Parent Antardasha lord under which this Pratyantardasha runs.
14109
+ */
14110
+ antardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14111
+ /**
14112
+ * Parent Pratyantardasha lord under which this Sookshma dasha runs.
14113
+ */
14114
+ pratyantardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14115
+ /**
14116
+ * Parent Sookshma dasha lord under which this Prana dasha runs.
14117
+ */
14118
+ sookshmaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14119
+ };
14120
+ /**
14121
+ * Houses common to the significators of the running dasha lords. In KP a matter fructifies under lords that jointly signify the houses of that matter, so these two sets are what a prediction is checked against.
14122
+ */
14123
+ commonHouses?: {
14124
+ /**
14125
+ * Houses signified by ALL FIVE running lords at once (Mahadasha through Prana). The tightest reading available: a house every active level carries is the one the current moment is pointed at. Often empty, which is itself informative, it means the five levels do not converge on a single house.
14126
+ */
14127
+ allLevels: Array<number>;
14128
+ /**
14129
+ * Houses signified by the Mahadasha, Antardasha and Pratyantardasha lords together, the classical KP three-lord test used to decide whether a matter fructifies in the running period. Wider than allLevels because it ignores the two fastest levels, which is what makes it the practical filter for month-scale predictions.
14130
+ */
14131
+ dashaBhuktiAntara: Array<number>;
14132
+ };
14133
+ /**
14134
+ * Time remaining in the currently running Mahadasha (major period).
14135
+ */
14136
+ remainingInMahadasha: {
14137
+ /**
14138
+ * Full years remaining in this Vimshottari dasha period.
14139
+ */
14140
+ years: number;
14141
+ /**
14142
+ * Additional months remaining beyond full years.
14143
+ */
14144
+ months: number;
14145
+ /**
14146
+ * Additional days remaining beyond full months.
14147
+ */
14148
+ days: number;
14149
+ /**
14150
+ * Total remaining days in this dasha period. Useful for progress calculations.
14151
+ */
14152
+ totalDays: number;
14153
+ };
14154
+ /**
14155
+ * Time remaining in the currently running Antardasha (sub-period) within the Mahadasha.
14156
+ */
14157
+ remainingInAntardasha: {
14158
+ /**
14159
+ * Full years remaining in this Vimshottari dasha period.
14160
+ */
14161
+ years: number;
14162
+ /**
14163
+ * Additional months remaining beyond full years.
14164
+ */
14165
+ months: number;
14166
+ /**
14167
+ * Additional days remaining beyond full months.
14168
+ */
14169
+ days: number;
14170
+ /**
14171
+ * Total remaining days in this dasha period. Useful for progress calculations.
14172
+ */
14173
+ totalDays: number;
14174
+ };
14175
+ /**
14176
+ * Time remaining in the currently running Pratyantardasha (sub-sub-period).
14177
+ */
14178
+ remainingInPratyantardasha: {
14179
+ /**
14180
+ * Full years remaining in this Vimshottari dasha period.
14181
+ */
14182
+ years: number;
14183
+ /**
14184
+ * Additional months remaining beyond full years.
14185
+ */
14186
+ months: number;
14187
+ /**
14188
+ * Additional days remaining beyond full months.
14189
+ */
14190
+ days: number;
14191
+ /**
14192
+ * Total remaining days in this dasha period. Useful for progress calculations.
14193
+ */
14194
+ totalDays: number;
14195
+ };
14196
+ /**
13744
14197
  * Time remaining in the currently running Sookshma dasha (fourth level). Sookshma periods last days rather than months, so this value turns over quickly.
13745
14198
  */
13746
14199
  remainingInSookshma: {
@@ -13761,6 +14214,27 @@ export type PostVedicAstrologyDashaCurrentResponses = {
13761
14214
  */
13762
14215
  totalDays: number;
13763
14216
  };
14217
+ /**
14218
+ * Time remaining in the currently running Prana dasha (fifth level). Prana periods run hours to days, so totalDays is often 0 or 1 and the years and months fields are almost always zero.
14219
+ */
14220
+ remainingInPrana: {
14221
+ /**
14222
+ * Full years remaining in this Vimshottari dasha period.
14223
+ */
14224
+ years: number;
14225
+ /**
14226
+ * Additional months remaining beyond full years.
14227
+ */
14228
+ months: number;
14229
+ /**
14230
+ * Additional days remaining beyond full months.
14231
+ */
14232
+ days: number;
14233
+ /**
14234
+ * Total remaining days in this dasha period. Useful for progress calculations.
14235
+ */
14236
+ totalDays: number;
14237
+ };
13764
14238
  };
13765
14239
  };
13766
14240
 
@@ -13792,6 +14266,14 @@ export type PostVedicAstrologyDashaMajorData = {
13792
14266
  * 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. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
13793
14267
  */
13794
14268
  ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri';
14269
+ /**
14270
+ * Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above.
14271
+ */
14272
+ significators?: boolean;
14273
+ /**
14274
+ * Lunar node type for Rahu and Ketu, used ONLY when "significators" is true. Dasha dates themselves come from the Moon and never move with this field. "mean" uses the smooth mean node (traditional default). "true" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to "mean".
14275
+ */
14276
+ nodeType?: 'mean' | 'true';
13795
14277
  };
13796
14278
  path?: never;
13797
14279
  query?: {
@@ -13912,6 +14394,12 @@ export type PostVedicAstrologyDashaMajorResponses = {
13912
14394
  * Complete 120-year Vimshottari Dasha timeline with all 9 Mahadasha periods, birth dasha balance, Moon nakshatra, and start/end dates for each planetary period.
13913
14395
  */
13914
14396
  200: {
14397
+ /**
14398
+ * What each house MEANS, keyed by house number 1 to 12, in the requested language. Turns a house list into words without the client writing any interpretation copy: for a period signifying houses 2, 7 and 8, join houseThemes for those keys to render the "nature" line of a KP dasha table. Sent once per response rather than repeated on every period, so look the houses up from signifiedHouses or strongHouses. Localized by the lang query, like every other interpretation field.
14399
+ */
14400
+ houseThemes?: {
14401
+ [key: string]: Array<string>;
14402
+ };
13915
14403
  /**
13916
14404
  * Birth Moon nakshatra number (1-27) that determines the Vimshottari starting point.
13917
14405
  */
@@ -13985,6 +14473,69 @@ export type PostVedicAstrologyDashaMajorResponses = {
13985
14473
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
13986
14474
  */
13987
14475
  interpretation?: string;
14476
+ /**
14477
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
14478
+ */
14479
+ significators?: {
14480
+ /**
14481
+ * House 1-12 this lord occupies in the Placidus birth chart. Its own Level 2 signification, repeated here because the occupied house is the first thing a KP reading looks at.
14482
+ */
14483
+ house: number;
14484
+ /**
14485
+ * Lord of the nakshatra this planet sits in, one of the 9 grahas. In KP the star lord outranks the planet itself: a period lord mainly delivers the houses its star lord occupies and owns, which is why those appear at L1 and L3 rather than the planet own house.
14486
+ */
14487
+ starLord: string;
14488
+ /**
14489
+ * KP sub lord of this planet, the 1 of 249 subdivision its longitude falls in, one of the 9 grahas. The star lord says WHAT results the period gives, the sub lord says WHETHER they materialize, so KP judgement checks both.
14490
+ */
14491
+ subLord?: string;
14492
+ /**
14493
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
14494
+ */
14495
+ signifies: {
14496
+ /**
14497
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
14498
+ */
14499
+ L1: Array<number>;
14500
+ /**
14501
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
14502
+ */
14503
+ L2: Array<number>;
14504
+ /**
14505
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
14506
+ */
14507
+ L3: Array<number>;
14508
+ /**
14509
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
14510
+ */
14511
+ L4: Array<number>;
14512
+ };
14513
+ /**
14514
+ * Every house this lord signifies, deduplicated and ordered strongest tier first. Where a house is reached at more than one level it is listed once, at its strongest. This is the flat "houses signified" column of a KP dasha table.
14515
+ */
14516
+ signifiedHouses: Array<number>;
14517
+ /**
14518
+ * Subset of signifiedHouses reached at grade A or B (levels L1 and L2). These are the houses a KP reading acts on for this period; the rest are supporting connections.
14519
+ */
14520
+ strongHouses: Array<number>;
14521
+ /**
14522
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
14523
+ */
14524
+ strength: {
14525
+ /**
14526
+ * Mean KP percentage weight across signifiedHouses, each house counted at its strongest level (A 100, B 75, C 50, D 25). A mean rather than a total, so signifying many houses weakly does not outrank signifying two houses at grade A.
14527
+ */
14528
+ score: number;
14529
+ /**
14530
+ * Band the score falls in, on the standard KP significator grading: A planets in the constellation of the occupant, B occupants, C planets in the constellation of the house owner, D the house owner. Band edges are the midpoints between the four weights.
14531
+ */
14532
+ grade: 'A' | 'B' | 'C' | 'D';
14533
+ /**
14534
+ * Plain-language form of grade: "very-strong" for A, "strong" for B, "moderate" for C, "weak" for D. Says how firmly this lord is connected to the houses it signifies, NOT whether those houses are favourable, which depends on the matter being judged.
14535
+ */
14536
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
14537
+ };
14538
+ };
13988
14539
  }>;
13989
14540
  /**
13990
14541
  * Total Vimshottari cycle length in years (always 120).
@@ -14021,6 +14572,14 @@ export type PostVedicAstrologyDashaSubByMahadashaData = {
14021
14572
  * 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. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
14022
14573
  */
14023
14574
  ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri';
14575
+ /**
14576
+ * Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above.
14577
+ */
14578
+ significators?: boolean;
14579
+ /**
14580
+ * Lunar node type for Rahu and Ketu, used ONLY when "significators" is true. Dasha dates themselves come from the Moon and never move with this field. "mean" uses the smooth mean node (traditional default). "true" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to "mean".
14581
+ */
14582
+ nodeType?: 'mean' | 'true';
14024
14583
  };
14025
14584
  path: {
14026
14585
  /**
@@ -14146,6 +14705,12 @@ export type PostVedicAstrologyDashaSubByMahadashaResponses = {
14146
14705
  * All 9 Antardasha sub-periods within the specified Mahadasha, with start/end dates and the parent Mahadasha period details.
14147
14706
  */
14148
14707
  200: {
14708
+ /**
14709
+ * What each house MEANS, keyed by house number 1 to 12, in the requested language. Turns a house list into words without the client writing any interpretation copy: for a period signifying houses 2, 7 and 8, join houseThemes for those keys to render the "nature" line of a KP dasha table. Sent once per response rather than repeated on every period, so look the houses up from signifiedHouses or strongHouses. Localized by the lang query, like every other interpretation field.
14710
+ */
14711
+ houseThemes?: {
14712
+ [key: string]: Array<string>;
14713
+ };
14149
14714
  /**
14150
14715
  * Ruling planet of the requested Mahadasha period.
14151
14716
  */
@@ -14190,6 +14755,69 @@ export type PostVedicAstrologyDashaSubByMahadashaResponses = {
14190
14755
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
14191
14756
  */
14192
14757
  interpretation?: string;
14758
+ /**
14759
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
14760
+ */
14761
+ significators?: {
14762
+ /**
14763
+ * House 1-12 this lord occupies in the Placidus birth chart. Its own Level 2 signification, repeated here because the occupied house is the first thing a KP reading looks at.
14764
+ */
14765
+ house: number;
14766
+ /**
14767
+ * Lord of the nakshatra this planet sits in, one of the 9 grahas. In KP the star lord outranks the planet itself: a period lord mainly delivers the houses its star lord occupies and owns, which is why those appear at L1 and L3 rather than the planet own house.
14768
+ */
14769
+ starLord: string;
14770
+ /**
14771
+ * KP sub lord of this planet, the 1 of 249 subdivision its longitude falls in, one of the 9 grahas. The star lord says WHAT results the period gives, the sub lord says WHETHER they materialize, so KP judgement checks both.
14772
+ */
14773
+ subLord?: string;
14774
+ /**
14775
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
14776
+ */
14777
+ signifies: {
14778
+ /**
14779
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
14780
+ */
14781
+ L1: Array<number>;
14782
+ /**
14783
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
14784
+ */
14785
+ L2: Array<number>;
14786
+ /**
14787
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
14788
+ */
14789
+ L3: Array<number>;
14790
+ /**
14791
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
14792
+ */
14793
+ L4: Array<number>;
14794
+ };
14795
+ /**
14796
+ * Every house this lord signifies, deduplicated and ordered strongest tier first. Where a house is reached at more than one level it is listed once, at its strongest. This is the flat "houses signified" column of a KP dasha table.
14797
+ */
14798
+ signifiedHouses: Array<number>;
14799
+ /**
14800
+ * Subset of signifiedHouses reached at grade A or B (levels L1 and L2). These are the houses a KP reading acts on for this period; the rest are supporting connections.
14801
+ */
14802
+ strongHouses: Array<number>;
14803
+ /**
14804
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
14805
+ */
14806
+ strength: {
14807
+ /**
14808
+ * Mean KP percentage weight across signifiedHouses, each house counted at its strongest level (A 100, B 75, C 50, D 25). A mean rather than a total, so signifying many houses weakly does not outrank signifying two houses at grade A.
14809
+ */
14810
+ score: number;
14811
+ /**
14812
+ * Band the score falls in, on the standard KP significator grading: A planets in the constellation of the occupant, B occupants, C planets in the constellation of the house owner, D the house owner. Band edges are the midpoints between the four weights.
14813
+ */
14814
+ grade: 'A' | 'B' | 'C' | 'D';
14815
+ /**
14816
+ * Plain-language form of grade: "very-strong" for A, "strong" for B, "moderate" for C, "weak" for D. Says how firmly this lord is connected to the houses it signifies, NOT whether those houses are favourable, which depends on the matter being judged.
14817
+ */
14818
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
14819
+ };
14820
+ };
14193
14821
  };
14194
14822
  /**
14195
14823
  * Antardasha (bhukti) sub-periods within this Mahadasha, proportional to each planet Vimshottari years, sorted chronologically. Nine for any Mahadasha the native lived through in full. FEWER than nine for the first Mahadasha in the chart, because the Vimshottari cycle was already running at birth: the Antardashas that ended before the birth date are not part of the chart, and the one in force at birth starts on the birth date.
@@ -14219,17 +14847,470 @@ export type PostVedicAstrologyDashaSubByMahadashaResponses = {
14219
14847
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
14220
14848
  */
14221
14849
  interpretation?: string;
14850
+ /**
14851
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
14852
+ */
14853
+ significators?: {
14854
+ /**
14855
+ * House 1-12 this lord occupies in the Placidus birth chart. Its own Level 2 signification, repeated here because the occupied house is the first thing a KP reading looks at.
14856
+ */
14857
+ house: number;
14858
+ /**
14859
+ * Lord of the nakshatra this planet sits in, one of the 9 grahas. In KP the star lord outranks the planet itself: a period lord mainly delivers the houses its star lord occupies and owns, which is why those appear at L1 and L3 rather than the planet own house.
14860
+ */
14861
+ starLord: string;
14862
+ /**
14863
+ * KP sub lord of this planet, the 1 of 249 subdivision its longitude falls in, one of the 9 grahas. The star lord says WHAT results the period gives, the sub lord says WHETHER they materialize, so KP judgement checks both.
14864
+ */
14865
+ subLord?: string;
14866
+ /**
14867
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
14868
+ */
14869
+ signifies: {
14870
+ /**
14871
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
14872
+ */
14873
+ L1: Array<number>;
14874
+ /**
14875
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
14876
+ */
14877
+ L2: Array<number>;
14878
+ /**
14879
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
14880
+ */
14881
+ L3: Array<number>;
14882
+ /**
14883
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
14884
+ */
14885
+ L4: Array<number>;
14886
+ };
14887
+ /**
14888
+ * Every house this lord signifies, deduplicated and ordered strongest tier first. Where a house is reached at more than one level it is listed once, at its strongest. This is the flat "houses signified" column of a KP dasha table.
14889
+ */
14890
+ signifiedHouses: Array<number>;
14891
+ /**
14892
+ * Subset of signifiedHouses reached at grade A or B (levels L1 and L2). These are the houses a KP reading acts on for this period; the rest are supporting connections.
14893
+ */
14894
+ strongHouses: Array<number>;
14895
+ /**
14896
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
14897
+ */
14898
+ strength: {
14899
+ /**
14900
+ * Mean KP percentage weight across signifiedHouses, each house counted at its strongest level (A 100, B 75, C 50, D 25). A mean rather than a total, so signifying many houses weakly does not outrank signifying two houses at grade A.
14901
+ */
14902
+ score: number;
14903
+ /**
14904
+ * Band the score falls in, on the standard KP significator grading: A planets in the constellation of the occupant, B occupants, C planets in the constellation of the house owner, D the house owner. Band edges are the midpoints between the four weights.
14905
+ */
14906
+ grade: 'A' | 'B' | 'C' | 'D';
14907
+ /**
14908
+ * Plain-language form of grade: "very-strong" for A, "strong" for B, "moderate" for C, "weak" for D. Says how firmly this lord is connected to the houses it signifies, NOT whether those houses are favourable, which depends on the matter being judged.
14909
+ */
14910
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
14911
+ };
14912
+ };
14913
+ /**
14914
+ * Parent Mahadasha lord under which this Antardasha sub-period runs.
14915
+ */
14916
+ mahadashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14917
+ }>;
14918
+ };
14919
+ };
14920
+
14921
+ export type PostVedicAstrologyDashaSubByMahadashaResponse = PostVedicAstrologyDashaSubByMahadashaResponses[keyof PostVedicAstrologyDashaSubByMahadashaResponses];
14922
+
14923
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaData = {
14924
+ body?: {
14925
+ /**
14926
+ * 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).
14927
+ */
14928
+ date: string;
14929
+ /**
14930
+ * 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.
14931
+ */
14932
+ time: string;
14933
+ /**
14934
+ * 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.
14935
+ */
14936
+ latitude: number;
14937
+ /**
14938
+ * Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.
14939
+ */
14940
+ longitude: number;
14941
+ /**
14942
+ * 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.
14943
+ */
14944
+ timezone?: number | string;
14945
+ /**
14946
+ * 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. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
14947
+ */
14948
+ ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri';
14949
+ /**
14950
+ * Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above.
14951
+ */
14952
+ significators?: boolean;
14953
+ /**
14954
+ * Lunar node type for Rahu and Ketu, used ONLY when "significators" is true. Dasha dates themselves come from the Moon and never move with this field. "mean" uses the smooth mean node (traditional default). "true" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to "mean".
14955
+ */
14956
+ nodeType?: 'mean' | 'true';
14957
+ };
14958
+ path: {
14959
+ /**
14960
+ * Mahadasha planet name, case-insensitive (e.g. saturn, Saturn, SATURN all work). Valid: Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury.
14961
+ */
14962
+ mahadasha: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14963
+ /**
14964
+ * Antardasha (bhukti) planet name inside that Mahadasha, case-insensitive. Every Mahadasha contains all 9 lords, so a repeat such as saturn/saturn is valid.
14965
+ */
14966
+ antardasha: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14967
+ };
14968
+ query?: {
14969
+ /**
14970
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
14971
+ */
14972
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
14973
+ };
14974
+ url: '/vedic-astrology/dasha/sub/{mahadasha}/{antardasha}';
14975
+ };
14976
+
14977
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaErrors = {
14978
+ /**
14979
+ * Validation error. `issues[]` lists every failed field.
14980
+ */
14981
+ 400: {
14982
+ /**
14983
+ * First issue summary.
14984
+ */
14985
+ error: string;
14986
+ code: 'validation_error';
14987
+ /**
14988
+ * Every validation failure. Use this to rebuild a valid request.
14989
+ */
14990
+ issues: Array<{
14991
+ /**
14992
+ * Dot-separated field path, or "(root)" for top-level.
14993
+ */
14994
+ path: string;
14995
+ message: string;
14996
+ /**
14997
+ * Zod issue code (invalid_type, too_small, too_big, invalid_string, ...).
14998
+ */
14999
+ code?: string;
15000
+ /**
15001
+ * Expected type for invalid_type.
15002
+ */
15003
+ expected?: string;
15004
+ /**
15005
+ * Minimum bound for too_small issues.
15006
+ */
15007
+ minimum?: number | string;
15008
+ /**
15009
+ * Maximum bound for too_big issues.
15010
+ */
15011
+ maximum?: number | string;
15012
+ inclusive?: boolean;
15013
+ /**
15014
+ * Format name for string issues (regex, email, url, uuid).
15015
+ */
15016
+ format?: string;
15017
+ /**
15018
+ * Regex pattern when format is regex.
15019
+ */
15020
+ pattern?: string;
15021
+ }>;
15022
+ };
15023
+ /**
15024
+ * Invalid or missing API key
15025
+ */
15026
+ 401: {
15027
+ /**
15028
+ * Human-readable error message. May change wording.
15029
+ */
15030
+ error: string;
15031
+ /**
15032
+ * Machine-readable error code. Stable identifier.
15033
+ */
15034
+ code: string;
15035
+ };
15036
+ /**
15037
+ * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
15038
+ */
15039
+ 405: {
15040
+ error: string;
15041
+ code: 'method_not_allowed';
15042
+ /**
15043
+ * Allowed HTTP methods for this path. Mirrors the Allow response header.
15044
+ */
15045
+ allow: Array<string>;
15046
+ /**
15047
+ * Link to the product page for this domain.
15048
+ */
15049
+ docs?: string;
15050
+ };
15051
+ /**
15052
+ * Monthly rate limit exceeded
15053
+ */
15054
+ 429: {
15055
+ /**
15056
+ * Human-readable error message. May change wording.
15057
+ */
15058
+ error: string;
15059
+ /**
15060
+ * Machine-readable error code. Stable identifier.
15061
+ */
15062
+ code: string;
15063
+ };
15064
+ /**
15065
+ * Internal server error
15066
+ */
15067
+ 500: {
15068
+ /**
15069
+ * Human-readable error message. May change wording.
15070
+ */
15071
+ error: string;
15072
+ /**
15073
+ * Machine-readable error code. Stable identifier.
15074
+ */
15075
+ code: string;
15076
+ };
15077
+ };
15078
+
15079
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaError = PostVedicAstrologyDashaSubByMahadashaByAntardashaErrors[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaErrors];
15080
+
15081
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses = {
15082
+ /**
15083
+ * All 9 Pratyantardasha periods within the specified Mahadasha and Antardasha, with start/end dates and the parent Antardasha period details.
15084
+ */
15085
+ 200: {
15086
+ /**
15087
+ * What each house MEANS, keyed by house number 1 to 12, in the requested language. Turns a house list into words without the client writing any interpretation copy: for a period signifying houses 2, 7 and 8, join houseThemes for those keys to render the "nature" line of a KP dasha table. Sent once per response rather than repeated on every period, so look the houses up from signifiedHouses or strongHouses. Localized by the lang query, like every other interpretation field.
15088
+ */
15089
+ houseThemes?: {
15090
+ [key: string]: Array<string>;
15091
+ };
15092
+ /**
15093
+ * Ruling planet of the requested Mahadasha period.
15094
+ */
15095
+ mahadashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15096
+ /**
15097
+ * Ruling planet of the requested Antardasha sub-period.
15098
+ */
15099
+ antardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15100
+ /**
15101
+ * Sidereal (nirayana) longitude of the birth Moon in degrees, 0 to 360, measured in the ayanamsa frame reported below. This single value determines the birth nakshatra and therefore every dasha start and end date in this response. Compare it against a reference chart to reconcile any date difference at its source.
15102
+ */
15103
+ moonLongitude: number;
15104
+ /**
15105
+ * Ayanamsa actually applied, in degrees. The precession offset subtracted from the tropical (sayana) longitude to get the sidereal (nirayana) one. Lahiri sits near 23 deg 43 min for a 1990 birth, KP-Newcomb near 23 deg 38 min.
15106
+ */
15107
+ ayanamsa: number;
15108
+ /**
15109
+ * Ayanamsa system used, echoing the request field. One of "lahiri", "kp-newcomb", "kp-old". Echoed so a client can confirm which frame produced these dates without re-deriving it.
15110
+ */
15111
+ ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri';
15112
+ /**
15113
+ * Full details of the parent Antardasha including start/end dates and duration.
15114
+ */
15115
+ antardashaPeriod: {
15116
+ /**
15117
+ * Ruling graha of this Vimshottari dasha period. One of 9 planets in the Ketu-Venus-Sun-Moon-Mars-Rahu-Jupiter-Saturn-Mercury sequence.
15118
+ */
15119
+ planet: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15120
+ /**
15121
+ * Start datetime of this dasha period. Adjusted to the requested timezone offset.
15122
+ */
15123
+ startDate: string;
15124
+ /**
15125
+ * End datetime of this dasha period. Adjusted to the requested timezone offset.
15126
+ */
15127
+ endDate: string;
15128
+ /**
15129
+ * Duration of this dasha period in years. Mahadasha durations range from 6 years (Sun) to 20 years (Venus).
15130
+ */
15131
+ durationYears: number;
15132
+ /**
15133
+ * Theoretical start of this period, present ONLY when the birth date truncated it. The Vimshottari cycle is already running when a native is born, so the period in force at birth began earlier: startDate is clipped to the birth moment while this field keeps the real start. Its presence is also why the first period of a chart can contain fewer than 9 sub-periods, the earlier ones having finished before birth. Absent on every period that runs its full length.
15134
+ */
15135
+ nominalStartDate?: string;
15136
+ /**
15137
+ * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
15138
+ */
15139
+ interpretation?: string;
15140
+ /**
15141
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
15142
+ */
15143
+ significators?: {
15144
+ /**
15145
+ * House 1-12 this lord occupies in the Placidus birth chart. Its own Level 2 signification, repeated here because the occupied house is the first thing a KP reading looks at.
15146
+ */
15147
+ house: number;
15148
+ /**
15149
+ * Lord of the nakshatra this planet sits in, one of the 9 grahas. In KP the star lord outranks the planet itself: a period lord mainly delivers the houses its star lord occupies and owns, which is why those appear at L1 and L3 rather than the planet own house.
15150
+ */
15151
+ starLord: string;
15152
+ /**
15153
+ * KP sub lord of this planet, the 1 of 249 subdivision its longitude falls in, one of the 9 grahas. The star lord says WHAT results the period gives, the sub lord says WHETHER they materialize, so KP judgement checks both.
15154
+ */
15155
+ subLord?: string;
15156
+ /**
15157
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
15158
+ */
15159
+ signifies: {
15160
+ /**
15161
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
15162
+ */
15163
+ L1: Array<number>;
15164
+ /**
15165
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
15166
+ */
15167
+ L2: Array<number>;
15168
+ /**
15169
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
15170
+ */
15171
+ L3: Array<number>;
15172
+ /**
15173
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
15174
+ */
15175
+ L4: Array<number>;
15176
+ };
15177
+ /**
15178
+ * Every house this lord signifies, deduplicated and ordered strongest tier first. Where a house is reached at more than one level it is listed once, at its strongest. This is the flat "houses signified" column of a KP dasha table.
15179
+ */
15180
+ signifiedHouses: Array<number>;
15181
+ /**
15182
+ * Subset of signifiedHouses reached at grade A or B (levels L1 and L2). These are the houses a KP reading acts on for this period; the rest are supporting connections.
15183
+ */
15184
+ strongHouses: Array<number>;
15185
+ /**
15186
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
15187
+ */
15188
+ strength: {
15189
+ /**
15190
+ * Mean KP percentage weight across signifiedHouses, each house counted at its strongest level (A 100, B 75, C 50, D 25). A mean rather than a total, so signifying many houses weakly does not outrank signifying two houses at grade A.
15191
+ */
15192
+ score: number;
15193
+ /**
15194
+ * Band the score falls in, on the standard KP significator grading: A planets in the constellation of the occupant, B occupants, C planets in the constellation of the house owner, D the house owner. Band edges are the midpoints between the four weights.
15195
+ */
15196
+ grade: 'A' | 'B' | 'C' | 'D';
15197
+ /**
15198
+ * Plain-language form of grade: "very-strong" for A, "strong" for B, "moderate" for C, "weak" for D. Says how firmly this lord is connected to the houses it signifies, NOT whether those houses are favourable, which depends on the matter being judged.
15199
+ */
15200
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
15201
+ };
15202
+ };
15203
+ /**
15204
+ * Parent Mahadasha lord under which this Antardasha sub-period runs.
15205
+ */
15206
+ mahadashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15207
+ };
15208
+ /**
15209
+ * Pratyantardasha (antara) periods within this Antardasha, proportional to each planet Vimshottari years, sorted chronologically and starting with the Antardasha lord. Fewer than nine only when the parent Antardasha is the one that was already running at birth, in which case the periods that ended before the birth date are omitted.
15210
+ */
15211
+ pratyantardashas: Array<{
15212
+ /**
15213
+ * Ruling graha of this Vimshottari dasha period. One of 9 planets in the Ketu-Venus-Sun-Moon-Mars-Rahu-Jupiter-Saturn-Mercury sequence.
15214
+ */
15215
+ planet: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15216
+ /**
15217
+ * Start datetime of this dasha period. Adjusted to the requested timezone offset.
15218
+ */
15219
+ startDate: string;
15220
+ /**
15221
+ * End datetime of this dasha period. Adjusted to the requested timezone offset.
15222
+ */
15223
+ endDate: string;
15224
+ /**
15225
+ * Duration of this dasha period in years. Mahadasha durations range from 6 years (Sun) to 20 years (Venus).
15226
+ */
15227
+ durationYears: number;
15228
+ /**
15229
+ * Theoretical start of this period, present ONLY when the birth date truncated it. The Vimshottari cycle is already running when a native is born, so the period in force at birth began earlier: startDate is clipped to the birth moment while this field keeps the real start. Its presence is also why the first period of a chart can contain fewer than 9 sub-periods, the earlier ones having finished before birth. Absent on every period that runs its full length.
15230
+ */
15231
+ nominalStartDate?: string;
15232
+ /**
15233
+ * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
15234
+ */
15235
+ interpretation?: string;
15236
+ /**
15237
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
15238
+ */
15239
+ significators?: {
15240
+ /**
15241
+ * House 1-12 this lord occupies in the Placidus birth chart. Its own Level 2 signification, repeated here because the occupied house is the first thing a KP reading looks at.
15242
+ */
15243
+ house: number;
15244
+ /**
15245
+ * Lord of the nakshatra this planet sits in, one of the 9 grahas. In KP the star lord outranks the planet itself: a period lord mainly delivers the houses its star lord occupies and owns, which is why those appear at L1 and L3 rather than the planet own house.
15246
+ */
15247
+ starLord: string;
15248
+ /**
15249
+ * KP sub lord of this planet, the 1 of 249 subdivision its longitude falls in, one of the 9 grahas. The star lord says WHAT results the period gives, the sub lord says WHETHER they materialize, so KP judgement checks both.
15250
+ */
15251
+ subLord?: string;
15252
+ /**
15253
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
15254
+ */
15255
+ signifies: {
15256
+ /**
15257
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
15258
+ */
15259
+ L1: Array<number>;
15260
+ /**
15261
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
15262
+ */
15263
+ L2: Array<number>;
15264
+ /**
15265
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
15266
+ */
15267
+ L3: Array<number>;
15268
+ /**
15269
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
15270
+ */
15271
+ L4: Array<number>;
15272
+ };
15273
+ /**
15274
+ * Every house this lord signifies, deduplicated and ordered strongest tier first. Where a house is reached at more than one level it is listed once, at its strongest. This is the flat "houses signified" column of a KP dasha table.
15275
+ */
15276
+ signifiedHouses: Array<number>;
15277
+ /**
15278
+ * Subset of signifiedHouses reached at grade A or B (levels L1 and L2). These are the houses a KP reading acts on for this period; the rest are supporting connections.
15279
+ */
15280
+ strongHouses: Array<number>;
15281
+ /**
15282
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
15283
+ */
15284
+ strength: {
15285
+ /**
15286
+ * Mean KP percentage weight across signifiedHouses, each house counted at its strongest level (A 100, B 75, C 50, D 25). A mean rather than a total, so signifying many houses weakly does not outrank signifying two houses at grade A.
15287
+ */
15288
+ score: number;
15289
+ /**
15290
+ * Band the score falls in, on the standard KP significator grading: A planets in the constellation of the occupant, B occupants, C planets in the constellation of the house owner, D the house owner. Band edges are the midpoints between the four weights.
15291
+ */
15292
+ grade: 'A' | 'B' | 'C' | 'D';
15293
+ /**
15294
+ * Plain-language form of grade: "very-strong" for A, "strong" for B, "moderate" for C, "weak" for D. Says how firmly this lord is connected to the houses it signifies, NOT whether those houses are favourable, which depends on the matter being judged.
15295
+ */
15296
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
15297
+ };
15298
+ };
14222
15299
  /**
14223
15300
  * Parent Mahadasha lord under which this Antardasha sub-period runs.
14224
15301
  */
14225
15302
  mahadashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15303
+ /**
15304
+ * Parent Antardasha lord under which this Pratyantardasha runs.
15305
+ */
15306
+ antardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14226
15307
  }>;
14227
15308
  };
14228
15309
  };
14229
15310
 
14230
- export type PostVedicAstrologyDashaSubByMahadashaResponse = PostVedicAstrologyDashaSubByMahadashaResponses[keyof PostVedicAstrologyDashaSubByMahadashaResponses];
15311
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponse = PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses];
14231
15312
 
14232
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaData = {
15313
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaData = {
14233
15314
  body?: {
14234
15315
  /**
14235
15316
  * 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).
@@ -14255,16 +15336,28 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaData = {
14255
15336
  * 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. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
14256
15337
  */
14257
15338
  ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri';
15339
+ /**
15340
+ * Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above.
15341
+ */
15342
+ significators?: boolean;
15343
+ /**
15344
+ * Lunar node type for Rahu and Ketu, used ONLY when "significators" is true. Dasha dates themselves come from the Moon and never move with this field. "mean" uses the smooth mean node (traditional default). "true" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to "mean".
15345
+ */
15346
+ nodeType?: 'mean' | 'true';
14258
15347
  };
14259
15348
  path: {
14260
15349
  /**
14261
- * Mahadasha planet name, case-insensitive (e.g. saturn, Saturn, SATURN all work). Valid: Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury.
15350
+ * Mahadasha planet name, case-insensitive. Valid: Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury.
14262
15351
  */
14263
15352
  mahadasha: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14264
15353
  /**
14265
- * Antardasha (bhukti) planet name inside that Mahadasha, case-insensitive. Every Mahadasha contains all 9 lords, so a repeat such as saturn/saturn is valid.
15354
+ * Antardasha (bhukti) planet name inside that Mahadasha, case-insensitive.
14266
15355
  */
14267
15356
  antardasha: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15357
+ /**
15358
+ * Pratyantardasha (antara) planet name inside that Antardasha, case-insensitive.
15359
+ */
15360
+ pratyantardasha: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14268
15361
  };
14269
15362
  query?: {
14270
15363
  /**
@@ -14272,10 +15365,10 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaData = {
14272
15365
  */
14273
15366
  lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
14274
15367
  };
14275
- url: '/vedic-astrology/dasha/sub/{mahadasha}/{antardasha}';
15368
+ url: '/vedic-astrology/dasha/sub/{mahadasha}/{antardasha}/{pratyantardasha}';
14276
15369
  };
14277
15370
 
14278
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaErrors = {
15371
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaErrors = {
14279
15372
  /**
14280
15373
  * Validation error. `issues[]` lists every failed field.
14281
15374
  */
@@ -14377,13 +15470,19 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaErrors = {
14377
15470
  };
14378
15471
  };
14379
15472
 
14380
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaError = PostVedicAstrologyDashaSubByMahadashaByAntardashaErrors[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaErrors];
15473
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaError = PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaErrors[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaErrors];
14381
15474
 
14382
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses = {
15475
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaResponses = {
14383
15476
  /**
14384
- * All 9 Pratyantardasha periods within the specified Mahadasha and Antardasha, with start/end dates and the parent Antardasha period details.
15477
+ * All 9 Sookshma dasha periods within the specified Mahadasha, Antardasha, and Pratyantardasha, with start/end dates and the parent Pratyantardasha period details.
14385
15478
  */
14386
15479
  200: {
15480
+ /**
15481
+ * What each house MEANS, keyed by house number 1 to 12, in the requested language. Turns a house list into words without the client writing any interpretation copy: for a period signifying houses 2, 7 and 8, join houseThemes for those keys to render the "nature" line of a KP dasha table. Sent once per response rather than repeated on every period, so look the houses up from signifiedHouses or strongHouses. Localized by the lang query, like every other interpretation field.
15482
+ */
15483
+ houseThemes?: {
15484
+ [key: string]: Array<string>;
15485
+ };
14387
15486
  /**
14388
15487
  * Ruling planet of the requested Mahadasha period.
14389
15488
  */
@@ -14392,6 +15491,10 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses = {
14392
15491
  * Ruling planet of the requested Antardasha sub-period.
14393
15492
  */
14394
15493
  antardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15494
+ /**
15495
+ * Ruling planet of the requested Pratyantardasha sub-sub-period.
15496
+ */
15497
+ pratyantardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14395
15498
  /**
14396
15499
  * Sidereal (nirayana) longitude of the birth Moon in degrees, 0 to 360, measured in the ayanamsa frame reported below. This single value determines the birth nakshatra and therefore every dasha start and end date in this response. Compare it against a reference chart to reconcile any date difference at its source.
14397
15500
  */
@@ -14405,9 +15508,9 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses = {
14405
15508
  */
14406
15509
  ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri';
14407
15510
  /**
14408
- * Full details of the parent Antardasha including start/end dates and duration.
15511
+ * Full details of the parent Pratyantardasha including start/end dates and duration.
14409
15512
  */
14410
- antardashaPeriod: {
15513
+ pratyantardashaPeriod: {
14411
15514
  /**
14412
15515
  * Ruling graha of this Vimshottari dasha period. One of 9 planets in the Ketu-Venus-Sun-Moon-Mars-Rahu-Jupiter-Saturn-Mercury sequence.
14413
15516
  */
@@ -14432,15 +15535,82 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses = {
14432
15535
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
14433
15536
  */
14434
15537
  interpretation?: string;
15538
+ /**
15539
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
15540
+ */
15541
+ significators?: {
15542
+ /**
15543
+ * House 1-12 this lord occupies in the Placidus birth chart. Its own Level 2 signification, repeated here because the occupied house is the first thing a KP reading looks at.
15544
+ */
15545
+ house: number;
15546
+ /**
15547
+ * Lord of the nakshatra this planet sits in, one of the 9 grahas. In KP the star lord outranks the planet itself: a period lord mainly delivers the houses its star lord occupies and owns, which is why those appear at L1 and L3 rather than the planet own house.
15548
+ */
15549
+ starLord: string;
15550
+ /**
15551
+ * KP sub lord of this planet, the 1 of 249 subdivision its longitude falls in, one of the 9 grahas. The star lord says WHAT results the period gives, the sub lord says WHETHER they materialize, so KP judgement checks both.
15552
+ */
15553
+ subLord?: string;
15554
+ /**
15555
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
15556
+ */
15557
+ signifies: {
15558
+ /**
15559
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
15560
+ */
15561
+ L1: Array<number>;
15562
+ /**
15563
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
15564
+ */
15565
+ L2: Array<number>;
15566
+ /**
15567
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
15568
+ */
15569
+ L3: Array<number>;
15570
+ /**
15571
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
15572
+ */
15573
+ L4: Array<number>;
15574
+ };
15575
+ /**
15576
+ * Every house this lord signifies, deduplicated and ordered strongest tier first. Where a house is reached at more than one level it is listed once, at its strongest. This is the flat "houses signified" column of a KP dasha table.
15577
+ */
15578
+ signifiedHouses: Array<number>;
15579
+ /**
15580
+ * Subset of signifiedHouses reached at grade A or B (levels L1 and L2). These are the houses a KP reading acts on for this period; the rest are supporting connections.
15581
+ */
15582
+ strongHouses: Array<number>;
15583
+ /**
15584
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
15585
+ */
15586
+ strength: {
15587
+ /**
15588
+ * Mean KP percentage weight across signifiedHouses, each house counted at its strongest level (A 100, B 75, C 50, D 25). A mean rather than a total, so signifying many houses weakly does not outrank signifying two houses at grade A.
15589
+ */
15590
+ score: number;
15591
+ /**
15592
+ * Band the score falls in, on the standard KP significator grading: A planets in the constellation of the occupant, B occupants, C planets in the constellation of the house owner, D the house owner. Band edges are the midpoints between the four weights.
15593
+ */
15594
+ grade: 'A' | 'B' | 'C' | 'D';
15595
+ /**
15596
+ * Plain-language form of grade: "very-strong" for A, "strong" for B, "moderate" for C, "weak" for D. Says how firmly this lord is connected to the houses it signifies, NOT whether those houses are favourable, which depends on the matter being judged.
15597
+ */
15598
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
15599
+ };
15600
+ };
14435
15601
  /**
14436
15602
  * Parent Mahadasha lord under which this Antardasha sub-period runs.
14437
15603
  */
14438
15604
  mahadashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15605
+ /**
15606
+ * Parent Antardasha lord under which this Pratyantardasha runs.
15607
+ */
15608
+ antardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14439
15609
  };
14440
15610
  /**
14441
- * Pratyantardasha (antara) periods within this Antardasha, proportional to each planet Vimshottari years, sorted chronologically and starting with the Antardasha lord. Fewer than nine only when the parent Antardasha is the one that was already running at birth, in which case the periods that ended before the birth date are omitted.
15611
+ * Sookshma dasha periods within this Pratyantardasha, proportional to each planet Vimshottari years, sorted chronologically and starting with the Pratyantardasha lord. Fewer than nine only when the parent Pratyantardasha is the one that was already running at birth, in which case the periods that ended before the birth date are omitted.
14442
15612
  */
14443
- pratyantardashas: Array<{
15613
+ sookshmaDashas: Array<{
14444
15614
  /**
14445
15615
  * Ruling graha of this Vimshottari dasha period. One of 9 planets in the Ketu-Venus-Sun-Moon-Mars-Rahu-Jupiter-Saturn-Mercury sequence.
14446
15616
  */
@@ -14465,6 +15635,69 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses = {
14465
15635
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
14466
15636
  */
14467
15637
  interpretation?: string;
15638
+ /**
15639
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
15640
+ */
15641
+ significators?: {
15642
+ /**
15643
+ * House 1-12 this lord occupies in the Placidus birth chart. Its own Level 2 signification, repeated here because the occupied house is the first thing a KP reading looks at.
15644
+ */
15645
+ house: number;
15646
+ /**
15647
+ * Lord of the nakshatra this planet sits in, one of the 9 grahas. In KP the star lord outranks the planet itself: a period lord mainly delivers the houses its star lord occupies and owns, which is why those appear at L1 and L3 rather than the planet own house.
15648
+ */
15649
+ starLord: string;
15650
+ /**
15651
+ * KP sub lord of this planet, the 1 of 249 subdivision its longitude falls in, one of the 9 grahas. The star lord says WHAT results the period gives, the sub lord says WHETHER they materialize, so KP judgement checks both.
15652
+ */
15653
+ subLord?: string;
15654
+ /**
15655
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
15656
+ */
15657
+ signifies: {
15658
+ /**
15659
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
15660
+ */
15661
+ L1: Array<number>;
15662
+ /**
15663
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
15664
+ */
15665
+ L2: Array<number>;
15666
+ /**
15667
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
15668
+ */
15669
+ L3: Array<number>;
15670
+ /**
15671
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
15672
+ */
15673
+ L4: Array<number>;
15674
+ };
15675
+ /**
15676
+ * Every house this lord signifies, deduplicated and ordered strongest tier first. Where a house is reached at more than one level it is listed once, at its strongest. This is the flat "houses signified" column of a KP dasha table.
15677
+ */
15678
+ signifiedHouses: Array<number>;
15679
+ /**
15680
+ * Subset of signifiedHouses reached at grade A or B (levels L1 and L2). These are the houses a KP reading acts on for this period; the rest are supporting connections.
15681
+ */
15682
+ strongHouses: Array<number>;
15683
+ /**
15684
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
15685
+ */
15686
+ strength: {
15687
+ /**
15688
+ * Mean KP percentage weight across signifiedHouses, each house counted at its strongest level (A 100, B 75, C 50, D 25). A mean rather than a total, so signifying many houses weakly does not outrank signifying two houses at grade A.
15689
+ */
15690
+ score: number;
15691
+ /**
15692
+ * Band the score falls in, on the standard KP significator grading: A planets in the constellation of the occupant, B occupants, C planets in the constellation of the house owner, D the house owner. Band edges are the midpoints between the four weights.
15693
+ */
15694
+ grade: 'A' | 'B' | 'C' | 'D';
15695
+ /**
15696
+ * Plain-language form of grade: "very-strong" for A, "strong" for B, "moderate" for C, "weak" for D. Says how firmly this lord is connected to the houses it signifies, NOT whether those houses are favourable, which depends on the matter being judged.
15697
+ */
15698
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
15699
+ };
15700
+ };
14468
15701
  /**
14469
15702
  * Parent Mahadasha lord under which this Antardasha sub-period runs.
14470
15703
  */
@@ -14473,13 +15706,17 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses = {
14473
15706
  * Parent Antardasha lord under which this Pratyantardasha runs.
14474
15707
  */
14475
15708
  antardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15709
+ /**
15710
+ * Parent Pratyantardasha lord under which this Sookshma dasha runs.
15711
+ */
15712
+ pratyantardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14476
15713
  }>;
14477
15714
  };
14478
15715
  };
14479
15716
 
14480
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponse = PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses];
15717
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaResponse = PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaResponses[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaResponses];
14481
15718
 
14482
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaData = {
15719
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaData = {
14483
15720
  body?: {
14484
15721
  /**
14485
15722
  * 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).
@@ -14505,6 +15742,14 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaDa
14505
15742
  * 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. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses.
14506
15743
  */
14507
15744
  ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri';
15745
+ /**
15746
+ * Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above.
15747
+ */
15748
+ significators?: boolean;
15749
+ /**
15750
+ * Lunar node type for Rahu and Ketu, used ONLY when "significators" is true. Dasha dates themselves come from the Moon and never move with this field. "mean" uses the smooth mean node (traditional default). "true" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to "mean".
15751
+ */
15752
+ nodeType?: 'mean' | 'true';
14508
15753
  };
14509
15754
  path: {
14510
15755
  /**
@@ -14519,6 +15764,10 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaDa
14519
15764
  * Pratyantardasha (antara) planet name inside that Antardasha, case-insensitive.
14520
15765
  */
14521
15766
  pratyantardasha: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15767
+ /**
15768
+ * Sookshma dasha planet name inside that Pratyantardasha, case-insensitive. Every full period contains all 9 lords, so a repeat such as saturn/saturn/saturn/saturn is valid.
15769
+ */
15770
+ sookshma: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14522
15771
  };
14523
15772
  query?: {
14524
15773
  /**
@@ -14526,10 +15775,10 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaDa
14526
15775
  */
14527
15776
  lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
14528
15777
  };
14529
- url: '/vedic-astrology/dasha/sub/{mahadasha}/{antardasha}/{pratyantardasha}';
15778
+ url: '/vedic-astrology/dasha/sub/{mahadasha}/{antardasha}/{pratyantardasha}/{sookshma}';
14530
15779
  };
14531
15780
 
14532
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaErrors = {
15781
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaErrors = {
14533
15782
  /**
14534
15783
  * Validation error. `issues[]` lists every failed field.
14535
15784
  */
@@ -14631,13 +15880,19 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaEr
14631
15880
  };
14632
15881
  };
14633
15882
 
14634
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaError = PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaErrors[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaErrors];
15883
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaError = PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaErrors[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaErrors];
14635
15884
 
14636
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaResponses = {
15885
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaResponses = {
14637
15886
  /**
14638
- * All 9 Sookshma dasha periods within the specified Mahadasha, Antardasha, and Pratyantardasha, with start/end dates and the parent Pratyantardasha period details.
15887
+ * All 9 Prana dasha periods within the specified Mahadasha, Antardasha, Pratyantardasha, and Sookshma dasha, with start/end dates and the parent Sookshma period details.
14639
15888
  */
14640
15889
  200: {
15890
+ /**
15891
+ * What each house MEANS, keyed by house number 1 to 12, in the requested language. Turns a house list into words without the client writing any interpretation copy: for a period signifying houses 2, 7 and 8, join houseThemes for those keys to render the "nature" line of a KP dasha table. Sent once per response rather than repeated on every period, so look the houses up from signifiedHouses or strongHouses. Localized by the lang query, like every other interpretation field.
15892
+ */
15893
+ houseThemes?: {
15894
+ [key: string]: Array<string>;
15895
+ };
14641
15896
  /**
14642
15897
  * Ruling planet of the requested Mahadasha period.
14643
15898
  */
@@ -14650,6 +15905,10 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaRe
14650
15905
  * Ruling planet of the requested Pratyantardasha sub-sub-period.
14651
15906
  */
14652
15907
  pratyantardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15908
+ /**
15909
+ * Ruling planet of the requested Sookshma dasha.
15910
+ */
15911
+ sookshmaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14653
15912
  /**
14654
15913
  * Sidereal (nirayana) longitude of the birth Moon in degrees, 0 to 360, measured in the ayanamsa frame reported below. This single value determines the birth nakshatra and therefore every dasha start and end date in this response. Compare it against a reference chart to reconcile any date difference at its source.
14655
15914
  */
@@ -14663,9 +15922,9 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaRe
14663
15922
  */
14664
15923
  ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri';
14665
15924
  /**
14666
- * Full details of the parent Pratyantardasha including start/end dates and duration.
15925
+ * Full details of the parent Sookshma dasha including start/end dates and duration.
14667
15926
  */
14668
- pratyantardashaPeriod: {
15927
+ sookshmaPeriod: {
14669
15928
  /**
14670
15929
  * Ruling graha of this Vimshottari dasha period. One of 9 planets in the Ketu-Venus-Sun-Moon-Mars-Rahu-Jupiter-Saturn-Mercury sequence.
14671
15930
  */
@@ -14690,6 +15949,69 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaRe
14690
15949
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
14691
15950
  */
14692
15951
  interpretation?: string;
15952
+ /**
15953
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
15954
+ */
15955
+ significators?: {
15956
+ /**
15957
+ * House 1-12 this lord occupies in the Placidus birth chart. Its own Level 2 signification, repeated here because the occupied house is the first thing a KP reading looks at.
15958
+ */
15959
+ house: number;
15960
+ /**
15961
+ * Lord of the nakshatra this planet sits in, one of the 9 grahas. In KP the star lord outranks the planet itself: a period lord mainly delivers the houses its star lord occupies and owns, which is why those appear at L1 and L3 rather than the planet own house.
15962
+ */
15963
+ starLord: string;
15964
+ /**
15965
+ * KP sub lord of this planet, the 1 of 249 subdivision its longitude falls in, one of the 9 grahas. The star lord says WHAT results the period gives, the sub lord says WHETHER they materialize, so KP judgement checks both.
15966
+ */
15967
+ subLord?: string;
15968
+ /**
15969
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
15970
+ */
15971
+ signifies: {
15972
+ /**
15973
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
15974
+ */
15975
+ L1: Array<number>;
15976
+ /**
15977
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
15978
+ */
15979
+ L2: Array<number>;
15980
+ /**
15981
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
15982
+ */
15983
+ L3: Array<number>;
15984
+ /**
15985
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
15986
+ */
15987
+ L4: Array<number>;
15988
+ };
15989
+ /**
15990
+ * Every house this lord signifies, deduplicated and ordered strongest tier first. Where a house is reached at more than one level it is listed once, at its strongest. This is the flat "houses signified" column of a KP dasha table.
15991
+ */
15992
+ signifiedHouses: Array<number>;
15993
+ /**
15994
+ * Subset of signifiedHouses reached at grade A or B (levels L1 and L2). These are the houses a KP reading acts on for this period; the rest are supporting connections.
15995
+ */
15996
+ strongHouses: Array<number>;
15997
+ /**
15998
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
15999
+ */
16000
+ strength: {
16001
+ /**
16002
+ * Mean KP percentage weight across signifiedHouses, each house counted at its strongest level (A 100, B 75, C 50, D 25). A mean rather than a total, so signifying many houses weakly does not outrank signifying two houses at grade A.
16003
+ */
16004
+ score: number;
16005
+ /**
16006
+ * Band the score falls in, on the standard KP significator grading: A planets in the constellation of the occupant, B occupants, C planets in the constellation of the house owner, D the house owner. Band edges are the midpoints between the four weights.
16007
+ */
16008
+ grade: 'A' | 'B' | 'C' | 'D';
16009
+ /**
16010
+ * Plain-language form of grade: "very-strong" for A, "strong" for B, "moderate" for C, "weak" for D. Says how firmly this lord is connected to the houses it signifies, NOT whether those houses are favourable, which depends on the matter being judged.
16011
+ */
16012
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
16013
+ };
16014
+ };
14693
16015
  /**
14694
16016
  * Parent Mahadasha lord under which this Antardasha sub-period runs.
14695
16017
  */
@@ -14698,11 +16020,15 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaRe
14698
16020
  * Parent Antardasha lord under which this Pratyantardasha runs.
14699
16021
  */
14700
16022
  antardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
16023
+ /**
16024
+ * Parent Pratyantardasha lord under which this Sookshma dasha runs.
16025
+ */
16026
+ pratyantardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14701
16027
  };
14702
16028
  /**
14703
- * Sookshma dasha periods within this Pratyantardasha, proportional to each planet Vimshottari years, sorted chronologically and starting with the Pratyantardasha lord. Fewer than nine only when the parent Pratyantardasha is the one that was already running at birth, in which case the periods that ended before the birth date are omitted.
16029
+ * Prana dasha periods within this Sookshma dasha, proportional to each planet Vimshottari years, sorted chronologically and starting with the Sookshma lord. Fewer than nine only when the parent Sookshma dasha is the one that was already running at birth, in which case the periods that ended before the birth date are omitted.
14704
16030
  */
14705
- sookshmaDashas: Array<{
16031
+ pranaDashas: Array<{
14706
16032
  /**
14707
16033
  * Ruling graha of this Vimshottari dasha period. One of 9 planets in the Ketu-Venus-Sun-Moon-Mars-Rahu-Jupiter-Saturn-Mercury sequence.
14708
16034
  */
@@ -14727,6 +16053,69 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaRe
14727
16053
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
14728
16054
  */
14729
16055
  interpretation?: string;
16056
+ /**
16057
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
16058
+ */
16059
+ significators?: {
16060
+ /**
16061
+ * House 1-12 this lord occupies in the Placidus birth chart. Its own Level 2 signification, repeated here because the occupied house is the first thing a KP reading looks at.
16062
+ */
16063
+ house: number;
16064
+ /**
16065
+ * Lord of the nakshatra this planet sits in, one of the 9 grahas. In KP the star lord outranks the planet itself: a period lord mainly delivers the houses its star lord occupies and owns, which is why those appear at L1 and L3 rather than the planet own house.
16066
+ */
16067
+ starLord: string;
16068
+ /**
16069
+ * KP sub lord of this planet, the 1 of 249 subdivision its longitude falls in, one of the 9 grahas. The star lord says WHAT results the period gives, the sub lord says WHETHER they materialize, so KP judgement checks both.
16070
+ */
16071
+ subLord?: string;
16072
+ /**
16073
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
16074
+ */
16075
+ signifies: {
16076
+ /**
16077
+ * Level 1, the strongest signification (grade A). Houses influenced because this planet sits in the nakshatra (star) of a planet occupying those houses. For Rahu and Ketu, also includes the L1 houses of their agent planets (conjoined, aspecting, sign lord).
16078
+ */
16079
+ L1: Array<number>;
16080
+ /**
16081
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
16082
+ */
16083
+ L2: Array<number>;
16084
+ /**
16085
+ * Level 3 (grade C). Houses influenced because this planet sits in the nakshatra of the sign lord (owner) of those houses. For Rahu and Ketu, also includes the L3 houses of their agent planets.
16086
+ */
16087
+ L3: Array<number>;
16088
+ /**
16089
+ * Level 4, the weakest signification (grade D). Houses this planet rules by zodiac sign ownership, up to 2 for Sun through Saturn and 3 where a sign is intercepted. Rahu and Ketu own no sign, so their L4 comes entirely from their agent planets.
16090
+ */
16091
+ L4: Array<number>;
16092
+ };
16093
+ /**
16094
+ * Every house this lord signifies, deduplicated and ordered strongest tier first. Where a house is reached at more than one level it is listed once, at its strongest. This is the flat "houses signified" column of a KP dasha table.
16095
+ */
16096
+ signifiedHouses: Array<number>;
16097
+ /**
16098
+ * Subset of signifiedHouses reached at grade A or B (levels L1 and L2). These are the houses a KP reading acts on for this period; the rest are supporting connections.
16099
+ */
16100
+ strongHouses: Array<number>;
16101
+ /**
16102
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
16103
+ */
16104
+ strength: {
16105
+ /**
16106
+ * Mean KP percentage weight across signifiedHouses, each house counted at its strongest level (A 100, B 75, C 50, D 25). A mean rather than a total, so signifying many houses weakly does not outrank signifying two houses at grade A.
16107
+ */
16108
+ score: number;
16109
+ /**
16110
+ * Band the score falls in, on the standard KP significator grading: A planets in the constellation of the occupant, B occupants, C planets in the constellation of the house owner, D the house owner. Band edges are the midpoints between the four weights.
16111
+ */
16112
+ grade: 'A' | 'B' | 'C' | 'D';
16113
+ /**
16114
+ * Plain-language form of grade: "very-strong" for A, "strong" for B, "moderate" for C, "weak" for D. Says how firmly this lord is connected to the houses it signifies, NOT whether those houses are favourable, which depends on the matter being judged.
16115
+ */
16116
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
16117
+ };
16118
+ };
14730
16119
  /**
14731
16120
  * Parent Mahadasha lord under which this Antardasha sub-period runs.
14732
16121
  */
@@ -14739,11 +16128,15 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaRe
14739
16128
  * Parent Pratyantardasha lord under which this Sookshma dasha runs.
14740
16129
  */
14741
16130
  pratyantardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
16131
+ /**
16132
+ * Parent Sookshma dasha lord under which this Prana dasha runs.
16133
+ */
16134
+ sookshmaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14742
16135
  }>;
14743
16136
  };
14744
16137
  };
14745
16138
 
14746
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaResponse = PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaResponses[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaResponses];
16139
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaResponse = PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaResponses[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaResponses];
14747
16140
 
14748
16141
  export type PostVedicAstrologyPanchangBasicData = {
14749
16142
  body?: {
@@ -15019,7 +16412,7 @@ export type PostVedicAstrologyPanchangDetailedData = {
15019
16412
  */
15020
16413
  longitude: number;
15021
16414
  /**
15022
- * Timezone offset from UTC in decimal hours. Used for sunrise/sunset/moonrise/moonset search accuracy and output time formatting. Essential for correct results outside IST. Defaults to 5.5 (IST).
16415
+ * Timezone offset from UTC in decimal hours, for example -5 for New York or 9 for Tokyo. Send the offset that matches the coordinates: sunrise, sunset and every muhurta boundary are found by searching forward from local midnight, so the default anchors the search to an Indian day. Omitting it for a location outside IST returns a correctly ordered set of periods for the wrong window, shifted by the difference between 5.5 and the real offset. Defaults to 5.5 (IST).
15023
16416
  */
15024
16417
  timezone?: number | string;
15025
16418
  };