@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.
@@ -4380,19 +4380,19 @@ export type KpRulingPlanetsIntervalResponse = {
4380
4380
  */
4381
4381
  moonSignLordSignifies: {
4382
4382
  /**
4383
- * 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).
4383
+ * 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).
4384
4384
  */
4385
4385
  L1: Array<number>;
4386
4386
  /**
4387
- * 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).
4387
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
4388
4388
  */
4389
4389
  L2: Array<number>;
4390
4390
  /**
4391
- * 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.
4391
+ * 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.
4392
4392
  */
4393
4393
  L3: Array<number>;
4394
4394
  /**
4395
- * 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).
4395
+ * 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.
4396
4396
  */
4397
4397
  L4: Array<number>;
4398
4398
  };
@@ -4401,19 +4401,19 @@ export type KpRulingPlanetsIntervalResponse = {
4401
4401
  */
4402
4402
  moonStarLordSignifies: {
4403
4403
  /**
4404
- * 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).
4404
+ * 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).
4405
4405
  */
4406
4406
  L1: Array<number>;
4407
4407
  /**
4408
- * 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).
4408
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
4409
4409
  */
4410
4410
  L2: Array<number>;
4411
4411
  /**
4412
- * 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.
4412
+ * 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.
4413
4413
  */
4414
4414
  L3: Array<number>;
4415
4415
  /**
4416
- * 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).
4416
+ * 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.
4417
4417
  */
4418
4418
  L4: Array<number>;
4419
4419
  };
@@ -4422,19 +4422,19 @@ export type KpRulingPlanetsIntervalResponse = {
4422
4422
  */
4423
4423
  moonSublordSignifies: {
4424
4424
  /**
4425
- * 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).
4425
+ * 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).
4426
4426
  */
4427
4427
  L1: Array<number>;
4428
4428
  /**
4429
- * 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).
4429
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
4430
4430
  */
4431
4431
  L2: Array<number>;
4432
4432
  /**
4433
- * 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.
4433
+ * 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.
4434
4434
  */
4435
4435
  L3: Array<number>;
4436
4436
  /**
4437
- * 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).
4437
+ * 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.
4438
4438
  */
4439
4439
  L4: Array<number>;
4440
4440
  };
@@ -4443,19 +4443,19 @@ export type KpRulingPlanetsIntervalResponse = {
4443
4443
  */
4444
4444
  moonSignifies: {
4445
4445
  /**
4446
- * 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).
4446
+ * 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).
4447
4447
  */
4448
4448
  L1: Array<number>;
4449
4449
  /**
4450
- * 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).
4450
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
4451
4451
  */
4452
4452
  L2: Array<number>;
4453
4453
  /**
4454
- * 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.
4454
+ * 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.
4455
4455
  */
4456
4456
  L3: Array<number>;
4457
4457
  /**
4458
- * 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).
4458
+ * 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.
4459
4459
  */
4460
4460
  L4: Array<number>;
4461
4461
  };
@@ -7176,6 +7176,10 @@ export type GetAstrologyMoonPhaseCalendarByYearByMonthResponses = {
7176
7176
  * Calendar month for this lunar calendar.
7177
7177
  */
7178
7178
  month: number;
7179
+ /**
7180
+ * 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.
7181
+ */
7182
+ monthName: string;
7179
7183
  /**
7180
7184
  * Daily moon phase and illumination for every day of the month.
7181
7185
  */
@@ -7372,7 +7376,7 @@ export type PostAstrologySynastryResponses = {
7372
7376
  */
7373
7377
  200: {
7374
7378
  /**
7375
- * Person 1 chart highlights: Ascendant, Sun sign, and Moon sign.
7379
+ * Person 1 chart highlights: Ascendant, Sun sign, Moon sign, and plotting positions.
7376
7380
  */
7377
7381
  person1: {
7378
7382
  /**
@@ -7400,9 +7404,38 @@ export type PostAstrologySynastryResponses = {
7400
7404
  * Moon sign of this person. Emotional nature and inner needs.
7401
7405
  */
7402
7406
  moonSign: string;
7407
+ /**
7408
+ * 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.
7409
+ */
7410
+ planets: Array<{
7411
+ /**
7412
+ * Planet or point name. Matches the names used in interAspects.
7413
+ */
7414
+ name: string;
7415
+ /**
7416
+ * Ecliptic longitude in degrees (0-360) measured from 0 Aries. This is the value a wheel plots.
7417
+ */
7418
+ longitude: number;
7419
+ /**
7420
+ * Zodiac sign containing the planet.
7421
+ */
7422
+ sign: string;
7423
+ /**
7424
+ * Degree within the sign (0-29.999).
7425
+ */
7426
+ degree: number;
7427
+ /**
7428
+ * House this planet occupies in the person 1 chart (1-12).
7429
+ */
7430
+ house: number;
7431
+ /**
7432
+ * True when the planet is retrograde at this moment.
7433
+ */
7434
+ isRetrograde: boolean;
7435
+ }>;
7403
7436
  };
7404
7437
  /**
7405
- * Person 2 chart highlights: Ascendant, Sun sign, and Moon sign.
7438
+ * Person 2 chart highlights: Ascendant, Sun sign, Moon sign, and plotting positions.
7406
7439
  */
7407
7440
  person2: {
7408
7441
  /**
@@ -7410,7 +7443,7 @@ export type PostAstrologySynastryResponses = {
7410
7443
  */
7411
7444
  name?: string;
7412
7445
  /**
7413
- * Ascendant position for person 2.
7446
+ * Ascendant position for person 2. Determines first house cusp and outward personality.
7414
7447
  */
7415
7448
  ascendant: {
7416
7449
  /**
@@ -7423,13 +7456,42 @@ export type PostAstrologySynastryResponses = {
7423
7456
  degree: number;
7424
7457
  };
7425
7458
  /**
7426
- * Sun sign of this person.
7459
+ * Sun sign (zodiac sign) of this person. Core identity and ego expression.
7427
7460
  */
7428
7461
  sunSign: string;
7429
7462
  /**
7430
- * Moon sign of this person.
7463
+ * Moon sign of this person. Emotional nature and inner needs.
7431
7464
  */
7432
7465
  moonSign: string;
7466
+ /**
7467
+ * 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.
7468
+ */
7469
+ planets: Array<{
7470
+ /**
7471
+ * Planet or point name. Matches the names used in interAspects.
7472
+ */
7473
+ name: string;
7474
+ /**
7475
+ * Ecliptic longitude in degrees (0-360) measured from 0 Aries. This is the value a wheel plots.
7476
+ */
7477
+ longitude: number;
7478
+ /**
7479
+ * Zodiac sign containing the planet.
7480
+ */
7481
+ sign: string;
7482
+ /**
7483
+ * Degree within the sign (0-29.999).
7484
+ */
7485
+ degree: number;
7486
+ /**
7487
+ * House this planet occupies in the person 2 chart (1-12).
7488
+ */
7489
+ house: number;
7490
+ /**
7491
+ * True when the planet is retrograde at this moment.
7492
+ */
7493
+ isRetrograde: boolean;
7494
+ }>;
7433
7495
  };
7434
7496
  /**
7435
7497
  * Overall compatibility score (0-100). Calculated from the balance of harmonious vs challenging inter-chart aspects weighted by planet importance.
@@ -10613,6 +10675,10 @@ export type GetAstrologyHoroscopeBySignMonthlyResponses = {
10613
10675
  * Monthly financial outlook and guidance.
10614
10676
  */
10615
10677
  finance: string;
10678
+ /**
10679
+ * 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.
10680
+ */
10681
+ advice: string;
10616
10682
  /**
10617
10683
  * Week-by-week breakdown with sign-specific focus areas based on transit house positions.
10618
10684
  */
@@ -13114,6 +13180,14 @@ export type PostVedicAstrologyDashaCurrentData = {
13114
13180
  * 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.
13115
13181
  */
13116
13182
  ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri';
13183
+ /**
13184
+ * 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.
13185
+ */
13186
+ significators?: boolean;
13187
+ /**
13188
+ * 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".
13189
+ */
13190
+ nodeType?: 'mean' | 'true';
13117
13191
  };
13118
13192
  path?: never;
13119
13193
  query?: {
@@ -13228,9 +13302,15 @@ export type PostVedicAstrologyDashaCurrentErrors = {
13228
13302
  export type PostVedicAstrologyDashaCurrentError = PostVedicAstrologyDashaCurrentErrors[keyof PostVedicAstrologyDashaCurrentErrors];
13229
13303
  export type PostVedicAstrologyDashaCurrentResponses = {
13230
13304
  /**
13231
- * Currently active Mahadasha, Antardasha, Pratyantardasha, and Sookshma dasha with start/end dates, remaining balance, Moon nakshatra, and Vedic interpretations for each period.
13305
+ * Currently active Mahadasha, Antardasha, Pratyantardasha, Sookshma and Prana dasha with start/end dates, remaining balance, Moon nakshatra, and Vedic interpretations for each period.
13232
13306
  */
13233
13307
  200: {
13308
+ /**
13309
+ * 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.
13310
+ */
13311
+ houseThemes?: {
13312
+ [key: string]: Array<string>;
13313
+ };
13234
13314
  /**
13235
13315
  * Birth Moon nakshatra number (1-27). This nakshatra determines the starting dasha lord in the Vimshottari 120-year cycle.
13236
13316
  */
@@ -13283,6 +13363,69 @@ export type PostVedicAstrologyDashaCurrentResponses = {
13283
13363
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
13284
13364
  */
13285
13365
  interpretation?: string;
13366
+ /**
13367
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
13368
+ */
13369
+ significators?: {
13370
+ /**
13371
+ * 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.
13372
+ */
13373
+ house: number;
13374
+ /**
13375
+ * 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.
13376
+ */
13377
+ starLord: string;
13378
+ /**
13379
+ * 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.
13380
+ */
13381
+ subLord?: string;
13382
+ /**
13383
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
13384
+ */
13385
+ signifies: {
13386
+ /**
13387
+ * 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).
13388
+ */
13389
+ L1: Array<number>;
13390
+ /**
13391
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
13392
+ */
13393
+ L2: Array<number>;
13394
+ /**
13395
+ * 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.
13396
+ */
13397
+ L3: Array<number>;
13398
+ /**
13399
+ * 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.
13400
+ */
13401
+ L4: Array<number>;
13402
+ };
13403
+ /**
13404
+ * 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.
13405
+ */
13406
+ signifiedHouses: Array<number>;
13407
+ /**
13408
+ * 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.
13409
+ */
13410
+ strongHouses: Array<number>;
13411
+ /**
13412
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
13413
+ */
13414
+ strength: {
13415
+ /**
13416
+ * 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.
13417
+ */
13418
+ score: number;
13419
+ /**
13420
+ * 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.
13421
+ */
13422
+ grade: 'A' | 'B' | 'C' | 'D';
13423
+ /**
13424
+ * 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.
13425
+ */
13426
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
13427
+ };
13428
+ };
13286
13429
  };
13287
13430
  /**
13288
13431
  * Antardasha (bhukti), sub-period within a Mahadasha. Each Mahadasha contains 9 Antardashas proportional to the Vimshottari years of each planet.
@@ -13312,6 +13455,69 @@ export type PostVedicAstrologyDashaCurrentResponses = {
13312
13455
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
13313
13456
  */
13314
13457
  interpretation?: string;
13458
+ /**
13459
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
13460
+ */
13461
+ significators?: {
13462
+ /**
13463
+ * 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.
13464
+ */
13465
+ house: number;
13466
+ /**
13467
+ * 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.
13468
+ */
13469
+ starLord: string;
13470
+ /**
13471
+ * 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.
13472
+ */
13473
+ subLord?: string;
13474
+ /**
13475
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
13476
+ */
13477
+ signifies: {
13478
+ /**
13479
+ * 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).
13480
+ */
13481
+ L1: Array<number>;
13482
+ /**
13483
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
13484
+ */
13485
+ L2: Array<number>;
13486
+ /**
13487
+ * 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.
13488
+ */
13489
+ L3: Array<number>;
13490
+ /**
13491
+ * 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.
13492
+ */
13493
+ L4: Array<number>;
13494
+ };
13495
+ /**
13496
+ * 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.
13497
+ */
13498
+ signifiedHouses: Array<number>;
13499
+ /**
13500
+ * 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.
13501
+ */
13502
+ strongHouses: Array<number>;
13503
+ /**
13504
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
13505
+ */
13506
+ strength: {
13507
+ /**
13508
+ * 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.
13509
+ */
13510
+ score: number;
13511
+ /**
13512
+ * 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.
13513
+ */
13514
+ grade: 'A' | 'B' | 'C' | 'D';
13515
+ /**
13516
+ * 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.
13517
+ */
13518
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
13519
+ };
13520
+ };
13315
13521
  /**
13316
13522
  * Parent Mahadasha lord under which this Antardasha sub-period runs.
13317
13523
  */
@@ -13345,6 +13551,69 @@ export type PostVedicAstrologyDashaCurrentResponses = {
13345
13551
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
13346
13552
  */
13347
13553
  interpretation?: string;
13554
+ /**
13555
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
13556
+ */
13557
+ significators?: {
13558
+ /**
13559
+ * 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.
13560
+ */
13561
+ house: number;
13562
+ /**
13563
+ * 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.
13564
+ */
13565
+ starLord: string;
13566
+ /**
13567
+ * 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.
13568
+ */
13569
+ subLord?: string;
13570
+ /**
13571
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
13572
+ */
13573
+ signifies: {
13574
+ /**
13575
+ * 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).
13576
+ */
13577
+ L1: Array<number>;
13578
+ /**
13579
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
13580
+ */
13581
+ L2: Array<number>;
13582
+ /**
13583
+ * 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.
13584
+ */
13585
+ L3: Array<number>;
13586
+ /**
13587
+ * 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.
13588
+ */
13589
+ L4: Array<number>;
13590
+ };
13591
+ /**
13592
+ * 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.
13593
+ */
13594
+ signifiedHouses: Array<number>;
13595
+ /**
13596
+ * 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.
13597
+ */
13598
+ strongHouses: Array<number>;
13599
+ /**
13600
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
13601
+ */
13602
+ strength: {
13603
+ /**
13604
+ * 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.
13605
+ */
13606
+ score: number;
13607
+ /**
13608
+ * 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.
13609
+ */
13610
+ grade: 'A' | 'B' | 'C' | 'D';
13611
+ /**
13612
+ * 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.
13613
+ */
13614
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
13615
+ };
13616
+ };
13348
13617
  /**
13349
13618
  * Parent Mahadasha lord under which this Antardasha sub-period runs.
13350
13619
  */
@@ -13355,7 +13624,7 @@ export type PostVedicAstrologyDashaCurrentResponses = {
13355
13624
  antardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
13356
13625
  };
13357
13626
  /**
13358
- * 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.
13627
+ * 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.
13359
13628
  */
13360
13629
  sookshmaDasha: {
13361
13630
  /**
@@ -13382,6 +13651,69 @@ export type PostVedicAstrologyDashaCurrentResponses = {
13382
13651
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
13383
13652
  */
13384
13653
  interpretation?: string;
13654
+ /**
13655
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
13656
+ */
13657
+ significators?: {
13658
+ /**
13659
+ * 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.
13660
+ */
13661
+ house: number;
13662
+ /**
13663
+ * 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.
13664
+ */
13665
+ starLord: string;
13666
+ /**
13667
+ * 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.
13668
+ */
13669
+ subLord?: string;
13670
+ /**
13671
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
13672
+ */
13673
+ signifies: {
13674
+ /**
13675
+ * 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).
13676
+ */
13677
+ L1: Array<number>;
13678
+ /**
13679
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
13680
+ */
13681
+ L2: Array<number>;
13682
+ /**
13683
+ * 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.
13684
+ */
13685
+ L3: Array<number>;
13686
+ /**
13687
+ * 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.
13688
+ */
13689
+ L4: Array<number>;
13690
+ };
13691
+ /**
13692
+ * 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.
13693
+ */
13694
+ signifiedHouses: Array<number>;
13695
+ /**
13696
+ * 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.
13697
+ */
13698
+ strongHouses: Array<number>;
13699
+ /**
13700
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
13701
+ */
13702
+ strength: {
13703
+ /**
13704
+ * 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.
13705
+ */
13706
+ score: number;
13707
+ /**
13708
+ * 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.
13709
+ */
13710
+ grade: 'A' | 'B' | 'C' | 'D';
13711
+ /**
13712
+ * 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.
13713
+ */
13714
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
13715
+ };
13716
+ };
13385
13717
  /**
13386
13718
  * Parent Mahadasha lord under which this Antardasha sub-period runs.
13387
13719
  */
@@ -13396,69 +13728,190 @@ export type PostVedicAstrologyDashaCurrentResponses = {
13396
13728
  pratyantardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
13397
13729
  };
13398
13730
  /**
13399
- * Time remaining in the currently running Mahadasha (major period).
13400
- */
13401
- remainingInMahadasha: {
13402
- /**
13403
- * Full years remaining in this Vimshottari dasha period.
13404
- */
13405
- years: number;
13406
- /**
13407
- * Additional months remaining beyond full years.
13408
- */
13409
- months: number;
13410
- /**
13411
- * Additional days remaining beyond full months.
13412
- */
13413
- days: number;
13414
- /**
13415
- * Total remaining days in this dasha period. Useful for progress calculations.
13416
- */
13417
- totalDays: number;
13418
- };
13419
- /**
13420
- * Time remaining in the currently running Antardasha (sub-period) within the Mahadasha.
13731
+ * 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.
13421
13732
  */
13422
- remainingInAntardasha: {
13423
- /**
13424
- * Full years remaining in this Vimshottari dasha period.
13425
- */
13426
- years: number;
13733
+ pranaDasha: {
13427
13734
  /**
13428
- * Additional months remaining beyond full years.
13735
+ * Ruling graha of this Vimshottari dasha period. One of 9 planets in the Ketu-Venus-Sun-Moon-Mars-Rahu-Jupiter-Saturn-Mercury sequence.
13429
13736
  */
13430
- months: number;
13737
+ planet: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
13431
13738
  /**
13432
- * Additional days remaining beyond full months.
13739
+ * Start datetime of this dasha period. Adjusted to the requested timezone offset.
13433
13740
  */
13434
- days: number;
13741
+ startDate: string;
13435
13742
  /**
13436
- * Total remaining days in this dasha period. Useful for progress calculations.
13743
+ * End datetime of this dasha period. Adjusted to the requested timezone offset.
13437
13744
  */
13438
- totalDays: number;
13439
- };
13440
- /**
13441
- * Time remaining in the currently running Pratyantardasha (sub-sub-period).
13442
- */
13443
- remainingInPratyantardasha: {
13745
+ endDate: string;
13444
13746
  /**
13445
- * Full years remaining in this Vimshottari dasha period.
13747
+ * Duration of this dasha period in years. Mahadasha durations range from 6 years (Sun) to 20 years (Venus).
13446
13748
  */
13447
- years: number;
13749
+ durationYears: number;
13448
13750
  /**
13449
- * Additional months remaining beyond full years.
13751
+ * 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.
13450
13752
  */
13451
- months: number;
13753
+ nominalStartDate?: string;
13452
13754
  /**
13453
- * Additional days remaining beyond full months.
13755
+ * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
13454
13756
  */
13455
- days: number;
13757
+ interpretation?: string;
13456
13758
  /**
13457
- * Total remaining days in this dasha period. Useful for progress calculations.
13759
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
13458
13760
  */
13459
- totalDays: number;
13460
- };
13461
- /**
13761
+ significators?: {
13762
+ /**
13763
+ * 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.
13764
+ */
13765
+ house: number;
13766
+ /**
13767
+ * 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.
13768
+ */
13769
+ starLord: string;
13770
+ /**
13771
+ * 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.
13772
+ */
13773
+ subLord?: string;
13774
+ /**
13775
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
13776
+ */
13777
+ signifies: {
13778
+ /**
13779
+ * 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).
13780
+ */
13781
+ L1: Array<number>;
13782
+ /**
13783
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
13784
+ */
13785
+ L2: Array<number>;
13786
+ /**
13787
+ * 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.
13788
+ */
13789
+ L3: Array<number>;
13790
+ /**
13791
+ * 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.
13792
+ */
13793
+ L4: Array<number>;
13794
+ };
13795
+ /**
13796
+ * 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.
13797
+ */
13798
+ signifiedHouses: Array<number>;
13799
+ /**
13800
+ * 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.
13801
+ */
13802
+ strongHouses: Array<number>;
13803
+ /**
13804
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
13805
+ */
13806
+ strength: {
13807
+ /**
13808
+ * 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.
13809
+ */
13810
+ score: number;
13811
+ /**
13812
+ * 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.
13813
+ */
13814
+ grade: 'A' | 'B' | 'C' | 'D';
13815
+ /**
13816
+ * 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.
13817
+ */
13818
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
13819
+ };
13820
+ };
13821
+ /**
13822
+ * Parent Mahadasha lord under which this Antardasha sub-period runs.
13823
+ */
13824
+ mahadashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
13825
+ /**
13826
+ * Parent Antardasha lord under which this Pratyantardasha runs.
13827
+ */
13828
+ antardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
13829
+ /**
13830
+ * Parent Pratyantardasha lord under which this Sookshma dasha runs.
13831
+ */
13832
+ pratyantardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
13833
+ /**
13834
+ * Parent Sookshma dasha lord under which this Prana dasha runs.
13835
+ */
13836
+ sookshmaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
13837
+ };
13838
+ /**
13839
+ * 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.
13840
+ */
13841
+ commonHouses?: {
13842
+ /**
13843
+ * 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.
13844
+ */
13845
+ allLevels: Array<number>;
13846
+ /**
13847
+ * 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.
13848
+ */
13849
+ dashaBhuktiAntara: Array<number>;
13850
+ };
13851
+ /**
13852
+ * Time remaining in the currently running Mahadasha (major period).
13853
+ */
13854
+ remainingInMahadasha: {
13855
+ /**
13856
+ * Full years remaining in this Vimshottari dasha period.
13857
+ */
13858
+ years: number;
13859
+ /**
13860
+ * Additional months remaining beyond full years.
13861
+ */
13862
+ months: number;
13863
+ /**
13864
+ * Additional days remaining beyond full months.
13865
+ */
13866
+ days: number;
13867
+ /**
13868
+ * Total remaining days in this dasha period. Useful for progress calculations.
13869
+ */
13870
+ totalDays: number;
13871
+ };
13872
+ /**
13873
+ * Time remaining in the currently running Antardasha (sub-period) within the Mahadasha.
13874
+ */
13875
+ remainingInAntardasha: {
13876
+ /**
13877
+ * Full years remaining in this Vimshottari dasha period.
13878
+ */
13879
+ years: number;
13880
+ /**
13881
+ * Additional months remaining beyond full years.
13882
+ */
13883
+ months: number;
13884
+ /**
13885
+ * Additional days remaining beyond full months.
13886
+ */
13887
+ days: number;
13888
+ /**
13889
+ * Total remaining days in this dasha period. Useful for progress calculations.
13890
+ */
13891
+ totalDays: number;
13892
+ };
13893
+ /**
13894
+ * Time remaining in the currently running Pratyantardasha (sub-sub-period).
13895
+ */
13896
+ remainingInPratyantardasha: {
13897
+ /**
13898
+ * Full years remaining in this Vimshottari dasha period.
13899
+ */
13900
+ years: number;
13901
+ /**
13902
+ * Additional months remaining beyond full years.
13903
+ */
13904
+ months: number;
13905
+ /**
13906
+ * Additional days remaining beyond full months.
13907
+ */
13908
+ days: number;
13909
+ /**
13910
+ * Total remaining days in this dasha period. Useful for progress calculations.
13911
+ */
13912
+ totalDays: number;
13913
+ };
13914
+ /**
13462
13915
  * Time remaining in the currently running Sookshma dasha (fourth level). Sookshma periods last days rather than months, so this value turns over quickly.
13463
13916
  */
13464
13917
  remainingInSookshma: {
@@ -13479,6 +13932,27 @@ export type PostVedicAstrologyDashaCurrentResponses = {
13479
13932
  */
13480
13933
  totalDays: number;
13481
13934
  };
13935
+ /**
13936
+ * 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.
13937
+ */
13938
+ remainingInPrana: {
13939
+ /**
13940
+ * Full years remaining in this Vimshottari dasha period.
13941
+ */
13942
+ years: number;
13943
+ /**
13944
+ * Additional months remaining beyond full years.
13945
+ */
13946
+ months: number;
13947
+ /**
13948
+ * Additional days remaining beyond full months.
13949
+ */
13950
+ days: number;
13951
+ /**
13952
+ * Total remaining days in this dasha period. Useful for progress calculations.
13953
+ */
13954
+ totalDays: number;
13955
+ };
13482
13956
  };
13483
13957
  };
13484
13958
  export type PostVedicAstrologyDashaCurrentResponse = PostVedicAstrologyDashaCurrentResponses[keyof PostVedicAstrologyDashaCurrentResponses];
@@ -13508,6 +13982,14 @@ export type PostVedicAstrologyDashaMajorData = {
13508
13982
  * 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.
13509
13983
  */
13510
13984
  ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri';
13985
+ /**
13986
+ * 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.
13987
+ */
13988
+ significators?: boolean;
13989
+ /**
13990
+ * 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".
13991
+ */
13992
+ nodeType?: 'mean' | 'true';
13511
13993
  };
13512
13994
  path?: never;
13513
13995
  query?: {
@@ -13625,6 +14107,12 @@ export type PostVedicAstrologyDashaMajorResponses = {
13625
14107
  * Complete 120-year Vimshottari Dasha timeline with all 9 Mahadasha periods, birth dasha balance, Moon nakshatra, and start/end dates for each planetary period.
13626
14108
  */
13627
14109
  200: {
14110
+ /**
14111
+ * 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.
14112
+ */
14113
+ houseThemes?: {
14114
+ [key: string]: Array<string>;
14115
+ };
13628
14116
  /**
13629
14117
  * Birth Moon nakshatra number (1-27) that determines the Vimshottari starting point.
13630
14118
  */
@@ -13698,6 +14186,69 @@ export type PostVedicAstrologyDashaMajorResponses = {
13698
14186
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
13699
14187
  */
13700
14188
  interpretation?: string;
14189
+ /**
14190
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
14191
+ */
14192
+ significators?: {
14193
+ /**
14194
+ * 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.
14195
+ */
14196
+ house: number;
14197
+ /**
14198
+ * 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.
14199
+ */
14200
+ starLord: string;
14201
+ /**
14202
+ * 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.
14203
+ */
14204
+ subLord?: string;
14205
+ /**
14206
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
14207
+ */
14208
+ signifies: {
14209
+ /**
14210
+ * 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).
14211
+ */
14212
+ L1: Array<number>;
14213
+ /**
14214
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
14215
+ */
14216
+ L2: Array<number>;
14217
+ /**
14218
+ * 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.
14219
+ */
14220
+ L3: Array<number>;
14221
+ /**
14222
+ * 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.
14223
+ */
14224
+ L4: Array<number>;
14225
+ };
14226
+ /**
14227
+ * 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.
14228
+ */
14229
+ signifiedHouses: Array<number>;
14230
+ /**
14231
+ * 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.
14232
+ */
14233
+ strongHouses: Array<number>;
14234
+ /**
14235
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
14236
+ */
14237
+ strength: {
14238
+ /**
14239
+ * 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.
14240
+ */
14241
+ score: number;
14242
+ /**
14243
+ * 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.
14244
+ */
14245
+ grade: 'A' | 'B' | 'C' | 'D';
14246
+ /**
14247
+ * 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.
14248
+ */
14249
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
14250
+ };
14251
+ };
13701
14252
  }>;
13702
14253
  /**
13703
14254
  * Total Vimshottari cycle length in years (always 120).
@@ -13732,6 +14283,14 @@ export type PostVedicAstrologyDashaSubByMahadashaData = {
13732
14283
  * 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.
13733
14284
  */
13734
14285
  ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri';
14286
+ /**
14287
+ * 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.
14288
+ */
14289
+ significators?: boolean;
14290
+ /**
14291
+ * 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".
14292
+ */
14293
+ nodeType?: 'mean' | 'true';
13735
14294
  };
13736
14295
  path: {
13737
14296
  /**
@@ -13854,6 +14413,12 @@ export type PostVedicAstrologyDashaSubByMahadashaResponses = {
13854
14413
  * All 9 Antardasha sub-periods within the specified Mahadasha, with start/end dates and the parent Mahadasha period details.
13855
14414
  */
13856
14415
  200: {
14416
+ /**
14417
+ * 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.
14418
+ */
14419
+ houseThemes?: {
14420
+ [key: string]: Array<string>;
14421
+ };
13857
14422
  /**
13858
14423
  * Ruling planet of the requested Mahadasha period.
13859
14424
  */
@@ -13898,6 +14463,69 @@ export type PostVedicAstrologyDashaSubByMahadashaResponses = {
13898
14463
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
13899
14464
  */
13900
14465
  interpretation?: string;
14466
+ /**
14467
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
14468
+ */
14469
+ significators?: {
14470
+ /**
14471
+ * 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.
14472
+ */
14473
+ house: number;
14474
+ /**
14475
+ * 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.
14476
+ */
14477
+ starLord: string;
14478
+ /**
14479
+ * 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.
14480
+ */
14481
+ subLord?: string;
14482
+ /**
14483
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
14484
+ */
14485
+ signifies: {
14486
+ /**
14487
+ * 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).
14488
+ */
14489
+ L1: Array<number>;
14490
+ /**
14491
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
14492
+ */
14493
+ L2: Array<number>;
14494
+ /**
14495
+ * 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.
14496
+ */
14497
+ L3: Array<number>;
14498
+ /**
14499
+ * 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.
14500
+ */
14501
+ L4: Array<number>;
14502
+ };
14503
+ /**
14504
+ * 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.
14505
+ */
14506
+ signifiedHouses: Array<number>;
14507
+ /**
14508
+ * 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.
14509
+ */
14510
+ strongHouses: Array<number>;
14511
+ /**
14512
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
14513
+ */
14514
+ strength: {
14515
+ /**
14516
+ * 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.
14517
+ */
14518
+ score: number;
14519
+ /**
14520
+ * 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.
14521
+ */
14522
+ grade: 'A' | 'B' | 'C' | 'D';
14523
+ /**
14524
+ * 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.
14525
+ */
14526
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
14527
+ };
14528
+ };
13901
14529
  };
13902
14530
  /**
13903
14531
  * 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.
@@ -13927,15 +14555,463 @@ export type PostVedicAstrologyDashaSubByMahadashaResponses = {
13927
14555
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
13928
14556
  */
13929
14557
  interpretation?: string;
14558
+ /**
14559
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
14560
+ */
14561
+ significators?: {
14562
+ /**
14563
+ * 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.
14564
+ */
14565
+ house: number;
14566
+ /**
14567
+ * 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.
14568
+ */
14569
+ starLord: string;
14570
+ /**
14571
+ * 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.
14572
+ */
14573
+ subLord?: string;
14574
+ /**
14575
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
14576
+ */
14577
+ signifies: {
14578
+ /**
14579
+ * 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).
14580
+ */
14581
+ L1: Array<number>;
14582
+ /**
14583
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
14584
+ */
14585
+ L2: Array<number>;
14586
+ /**
14587
+ * 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.
14588
+ */
14589
+ L3: Array<number>;
14590
+ /**
14591
+ * 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.
14592
+ */
14593
+ L4: Array<number>;
14594
+ };
14595
+ /**
14596
+ * 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.
14597
+ */
14598
+ signifiedHouses: Array<number>;
14599
+ /**
14600
+ * 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.
14601
+ */
14602
+ strongHouses: Array<number>;
14603
+ /**
14604
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
14605
+ */
14606
+ strength: {
14607
+ /**
14608
+ * 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.
14609
+ */
14610
+ score: number;
14611
+ /**
14612
+ * 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.
14613
+ */
14614
+ grade: 'A' | 'B' | 'C' | 'D';
14615
+ /**
14616
+ * 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.
14617
+ */
14618
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
14619
+ };
14620
+ };
14621
+ /**
14622
+ * Parent Mahadasha lord under which this Antardasha sub-period runs.
14623
+ */
14624
+ mahadashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14625
+ }>;
14626
+ };
14627
+ };
14628
+ export type PostVedicAstrologyDashaSubByMahadashaResponse = PostVedicAstrologyDashaSubByMahadashaResponses[keyof PostVedicAstrologyDashaSubByMahadashaResponses];
14629
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaData = {
14630
+ body?: {
14631
+ /**
14632
+ * 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).
14633
+ */
14634
+ date: string;
14635
+ /**
14636
+ * 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.
14637
+ */
14638
+ time: string;
14639
+ /**
14640
+ * 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.
14641
+ */
14642
+ latitude: number;
14643
+ /**
14644
+ * Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240.
14645
+ */
14646
+ longitude: number;
14647
+ /**
14648
+ * 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.
14649
+ */
14650
+ timezone?: number | string;
14651
+ /**
14652
+ * 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.
14653
+ */
14654
+ ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri';
14655
+ /**
14656
+ * 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.
14657
+ */
14658
+ significators?: boolean;
14659
+ /**
14660
+ * 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".
14661
+ */
14662
+ nodeType?: 'mean' | 'true';
14663
+ };
14664
+ path: {
14665
+ /**
14666
+ * Mahadasha planet name, case-insensitive (e.g. saturn, Saturn, SATURN all work). Valid: Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury.
14667
+ */
14668
+ mahadasha: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14669
+ /**
14670
+ * Antardasha (bhukti) planet name inside that Mahadasha, case-insensitive. Every Mahadasha contains all 9 lords, so a repeat such as saturn/saturn is valid.
14671
+ */
14672
+ antardasha: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14673
+ };
14674
+ query?: {
14675
+ /**
14676
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
14677
+ */
14678
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
14679
+ };
14680
+ url: '/vedic-astrology/dasha/sub/{mahadasha}/{antardasha}';
14681
+ };
14682
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaErrors = {
14683
+ /**
14684
+ * Validation error. `issues[]` lists every failed field.
14685
+ */
14686
+ 400: {
14687
+ /**
14688
+ * First issue summary.
14689
+ */
14690
+ error: string;
14691
+ code: 'validation_error';
14692
+ /**
14693
+ * Every validation failure. Use this to rebuild a valid request.
14694
+ */
14695
+ issues: Array<{
14696
+ /**
14697
+ * Dot-separated field path, or "(root)" for top-level.
14698
+ */
14699
+ path: string;
14700
+ message: string;
14701
+ /**
14702
+ * Zod issue code (invalid_type, too_small, too_big, invalid_string, ...).
14703
+ */
14704
+ code?: string;
14705
+ /**
14706
+ * Expected type for invalid_type.
14707
+ */
14708
+ expected?: string;
14709
+ /**
14710
+ * Minimum bound for too_small issues.
14711
+ */
14712
+ minimum?: number | string;
14713
+ /**
14714
+ * Maximum bound for too_big issues.
14715
+ */
14716
+ maximum?: number | string;
14717
+ inclusive?: boolean;
14718
+ /**
14719
+ * Format name for string issues (regex, email, url, uuid).
14720
+ */
14721
+ format?: string;
14722
+ /**
14723
+ * Regex pattern when format is regex.
14724
+ */
14725
+ pattern?: string;
14726
+ }>;
14727
+ };
14728
+ /**
14729
+ * Invalid or missing API key
14730
+ */
14731
+ 401: {
14732
+ /**
14733
+ * Human-readable error message. May change wording.
14734
+ */
14735
+ error: string;
14736
+ /**
14737
+ * Machine-readable error code. Stable identifier.
14738
+ */
14739
+ code: string;
14740
+ };
14741
+ /**
14742
+ * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
14743
+ */
14744
+ 405: {
14745
+ error: string;
14746
+ code: 'method_not_allowed';
14747
+ /**
14748
+ * Allowed HTTP methods for this path. Mirrors the Allow response header.
14749
+ */
14750
+ allow: Array<string>;
14751
+ /**
14752
+ * Link to the product page for this domain.
14753
+ */
14754
+ docs?: string;
14755
+ };
14756
+ /**
14757
+ * Monthly rate limit exceeded
14758
+ */
14759
+ 429: {
14760
+ /**
14761
+ * Human-readable error message. May change wording.
14762
+ */
14763
+ error: string;
14764
+ /**
14765
+ * Machine-readable error code. Stable identifier.
14766
+ */
14767
+ code: string;
14768
+ };
14769
+ /**
14770
+ * Internal server error
14771
+ */
14772
+ 500: {
14773
+ /**
14774
+ * Human-readable error message. May change wording.
14775
+ */
14776
+ error: string;
14777
+ /**
14778
+ * Machine-readable error code. Stable identifier.
14779
+ */
14780
+ code: string;
14781
+ };
14782
+ };
14783
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaError = PostVedicAstrologyDashaSubByMahadashaByAntardashaErrors[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaErrors];
14784
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses = {
14785
+ /**
14786
+ * All 9 Pratyantardasha periods within the specified Mahadasha and Antardasha, with start/end dates and the parent Antardasha period details.
14787
+ */
14788
+ 200: {
14789
+ /**
14790
+ * 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.
14791
+ */
14792
+ houseThemes?: {
14793
+ [key: string]: Array<string>;
14794
+ };
14795
+ /**
14796
+ * Ruling planet of the requested Mahadasha period.
14797
+ */
14798
+ mahadashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14799
+ /**
14800
+ * Ruling planet of the requested Antardasha sub-period.
14801
+ */
14802
+ antardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14803
+ /**
14804
+ * 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.
14805
+ */
14806
+ moonLongitude: number;
14807
+ /**
14808
+ * 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.
14809
+ */
14810
+ ayanamsa: number;
14811
+ /**
14812
+ * 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.
14813
+ */
14814
+ ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri';
14815
+ /**
14816
+ * Full details of the parent Antardasha including start/end dates and duration.
14817
+ */
14818
+ antardashaPeriod: {
14819
+ /**
14820
+ * Ruling graha of this Vimshottari dasha period. One of 9 planets in the Ketu-Venus-Sun-Moon-Mars-Rahu-Jupiter-Saturn-Mercury sequence.
14821
+ */
14822
+ planet: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14823
+ /**
14824
+ * Start datetime of this dasha period. Adjusted to the requested timezone offset.
14825
+ */
14826
+ startDate: string;
14827
+ /**
14828
+ * End datetime of this dasha period. Adjusted to the requested timezone offset.
14829
+ */
14830
+ endDate: string;
14831
+ /**
14832
+ * Duration of this dasha period in years. Mahadasha durations range from 6 years (Sun) to 20 years (Venus).
14833
+ */
14834
+ durationYears: number;
14835
+ /**
14836
+ * 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.
14837
+ */
14838
+ nominalStartDate?: string;
14839
+ /**
14840
+ * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
14841
+ */
14842
+ interpretation?: string;
14843
+ /**
14844
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
14845
+ */
14846
+ significators?: {
14847
+ /**
14848
+ * 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.
14849
+ */
14850
+ house: number;
14851
+ /**
14852
+ * 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.
14853
+ */
14854
+ starLord: string;
14855
+ /**
14856
+ * 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.
14857
+ */
14858
+ subLord?: string;
14859
+ /**
14860
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
14861
+ */
14862
+ signifies: {
14863
+ /**
14864
+ * 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).
14865
+ */
14866
+ L1: Array<number>;
14867
+ /**
14868
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
14869
+ */
14870
+ L2: Array<number>;
14871
+ /**
14872
+ * 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.
14873
+ */
14874
+ L3: Array<number>;
14875
+ /**
14876
+ * 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.
14877
+ */
14878
+ L4: Array<number>;
14879
+ };
14880
+ /**
14881
+ * 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.
14882
+ */
14883
+ signifiedHouses: Array<number>;
14884
+ /**
14885
+ * 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.
14886
+ */
14887
+ strongHouses: Array<number>;
14888
+ /**
14889
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
14890
+ */
14891
+ strength: {
14892
+ /**
14893
+ * 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.
14894
+ */
14895
+ score: number;
14896
+ /**
14897
+ * 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.
14898
+ */
14899
+ grade: 'A' | 'B' | 'C' | 'D';
14900
+ /**
14901
+ * 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.
14902
+ */
14903
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
14904
+ };
14905
+ };
14906
+ /**
14907
+ * Parent Mahadasha lord under which this Antardasha sub-period runs.
14908
+ */
14909
+ mahadashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14910
+ };
14911
+ /**
14912
+ * 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.
14913
+ */
14914
+ pratyantardashas: Array<{
14915
+ /**
14916
+ * Ruling graha of this Vimshottari dasha period. One of 9 planets in the Ketu-Venus-Sun-Moon-Mars-Rahu-Jupiter-Saturn-Mercury sequence.
14917
+ */
14918
+ planet: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14919
+ /**
14920
+ * Start datetime of this dasha period. Adjusted to the requested timezone offset.
14921
+ */
14922
+ startDate: string;
14923
+ /**
14924
+ * End datetime of this dasha period. Adjusted to the requested timezone offset.
14925
+ */
14926
+ endDate: string;
14927
+ /**
14928
+ * Duration of this dasha period in years. Mahadasha durations range from 6 years (Sun) to 20 years (Venus).
14929
+ */
14930
+ durationYears: number;
14931
+ /**
14932
+ * 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.
14933
+ */
14934
+ nominalStartDate?: string;
14935
+ /**
14936
+ * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
14937
+ */
14938
+ interpretation?: string;
14939
+ /**
14940
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
14941
+ */
14942
+ significators?: {
14943
+ /**
14944
+ * 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.
14945
+ */
14946
+ house: number;
14947
+ /**
14948
+ * 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.
14949
+ */
14950
+ starLord: string;
14951
+ /**
14952
+ * 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.
14953
+ */
14954
+ subLord?: string;
14955
+ /**
14956
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
14957
+ */
14958
+ signifies: {
14959
+ /**
14960
+ * 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).
14961
+ */
14962
+ L1: Array<number>;
14963
+ /**
14964
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
14965
+ */
14966
+ L2: Array<number>;
14967
+ /**
14968
+ * 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.
14969
+ */
14970
+ L3: Array<number>;
14971
+ /**
14972
+ * 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.
14973
+ */
14974
+ L4: Array<number>;
14975
+ };
14976
+ /**
14977
+ * 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.
14978
+ */
14979
+ signifiedHouses: Array<number>;
14980
+ /**
14981
+ * 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.
14982
+ */
14983
+ strongHouses: Array<number>;
14984
+ /**
14985
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
14986
+ */
14987
+ strength: {
14988
+ /**
14989
+ * 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.
14990
+ */
14991
+ score: number;
14992
+ /**
14993
+ * 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.
14994
+ */
14995
+ grade: 'A' | 'B' | 'C' | 'D';
14996
+ /**
14997
+ * 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.
14998
+ */
14999
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
15000
+ };
15001
+ };
13930
15002
  /**
13931
15003
  * Parent Mahadasha lord under which this Antardasha sub-period runs.
13932
15004
  */
13933
15005
  mahadashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15006
+ /**
15007
+ * Parent Antardasha lord under which this Pratyantardasha runs.
15008
+ */
15009
+ antardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
13934
15010
  }>;
13935
15011
  };
13936
15012
  };
13937
- export type PostVedicAstrologyDashaSubByMahadashaResponse = PostVedicAstrologyDashaSubByMahadashaResponses[keyof PostVedicAstrologyDashaSubByMahadashaResponses];
13938
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaData = {
15013
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponse = PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses];
15014
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaData = {
13939
15015
  body?: {
13940
15016
  /**
13941
15017
  * 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).
@@ -13961,16 +15037,28 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaData = {
13961
15037
  * 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.
13962
15038
  */
13963
15039
  ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri';
15040
+ /**
15041
+ * 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.
15042
+ */
15043
+ significators?: boolean;
15044
+ /**
15045
+ * 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".
15046
+ */
15047
+ nodeType?: 'mean' | 'true';
13964
15048
  };
13965
15049
  path: {
13966
15050
  /**
13967
- * Mahadasha planet name, case-insensitive (e.g. saturn, Saturn, SATURN all work). Valid: Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury.
15051
+ * Mahadasha planet name, case-insensitive. Valid: Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury.
13968
15052
  */
13969
15053
  mahadasha: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
13970
15054
  /**
13971
- * Antardasha (bhukti) planet name inside that Mahadasha, case-insensitive. Every Mahadasha contains all 9 lords, so a repeat such as saturn/saturn is valid.
15055
+ * Antardasha (bhukti) planet name inside that Mahadasha, case-insensitive.
13972
15056
  */
13973
15057
  antardasha: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15058
+ /**
15059
+ * Pratyantardasha (antara) planet name inside that Antardasha, case-insensitive.
15060
+ */
15061
+ pratyantardasha: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
13974
15062
  };
13975
15063
  query?: {
13976
15064
  /**
@@ -13978,9 +15066,9 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaData = {
13978
15066
  */
13979
15067
  lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
13980
15068
  };
13981
- url: '/vedic-astrology/dasha/sub/{mahadasha}/{antardasha}';
15069
+ url: '/vedic-astrology/dasha/sub/{mahadasha}/{antardasha}/{pratyantardasha}';
13982
15070
  };
13983
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaErrors = {
15071
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaErrors = {
13984
15072
  /**
13985
15073
  * Validation error. `issues[]` lists every failed field.
13986
15074
  */
@@ -14081,12 +15169,18 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaErrors = {
14081
15169
  code: string;
14082
15170
  };
14083
15171
  };
14084
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaError = PostVedicAstrologyDashaSubByMahadashaByAntardashaErrors[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaErrors];
14085
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses = {
15172
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaError = PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaErrors[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaErrors];
15173
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaResponses = {
14086
15174
  /**
14087
- * All 9 Pratyantardasha periods within the specified Mahadasha and Antardasha, with start/end dates and the parent Antardasha period details.
15175
+ * All 9 Sookshma dasha periods within the specified Mahadasha, Antardasha, and Pratyantardasha, with start/end dates and the parent Pratyantardasha period details.
14088
15176
  */
14089
15177
  200: {
15178
+ /**
15179
+ * 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.
15180
+ */
15181
+ houseThemes?: {
15182
+ [key: string]: Array<string>;
15183
+ };
14090
15184
  /**
14091
15185
  * Ruling planet of the requested Mahadasha period.
14092
15186
  */
@@ -14095,6 +15189,10 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses = {
14095
15189
  * Ruling planet of the requested Antardasha sub-period.
14096
15190
  */
14097
15191
  antardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15192
+ /**
15193
+ * Ruling planet of the requested Pratyantardasha sub-sub-period.
15194
+ */
15195
+ pratyantardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14098
15196
  /**
14099
15197
  * 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.
14100
15198
  */
@@ -14108,9 +15206,9 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses = {
14108
15206
  */
14109
15207
  ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri';
14110
15208
  /**
14111
- * Full details of the parent Antardasha including start/end dates and duration.
15209
+ * Full details of the parent Pratyantardasha including start/end dates and duration.
14112
15210
  */
14113
- antardashaPeriod: {
15211
+ pratyantardashaPeriod: {
14114
15212
  /**
14115
15213
  * Ruling graha of this Vimshottari dasha period. One of 9 planets in the Ketu-Venus-Sun-Moon-Mars-Rahu-Jupiter-Saturn-Mercury sequence.
14116
15214
  */
@@ -14135,15 +15233,82 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses = {
14135
15233
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
14136
15234
  */
14137
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
+ };
14138
15299
  /**
14139
15300
  * Parent Mahadasha lord under which this Antardasha sub-period runs.
14140
15301
  */
14141
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';
14142
15307
  };
14143
15308
  /**
14144
- * 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.
15309
+ * 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.
14145
15310
  */
14146
- pratyantardashas: Array<{
15311
+ sookshmaDashas: Array<{
14147
15312
  /**
14148
15313
  * Ruling graha of this Vimshottari dasha period. One of 9 planets in the Ketu-Venus-Sun-Moon-Mars-Rahu-Jupiter-Saturn-Mercury sequence.
14149
15314
  */
@@ -14168,6 +15333,69 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses = {
14168
15333
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
14169
15334
  */
14170
15335
  interpretation?: string;
15336
+ /**
15337
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
15338
+ */
15339
+ significators?: {
15340
+ /**
15341
+ * 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.
15342
+ */
15343
+ house: number;
15344
+ /**
15345
+ * 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.
15346
+ */
15347
+ starLord: string;
15348
+ /**
15349
+ * 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.
15350
+ */
15351
+ subLord?: string;
15352
+ /**
15353
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
15354
+ */
15355
+ signifies: {
15356
+ /**
15357
+ * 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).
15358
+ */
15359
+ L1: Array<number>;
15360
+ /**
15361
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
15362
+ */
15363
+ L2: Array<number>;
15364
+ /**
15365
+ * 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.
15366
+ */
15367
+ L3: Array<number>;
15368
+ /**
15369
+ * 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.
15370
+ */
15371
+ L4: Array<number>;
15372
+ };
15373
+ /**
15374
+ * 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.
15375
+ */
15376
+ signifiedHouses: Array<number>;
15377
+ /**
15378
+ * 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.
15379
+ */
15380
+ strongHouses: Array<number>;
15381
+ /**
15382
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
15383
+ */
15384
+ strength: {
15385
+ /**
15386
+ * 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.
15387
+ */
15388
+ score: number;
15389
+ /**
15390
+ * 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.
15391
+ */
15392
+ grade: 'A' | 'B' | 'C' | 'D';
15393
+ /**
15394
+ * 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.
15395
+ */
15396
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
15397
+ };
15398
+ };
14171
15399
  /**
14172
15400
  * Parent Mahadasha lord under which this Antardasha sub-period runs.
14173
15401
  */
@@ -14176,11 +15404,15 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses = {
14176
15404
  * Parent Antardasha lord under which this Pratyantardasha runs.
14177
15405
  */
14178
15406
  antardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15407
+ /**
15408
+ * Parent Pratyantardasha lord under which this Sookshma dasha runs.
15409
+ */
15410
+ pratyantardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14179
15411
  }>;
14180
15412
  };
14181
15413
  };
14182
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaResponse = PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaResponses];
14183
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaData = {
15414
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaResponse = PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaResponses[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaResponses];
15415
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaData = {
14184
15416
  body?: {
14185
15417
  /**
14186
15418
  * 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).
@@ -14206,6 +15438,14 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaDa
14206
15438
  * 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.
14207
15439
  */
14208
15440
  ayanamsa?: 'kp-newcomb' | 'kp-old' | 'lahiri';
15441
+ /**
15442
+ * 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.
15443
+ */
15444
+ significators?: boolean;
15445
+ /**
15446
+ * 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".
15447
+ */
15448
+ nodeType?: 'mean' | 'true';
14209
15449
  };
14210
15450
  path: {
14211
15451
  /**
@@ -14220,6 +15460,10 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaDa
14220
15460
  * Pratyantardasha (antara) planet name inside that Antardasha, case-insensitive.
14221
15461
  */
14222
15462
  pratyantardasha: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15463
+ /**
15464
+ * 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.
15465
+ */
15466
+ sookshma: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14223
15467
  };
14224
15468
  query?: {
14225
15469
  /**
@@ -14227,9 +15471,9 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaDa
14227
15471
  */
14228
15472
  lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
14229
15473
  };
14230
- url: '/vedic-astrology/dasha/sub/{mahadasha}/{antardasha}/{pratyantardasha}';
15474
+ url: '/vedic-astrology/dasha/sub/{mahadasha}/{antardasha}/{pratyantardasha}/{sookshma}';
14231
15475
  };
14232
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaErrors = {
15476
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaErrors = {
14233
15477
  /**
14234
15478
  * Validation error. `issues[]` lists every failed field.
14235
15479
  */
@@ -14330,12 +15574,18 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaEr
14330
15574
  code: string;
14331
15575
  };
14332
15576
  };
14333
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaError = PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaErrors[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaErrors];
14334
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaResponses = {
15577
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaError = PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaErrors[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaErrors];
15578
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaResponses = {
14335
15579
  /**
14336
- * All 9 Sookshma dasha periods within the specified Mahadasha, Antardasha, and Pratyantardasha, with start/end dates and the parent Pratyantardasha period details.
15580
+ * All 9 Prana dasha periods within the specified Mahadasha, Antardasha, Pratyantardasha, and Sookshma dasha, with start/end dates and the parent Sookshma period details.
14337
15581
  */
14338
15582
  200: {
15583
+ /**
15584
+ * 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.
15585
+ */
15586
+ houseThemes?: {
15587
+ [key: string]: Array<string>;
15588
+ };
14339
15589
  /**
14340
15590
  * Ruling planet of the requested Mahadasha period.
14341
15591
  */
@@ -14348,6 +15598,10 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaRe
14348
15598
  * Ruling planet of the requested Pratyantardasha sub-sub-period.
14349
15599
  */
14350
15600
  pratyantardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15601
+ /**
15602
+ * Ruling planet of the requested Sookshma dasha.
15603
+ */
15604
+ sookshmaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14351
15605
  /**
14352
15606
  * 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.
14353
15607
  */
@@ -14361,9 +15615,9 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaRe
14361
15615
  */
14362
15616
  ayanamsaType: 'kp-newcomb' | 'kp-old' | 'lahiri';
14363
15617
  /**
14364
- * Full details of the parent Pratyantardasha including start/end dates and duration.
15618
+ * Full details of the parent Sookshma dasha including start/end dates and duration.
14365
15619
  */
14366
- pratyantardashaPeriod: {
15620
+ sookshmaPeriod: {
14367
15621
  /**
14368
15622
  * Ruling graha of this Vimshottari dasha period. One of 9 planets in the Ketu-Venus-Sun-Moon-Mars-Rahu-Jupiter-Saturn-Mercury sequence.
14369
15623
  */
@@ -14388,6 +15642,69 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaRe
14388
15642
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
14389
15643
  */
14390
15644
  interpretation?: string;
15645
+ /**
15646
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
15647
+ */
15648
+ significators?: {
15649
+ /**
15650
+ * 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.
15651
+ */
15652
+ house: number;
15653
+ /**
15654
+ * 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.
15655
+ */
15656
+ starLord: string;
15657
+ /**
15658
+ * 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.
15659
+ */
15660
+ subLord?: string;
15661
+ /**
15662
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
15663
+ */
15664
+ signifies: {
15665
+ /**
15666
+ * 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).
15667
+ */
15668
+ L1: Array<number>;
15669
+ /**
15670
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
15671
+ */
15672
+ L2: Array<number>;
15673
+ /**
15674
+ * 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.
15675
+ */
15676
+ L3: Array<number>;
15677
+ /**
15678
+ * 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.
15679
+ */
15680
+ L4: Array<number>;
15681
+ };
15682
+ /**
15683
+ * 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.
15684
+ */
15685
+ signifiedHouses: Array<number>;
15686
+ /**
15687
+ * 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.
15688
+ */
15689
+ strongHouses: Array<number>;
15690
+ /**
15691
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
15692
+ */
15693
+ strength: {
15694
+ /**
15695
+ * 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.
15696
+ */
15697
+ score: number;
15698
+ /**
15699
+ * 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.
15700
+ */
15701
+ grade: 'A' | 'B' | 'C' | 'D';
15702
+ /**
15703
+ * 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.
15704
+ */
15705
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
15706
+ };
15707
+ };
14391
15708
  /**
14392
15709
  * Parent Mahadasha lord under which this Antardasha sub-period runs.
14393
15710
  */
@@ -14396,11 +15713,15 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaRe
14396
15713
  * Parent Antardasha lord under which this Pratyantardasha runs.
14397
15714
  */
14398
15715
  antardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15716
+ /**
15717
+ * Parent Pratyantardasha lord under which this Sookshma dasha runs.
15718
+ */
15719
+ pratyantardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14399
15720
  };
14400
15721
  /**
14401
- * 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.
15722
+ * 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.
14402
15723
  */
14403
- sookshmaDashas: Array<{
15724
+ pranaDashas: Array<{
14404
15725
  /**
14405
15726
  * Ruling graha of this Vimshottari dasha period. One of 9 planets in the Ketu-Venus-Sun-Moon-Mars-Rahu-Jupiter-Saturn-Mercury sequence.
14406
15727
  */
@@ -14425,6 +15746,69 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaRe
14425
15746
  * Vedic interpretation of the planetary period describing themes, karmic lessons, and life areas affected by this graha.
14426
15747
  */
14427
15748
  interpretation?: string;
15749
+ /**
15750
+ * KP significators of this period lord, read from the Placidus birth chart in the requested ayanamsa. Present only when the request sets "significators": true.
15751
+ */
15752
+ significators?: {
15753
+ /**
15754
+ * 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.
15755
+ */
15756
+ house: number;
15757
+ /**
15758
+ * 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.
15759
+ */
15760
+ starLord: string;
15761
+ /**
15762
+ * 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.
15763
+ */
15764
+ subLord?: string;
15765
+ /**
15766
+ * KP 4-level significator breakdown showing which houses (1-12) this planet signifies at each strength tier. L1 is strongest, L4 is weakest.
15767
+ */
15768
+ signifies: {
15769
+ /**
15770
+ * 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).
15771
+ */
15772
+ L1: Array<number>;
15773
+ /**
15774
+ * Level 2 (grade B). The house this planet physically occupies. For Rahu and Ketu, also includes houses occupied by their agent planets.
15775
+ */
15776
+ L2: Array<number>;
15777
+ /**
15778
+ * 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.
15779
+ */
15780
+ L3: Array<number>;
15781
+ /**
15782
+ * 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.
15783
+ */
15784
+ L4: Array<number>;
15785
+ };
15786
+ /**
15787
+ * 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.
15788
+ */
15789
+ signifiedHouses: Array<number>;
15790
+ /**
15791
+ * 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.
15792
+ */
15793
+ strongHouses: Array<number>;
15794
+ /**
15795
+ * How firmly this lord is tied to the houses it signifies, on the KP A to D significator grading.
15796
+ */
15797
+ strength: {
15798
+ /**
15799
+ * 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.
15800
+ */
15801
+ score: number;
15802
+ /**
15803
+ * 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.
15804
+ */
15805
+ grade: 'A' | 'B' | 'C' | 'D';
15806
+ /**
15807
+ * 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.
15808
+ */
15809
+ label: 'very-strong' | 'strong' | 'moderate' | 'weak';
15810
+ };
15811
+ };
14428
15812
  /**
14429
15813
  * Parent Mahadasha lord under which this Antardasha sub-period runs.
14430
15814
  */
@@ -14437,10 +15821,14 @@ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaRe
14437
15821
  * Parent Pratyantardasha lord under which this Sookshma dasha runs.
14438
15822
  */
14439
15823
  pratyantardashaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
15824
+ /**
15825
+ * Parent Sookshma dasha lord under which this Prana dasha runs.
15826
+ */
15827
+ sookshmaLord: 'Ketu' | 'Venus' | 'Sun' | 'Moon' | 'Mars' | 'Rahu' | 'Jupiter' | 'Saturn' | 'Mercury';
14440
15828
  }>;
14441
15829
  };
14442
15830
  };
14443
- export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaResponse = PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaResponses[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaResponses];
15831
+ export type PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaResponse = PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaResponses[keyof PostVedicAstrologyDashaSubByMahadashaByAntardashaByPratyantardashaBySookshmaResponses];
14444
15832
  export type PostVedicAstrologyPanchangBasicData = {
14445
15833
  body?: {
14446
15834
  /**
@@ -14710,7 +16098,7 @@ export type PostVedicAstrologyPanchangDetailedData = {
14710
16098
  */
14711
16099
  longitude: number;
14712
16100
  /**
14713
- * 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).
16101
+ * 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).
14714
16102
  */
14715
16103
  timezone?: number | string;
14716
16104
  };