@roxyapi/sdk 1.2.59 → 1.2.60

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/src/types.gen.ts CHANGED
@@ -35,9 +35,13 @@ export type NatalChartResponse = {
35
35
  */
36
36
  planets: Array<{
37
37
  /**
38
- * Planet or point name (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, North Node, South Node, Chiron, Black Moon Lilith). The lunar nodes are the mean node; software using the true node may show node positions up to 1.75 degrees different.
38
+ * Planet or point name (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, North Node, South Node, Chiron, Black Moon Lilith). Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use nameLocalized for anything a reader sees. The lunar nodes are the mean node; software using the true node may show node positions up to 1.75 degrees different.
39
39
  */
40
40
  name: string;
41
+ /**
42
+ * Planet or point name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
43
+ */
44
+ nameLocalized?: string;
41
45
  /**
42
46
  * Tropical ecliptic longitude in degrees (0-360).
43
47
  */
@@ -47,9 +51,13 @@ export type NatalChartResponse = {
47
51
  */
48
52
  latitude: number;
49
53
  /**
50
- * Tropical zodiac sign this planet occupies.
54
+ * Tropical zodiac sign this planet occupies. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use signLocalized for anything a reader sees.
51
55
  */
52
56
  sign: string;
57
+ /**
58
+ * Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
59
+ */
60
+ signLocalized?: string;
53
61
  /**
54
62
  * Degree within the zodiac sign (0-29.999).
55
63
  */
@@ -97,9 +105,13 @@ export type NatalChartResponse = {
97
105
  */
98
106
  longitude: number;
99
107
  /**
100
- * Zodiac sign on this house cusp.
108
+ * Zodiac sign on this house cusp. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
101
109
  */
102
110
  sign: string;
111
+ /**
112
+ * Zodiac sign name on this cusp in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
113
+ */
114
+ signLocalized?: string;
103
115
  /**
104
116
  * Degree within the zodiac sign (0-29.999).
105
117
  */
@@ -114,17 +126,29 @@ export type NatalChartResponse = {
114
126
  */
115
127
  aspects: Array<{
116
128
  /**
117
- * First planet in the aspect pair.
129
+ * First planet in the aspect pair. Always English, whatever the lang parameter says. Use planet1Localized for anything a reader sees.
118
130
  */
119
131
  planet1: string;
120
132
  /**
121
- * Second planet in the aspect pair.
133
+ * First planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
134
+ */
135
+ planet1Localized?: string;
136
+ /**
137
+ * Second planet in the aspect pair. Always English, whatever the lang parameter says. Use planet2Localized for anything a reader sees.
122
138
  */
123
139
  planet2: string;
124
140
  /**
125
- * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.).
141
+ * Second planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
142
+ */
143
+ planet2Localized?: string;
144
+ /**
145
+ * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.). Always English, whatever the lang parameter says. Use typeLocalized for anything a reader sees.
126
146
  */
127
147
  type: string;
148
+ /**
149
+ * Aspect type name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
150
+ */
151
+ typeLocalized?: string;
128
152
  /**
129
153
  * Exact angle of this aspect type in degrees.
130
154
  */
@@ -227,9 +251,13 @@ export type NatalChartResponse = {
227
251
  */
228
252
  ascendant: {
229
253
  /**
230
- * Zodiac sign on the Ascendant (rising sign).
254
+ * Zodiac sign on the Ascendant (rising sign). Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
231
255
  */
232
256
  sign: string;
257
+ /**
258
+ * Ascendant sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
259
+ */
260
+ signLocalized?: string;
233
261
  /**
234
262
  * Degree within the Ascendant sign (0-29.999).
235
263
  */
@@ -244,9 +272,13 @@ export type NatalChartResponse = {
244
272
  */
245
273
  midheaven: {
246
274
  /**
247
- * Zodiac sign on the Midheaven (MC).
275
+ * Zodiac sign on the Midheaven (MC). Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
248
276
  */
249
277
  sign: string;
278
+ /**
279
+ * Midheaven sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
280
+ */
281
+ signLocalized?: string;
250
282
  /**
251
283
  * Degree within the Midheaven sign (0-29.999).
252
284
  */
@@ -276,6 +308,10 @@ export type NatalChartResponse = {
276
308
  * Chart sect used for the calculation. Day (diurnal) when the Sun is above the horizon, night (nocturnal) when below. Day charts use Ascendant plus Moon minus Sun, night charts use Ascendant plus Sun minus Moon.
277
309
  */
278
310
  sect: 'day' | 'night';
311
+ /**
312
+ * Part of Fortune sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
313
+ */
314
+ signLocalized?: string;
279
315
  };
280
316
  /**
281
317
  * Vertex. The western intersection of the prime vertical with the ecliptic, often read as a point of fated encounters and turning-point relationships. The opposite point is the Anti-Vertex.
@@ -293,23 +329,39 @@ export type NatalChartResponse = {
293
329
  * Absolute ecliptic longitude of the Vertex (0-360).
294
330
  */
295
331
  longitude: number;
332
+ /**
333
+ * Vertex sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
334
+ */
335
+ signLocalized?: string;
296
336
  };
297
337
  /**
298
338
  * Chart summary with dominant element, modality, retrograde planets, and distribution analysis.
299
339
  */
300
340
  summary: {
301
341
  /**
302
- * Most represented element in the chart (Fire, Earth, Air, Water).
342
+ * Most represented element in the chart (Fire, Earth, Air, Water). Always English, whatever the lang parameter says. Use dominantElementLocalized for anything a reader sees.
303
343
  */
304
344
  dominantElement: string;
305
345
  /**
306
- * Most represented modality in the chart (Cardinal, Fixed, Mutable).
346
+ * Element name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
347
+ */
348
+ dominantElementLocalized?: string;
349
+ /**
350
+ * Most represented modality in the chart (Cardinal, Fixed, Mutable). Always English, whatever the lang parameter says. Use dominantModalityLocalized for anything a reader sees.
307
351
  */
308
352
  dominantModality: string;
309
353
  /**
310
- * Planets in retrograde motion at the time of birth.
354
+ * Modality name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
355
+ */
356
+ dominantModalityLocalized?: string;
357
+ /**
358
+ * Planets in retrograde motion at the time of birth. Always English, whatever the lang parameter says. Use retrogradePlanetsLocalized for anything a reader sees.
311
359
  */
312
360
  retrogradePlanets: Array<string>;
361
+ /**
362
+ * The same retrograde bodies in the requested language, for display only. Index aligned with retrogradePlanets, so entry n of one names entry n of the other. Present only when lang is set to a language other than English, since in English it would repeat retrogradePlanets exactly.
363
+ */
364
+ retrogradePlanetsLocalized?: Array<string>;
313
365
  /**
314
366
  * Count of planets in each element. Shows elemental emphasis in the personality.
315
367
  */
@@ -484,17 +536,29 @@ export type AspectsResponse = {
484
536
  */
485
537
  aspects: Array<{
486
538
  /**
487
- * First planet in the aspect pair.
539
+ * First planet in the aspect pair. Always English, whatever the lang parameter says. Use planet1Localized for anything a reader sees.
488
540
  */
489
541
  planet1: string;
490
542
  /**
491
- * Second planet in the aspect pair.
543
+ * First planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
544
+ */
545
+ planet1Localized?: string;
546
+ /**
547
+ * Second planet in the aspect pair. Always English, whatever the lang parameter says. Use planet2Localized for anything a reader sees.
492
548
  */
493
549
  planet2: string;
494
550
  /**
495
- * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.).
551
+ * Second planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
552
+ */
553
+ planet2Localized?: string;
554
+ /**
555
+ * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.). Always English, whatever the lang parameter says. Use typeLocalized for anything a reader sees.
496
556
  */
497
557
  type: string;
558
+ /**
559
+ * Aspect type name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
560
+ */
561
+ typeLocalized?: string;
498
562
  /**
499
563
  * Exact angle defining this aspect type in degrees.
500
564
  */
@@ -761,9 +825,13 @@ export type TransitsResponse = {
761
825
  */
762
826
  transitPlanets: Array<{
763
827
  /**
764
- * Planet name (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, North Node, South Node, Chiron, Black Moon Lilith). The lunar nodes are the mean node; software using the true node may show node positions up to 1.75 degrees different.
828
+ * Planet name (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, North Node, South Node, Chiron, Black Moon Lilith). Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use nameLocalized for anything a reader sees. The lunar nodes are the mean node; software using the true node may show node positions up to 1.75 degrees different.
765
829
  */
766
830
  name: string;
831
+ /**
832
+ * Planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
833
+ */
834
+ nameLocalized?: string;
767
835
  /**
768
836
  * Tropical ecliptic longitude in degrees (0-360). Primary coordinate for sign and aspect calculation.
769
837
  */
@@ -773,9 +841,13 @@ export type TransitsResponse = {
773
841
  */
774
842
  latitude: number;
775
843
  /**
776
- * Tropical zodiac sign the planet currently occupies. Changes when longitude crosses a 30-degree boundary.
844
+ * Tropical zodiac sign the planet currently occupies. Changes when longitude crosses a 30-degree boundary. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
777
845
  */
778
846
  sign: string;
847
+ /**
848
+ * Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
849
+ */
850
+ signLocalized?: string;
779
851
  /**
780
852
  * Degree within the current zodiac sign (0-29.999). Indicates how far into the sign the planet has progressed.
781
853
  */
@@ -794,17 +866,29 @@ export type TransitsResponse = {
794
866
  */
795
867
  transitAspects?: Array<{
796
868
  /**
797
- * Transiting planet forming the aspect.
869
+ * Transiting planet forming the aspect. Always English, whatever the lang parameter says. Use transitPlanetLocalized for anything a reader sees.
798
870
  */
799
871
  transitPlanet: string;
800
872
  /**
801
- * Natal planet being aspected.
873
+ * Transiting planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
874
+ */
875
+ transitPlanetLocalized?: string;
876
+ /**
877
+ * Natal planet being aspected. Always English, whatever the lang parameter says. Use natalPlanetLocalized for anything a reader sees.
802
878
  */
803
879
  natalPlanet: string;
804
880
  /**
805
- * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.).
881
+ * Natal planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
882
+ */
883
+ natalPlanetLocalized?: string;
884
+ /**
885
+ * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.). Always English, whatever the lang parameter says. Use typeLocalized for anything a reader sees.
806
886
  */
807
887
  type: string;
888
+ /**
889
+ * Aspect type name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
890
+ */
891
+ typeLocalized?: string;
808
892
  /**
809
893
  * Exact angle of this aspect type in degrees.
810
894
  */
@@ -1108,6 +1192,10 @@ export type RelocationChartResponse = {
1108
1192
  * Degree within the zodiac sign on this cusp (0-29.999).
1109
1193
  */
1110
1194
  degree: number;
1195
+ /**
1196
+ * Zodiac sign name on this cusp in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1197
+ */
1198
+ signLocalized?: string;
1111
1199
  }>;
1112
1200
  /**
1113
1201
  * House system used for the relocated chart (placidus, whole-sign, equal, or koch). Quadrant systems fall back to whole-sign above the polar circle.
@@ -1118,9 +1206,13 @@ export type RelocationChartResponse = {
1118
1206
  */
1119
1207
  ascendant: {
1120
1208
  /**
1121
- * Tropical zodiac sign on this relocated angle.
1209
+ * Tropical zodiac sign on this relocated angle. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
1122
1210
  */
1123
1211
  sign: string;
1212
+ /**
1213
+ * Zodiac sign name on this angle in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1214
+ */
1215
+ signLocalized?: string;
1124
1216
  /**
1125
1217
  * Degree within the zodiac sign on this angle (0-29.999).
1126
1218
  */
@@ -1135,9 +1227,13 @@ export type RelocationChartResponse = {
1135
1227
  */
1136
1228
  midheaven: {
1137
1229
  /**
1138
- * Tropical zodiac sign on this relocated angle.
1230
+ * Tropical zodiac sign on this relocated angle. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
1139
1231
  */
1140
1232
  sign: string;
1233
+ /**
1234
+ * Zodiac sign name on this angle in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1235
+ */
1236
+ signLocalized?: string;
1141
1237
  /**
1142
1238
  * Degree within the zodiac sign on this angle (0-29.999).
1143
1239
  */
@@ -1163,6 +1259,10 @@ export type RelocationChartResponse = {
1163
1259
  * Absolute ecliptic longitude of the Vertex (0-360).
1164
1260
  */
1165
1261
  longitude: number;
1262
+ /**
1263
+ * Vertex sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1264
+ */
1265
+ signLocalized?: string;
1166
1266
  };
1167
1267
  /**
1168
1268
  * How relocation reshapes the chart: Ascendant shift, planets that change house, angular planets, and the move geometry from the birthplace.
@@ -1177,9 +1277,13 @@ export type RelocationChartResponse = {
1177
1277
  */
1178
1278
  planetsChangedHouse: Array<{
1179
1279
  /**
1180
- * Body that occupies a different house after relocation.
1280
+ * Body that occupies a different house after relocation. Always English, whatever the lang parameter says. Use planetLocalized for anything a reader sees.
1181
1281
  */
1182
1282
  planet: string;
1283
+ /**
1284
+ * Body name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1285
+ */
1286
+ planetLocalized?: string;
1183
1287
  /**
1184
1288
  * House this body occupied in the birthplace chart (1-12).
1185
1289
  */
@@ -1190,9 +1294,13 @@ export type RelocationChartResponse = {
1190
1294
  relocatedHouse: number;
1191
1295
  }>;
1192
1296
  /**
1193
- * Bodies within three degrees of a relocated angle (Ascendant, Imum Coeli, Descendant, or Midheaven), where their influence is strongest at this location.
1297
+ * Bodies within three degrees of a relocated angle (Ascendant, Imum Coeli, Descendant, or Midheaven), where their influence is strongest at this location. Always English, whatever the lang parameter says. Use angularPlanetsLocalized for anything a reader sees.
1194
1298
  */
1195
1299
  angularPlanets: Array<string>;
1300
+ /**
1301
+ * The same angular bodies in the requested language, for display only. Index aligned with angularPlanets. Present only when lang is set to a language other than English.
1302
+ */
1303
+ angularPlanetsLocalized?: Array<string>;
1196
1304
  /**
1197
1305
  * Great-circle distance from the birthplace to the new location in kilometers.
1198
1306
  */
@@ -1246,6 +1354,14 @@ export type RelocationPlanet = {
1246
1354
  * Whether the planet appears to move backward from Earth perspective. Retrograde periods signal review and introspection.
1247
1355
  */
1248
1356
  isRetrograde: boolean;
1357
+ /**
1358
+ * Body name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1359
+ */
1360
+ nameLocalized?: string;
1361
+ /**
1362
+ * Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1363
+ */
1364
+ signLocalized?: string;
1249
1365
  /**
1250
1366
  * Relocated placement interpretation. The planet keeps its natal sign, so this reads its meaning through the new house it occupies at this location.
1251
1367
  */
@@ -1845,17 +1961,25 @@ export type ProgressionsResponse = {
1845
1961
  */
1846
1962
  planets: Array<{
1847
1963
  /**
1848
- * Body name in canonical English. One of the 10 classical planets, the lunar nodes, Chiron, or Black Moon Lilith.
1964
+ * Body name in canonical English. One of the 10 classical planets, the lunar nodes, Chiron, or Black Moon Lilith. Unchanged by the lang parameter, so it stays safe to compare against in code. Use nameLocalized for anything a reader sees.
1849
1965
  */
1850
1966
  name: string;
1967
+ /**
1968
+ * Body name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1969
+ */
1970
+ nameLocalized?: string;
1851
1971
  /**
1852
1972
  * Progressed tropical ecliptic longitude in degrees (0 to 360).
1853
1973
  */
1854
1974
  longitude: number;
1855
1975
  /**
1856
- * Tropical zodiac sign the progressed body falls in.
1976
+ * Tropical zodiac sign the progressed body falls in. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
1857
1977
  */
1858
1978
  sign: string;
1979
+ /**
1980
+ * Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
1981
+ */
1982
+ signLocalized?: string;
1859
1983
  /**
1860
1984
  * Degree of the progressed body within its zodiac sign (0 to 29.999).
1861
1985
  */
@@ -1886,9 +2010,13 @@ export type ProgressionsResponse = {
1886
2010
  */
1887
2011
  longitude: number;
1888
2012
  /**
1889
- * Tropical zodiac sign the progressed angle falls in.
2013
+ * Tropical zodiac sign the progressed angle falls in. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
1890
2014
  */
1891
2015
  sign: string;
2016
+ /**
2017
+ * Zodiac sign name on this angle in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
2018
+ */
2019
+ signLocalized?: string;
1892
2020
  /**
1893
2021
  * Degree of the progressed angle within its zodiac sign (0 to 29.999).
1894
2022
  */
@@ -1903,9 +2031,13 @@ export type ProgressionsResponse = {
1903
2031
  */
1904
2032
  longitude: number;
1905
2033
  /**
1906
- * Tropical zodiac sign the progressed angle falls in.
2034
+ * Tropical zodiac sign the progressed angle falls in. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
1907
2035
  */
1908
2036
  sign: string;
2037
+ /**
2038
+ * Zodiac sign name on this angle in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
2039
+ */
2040
+ signLocalized?: string;
1909
2041
  /**
1910
2042
  * Degree of the progressed angle within its zodiac sign (0 to 29.999).
1911
2043
  */
@@ -8347,6 +8479,191 @@ export type PostAstrologyPlanetsResponses = {
8347
8479
 
8348
8480
  export type PostAstrologyPlanetsResponse = PostAstrologyPlanetsResponses[keyof PostAstrologyPlanetsResponses];
8349
8481
 
8482
+ export type PostAstrologyPlanetsMonthlyData = {
8483
+ body?: {
8484
+ /**
8485
+ * Year for the monthly ephemeris (1900-2100). Defaults to the current year (UTC).
8486
+ */
8487
+ year?: number;
8488
+ /**
8489
+ * Month number (1-12) for the ephemeris. Defaults to the current month (UTC).
8490
+ */
8491
+ month?: number;
8492
+ };
8493
+ path?: never;
8494
+ query?: {
8495
+ /**
8496
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
8497
+ */
8498
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
8499
+ };
8500
+ url: '/astrology/planets/monthly';
8501
+ };
8502
+
8503
+ export type PostAstrologyPlanetsMonthlyErrors = {
8504
+ /**
8505
+ * Validation error. `issues[]` lists every failed field.
8506
+ */
8507
+ 400: {
8508
+ /**
8509
+ * First issue summary.
8510
+ */
8511
+ error: string;
8512
+ code: 'validation_error';
8513
+ /**
8514
+ * Every validation failure. Use this to rebuild a valid request.
8515
+ */
8516
+ issues: Array<{
8517
+ /**
8518
+ * Dot-separated field path, or "(root)" for top-level.
8519
+ */
8520
+ path: string;
8521
+ message: string;
8522
+ /**
8523
+ * Zod issue code (invalid_type, too_small, too_big, invalid_string, ...).
8524
+ */
8525
+ code?: string;
8526
+ /**
8527
+ * Expected type for invalid_type.
8528
+ */
8529
+ expected?: string;
8530
+ /**
8531
+ * Minimum bound for too_small issues.
8532
+ */
8533
+ minimum?: number | string;
8534
+ /**
8535
+ * Maximum bound for too_big issues.
8536
+ */
8537
+ maximum?: number | string;
8538
+ inclusive?: boolean;
8539
+ /**
8540
+ * Format name for string issues (regex, email, url, uuid).
8541
+ */
8542
+ format?: string;
8543
+ /**
8544
+ * Regex pattern when format is regex.
8545
+ */
8546
+ pattern?: string;
8547
+ }>;
8548
+ };
8549
+ /**
8550
+ * Invalid or missing API key
8551
+ */
8552
+ 401: {
8553
+ /**
8554
+ * Human-readable error message. May change wording.
8555
+ */
8556
+ error: string;
8557
+ /**
8558
+ * Machine-readable error code. Stable identifier.
8559
+ */
8560
+ code: string;
8561
+ };
8562
+ /**
8563
+ * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
8564
+ */
8565
+ 405: {
8566
+ error: string;
8567
+ code: 'method_not_allowed';
8568
+ /**
8569
+ * Allowed HTTP methods for this path. Mirrors the Allow response header.
8570
+ */
8571
+ allow: Array<string>;
8572
+ /**
8573
+ * Link to the product page for this domain.
8574
+ */
8575
+ docs?: string;
8576
+ };
8577
+ /**
8578
+ * Monthly rate limit exceeded
8579
+ */
8580
+ 429: {
8581
+ /**
8582
+ * Human-readable error message. May change wording.
8583
+ */
8584
+ error: string;
8585
+ /**
8586
+ * Machine-readable error code. Stable identifier.
8587
+ */
8588
+ code: string;
8589
+ };
8590
+ /**
8591
+ * Internal server error
8592
+ */
8593
+ 500: {
8594
+ /**
8595
+ * Human-readable error message. May change wording.
8596
+ */
8597
+ error: string;
8598
+ /**
8599
+ * Machine-readable error code. Stable identifier.
8600
+ */
8601
+ code: string;
8602
+ };
8603
+ };
8604
+
8605
+ export type PostAstrologyPlanetsMonthlyError = PostAstrologyPlanetsMonthlyErrors[keyof PostAstrologyPlanetsMonthlyErrors];
8606
+
8607
+ export type PostAstrologyPlanetsMonthlyResponses = {
8608
+ /**
8609
+ * Monthly ephemeris data
8610
+ */
8611
+ 200: {
8612
+ /**
8613
+ * Year of the ephemeris. Echoes the year that was requested, or the current UTC year when it was omitted.
8614
+ */
8615
+ year: number;
8616
+ /**
8617
+ * Month of the ephemeris. Echoes the month that was requested, or the current UTC month when it was omitted.
8618
+ */
8619
+ month: number;
8620
+ /**
8621
+ * Daily planetary position entries for the entire month.
8622
+ */
8623
+ days: Array<{
8624
+ /**
8625
+ * Date in YYYY-MM-DD format.
8626
+ */
8627
+ date: string;
8628
+ /**
8629
+ * Tropical positions of all 14 Western bodies on this date at noon UTC.
8630
+ */
8631
+ positions: Array<{
8632
+ /**
8633
+ * Body name, one of the 14 bodies Western astrology reads: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, North Node, South Node, Chiron, Black Moon Lilith. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use planetLocalized for anything a reader sees.
8634
+ */
8635
+ planet: string;
8636
+ /**
8637
+ * Body name in the requested language, for display. Present only when lang is set to a language other than English, since in English it would repeat planet exactly.
8638
+ */
8639
+ planetLocalized?: string;
8640
+ /**
8641
+ * Tropical ecliptic longitude in degrees (0-360), measured from the vernal equinox. This is the Western zodiac, not the sidereal one, so the two differ by the ayanamsa of roughly 24 degrees.
8642
+ */
8643
+ longitude: number;
8644
+ /**
8645
+ * Tropical zodiac sign the body occupies on this date. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use signLocalized for anything a reader sees.
8646
+ */
8647
+ sign: string;
8648
+ /**
8649
+ * Zodiac sign name in the requested language, for display. Present only when lang is set to a language other than English, since in English it would repeat sign exactly.
8650
+ */
8651
+ signLocalized?: string;
8652
+ /**
8653
+ * Degrees traversed within the current sign (0-30). Useful for precise transit tracking and for printing a position as sign plus degree.
8654
+ */
8655
+ degreeInSign: number;
8656
+ /**
8657
+ * Whether the body is in apparent retrograde motion on this date. The lunar nodes are always retrograde and Black Moon Lilith is always direct.
8658
+ */
8659
+ isRetrograde: boolean;
8660
+ }>;
8661
+ }>;
8662
+ };
8663
+ };
8664
+
8665
+ export type PostAstrologyPlanetsMonthlyResponse = PostAstrologyPlanetsMonthlyResponses[keyof PostAstrologyPlanetsMonthlyResponses];
8666
+
8350
8667
  export type GetAstrologyMoonPhaseCurrentData = {
8351
8668
  body?: never;
8352
8669
  path?: never;
@@ -9044,38 +9361,58 @@ export type PostAstrologySynastryResponses = {
9044
9361
  */
9045
9362
  ascendant: {
9046
9363
  /**
9047
- * Ascendant (rising sign) of this person.
9364
+ * Ascendant (rising sign) of this person. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
9048
9365
  */
9049
9366
  sign: string;
9367
+ /**
9368
+ * Ascendant sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9369
+ */
9370
+ signLocalized?: string;
9050
9371
  /**
9051
9372
  * Degree within the Ascendant sign (0-29.999).
9052
9373
  */
9053
9374
  degree: number;
9054
9375
  };
9055
9376
  /**
9056
- * Sun sign (zodiac sign) of this person. Core identity and ego expression.
9377
+ * Sun sign (zodiac sign) of this person. Core identity and ego expression. Always English, whatever the lang parameter says. Use sunSignLocalized for anything a reader sees.
9057
9378
  */
9058
9379
  sunSign: string;
9059
9380
  /**
9060
- * Moon sign of this person. Emotional nature and inner needs.
9381
+ * Sun sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9382
+ */
9383
+ sunSignLocalized?: string;
9384
+ /**
9385
+ * Moon sign of this person. Emotional nature and inner needs. Always English, whatever the lang parameter says. Use moonSignLocalized for anything a reader sees.
9061
9386
  */
9062
9387
  moonSign: string;
9388
+ /**
9389
+ * Moon sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9390
+ */
9391
+ moonSignLocalized?: string;
9063
9392
  /**
9064
9393
  * 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.
9065
9394
  */
9066
9395
  planets: Array<{
9067
9396
  /**
9068
- * Planet or point name. Matches the names used in interAspects.
9397
+ * Planet or point name. Matches the names used in interAspects. Always English, whatever the lang parameter says. Use nameLocalized for anything a reader sees.
9069
9398
  */
9070
9399
  name: string;
9400
+ /**
9401
+ * Planet or point name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9402
+ */
9403
+ nameLocalized?: string;
9071
9404
  /**
9072
9405
  * Ecliptic longitude in degrees (0-360) measured from 0 Aries. This is the value a wheel plots.
9073
9406
  */
9074
9407
  longitude: number;
9075
9408
  /**
9076
- * Zodiac sign containing the planet.
9409
+ * Zodiac sign containing the planet. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
9077
9410
  */
9078
9411
  sign: string;
9412
+ /**
9413
+ * Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9414
+ */
9415
+ signLocalized?: string;
9079
9416
  /**
9080
9417
  * Degree within the sign (0-29.999).
9081
9418
  */
@@ -9103,38 +9440,58 @@ export type PostAstrologySynastryResponses = {
9103
9440
  */
9104
9441
  ascendant: {
9105
9442
  /**
9106
- * Ascendant (rising sign) of this person.
9443
+ * Ascendant (rising sign) of this person. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
9107
9444
  */
9108
9445
  sign: string;
9446
+ /**
9447
+ * Ascendant sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9448
+ */
9449
+ signLocalized?: string;
9109
9450
  /**
9110
9451
  * Degree within the Ascendant sign (0-29.999).
9111
9452
  */
9112
9453
  degree: number;
9113
9454
  };
9114
9455
  /**
9115
- * Sun sign (zodiac sign) of this person. Core identity and ego expression.
9456
+ * Sun sign (zodiac sign) of this person. Core identity and ego expression. Always English, whatever the lang parameter says. Use sunSignLocalized for anything a reader sees.
9116
9457
  */
9117
9458
  sunSign: string;
9118
9459
  /**
9119
- * Moon sign of this person. Emotional nature and inner needs.
9460
+ * Sun sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9461
+ */
9462
+ sunSignLocalized?: string;
9463
+ /**
9464
+ * Moon sign of this person. Emotional nature and inner needs. Always English, whatever the lang parameter says. Use moonSignLocalized for anything a reader sees.
9120
9465
  */
9121
9466
  moonSign: string;
9467
+ /**
9468
+ * Moon sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9469
+ */
9470
+ moonSignLocalized?: string;
9122
9471
  /**
9123
9472
  * 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.
9124
9473
  */
9125
9474
  planets: Array<{
9126
9475
  /**
9127
- * Planet or point name. Matches the names used in interAspects.
9476
+ * Planet or point name. Matches the names used in interAspects. Always English, whatever the lang parameter says. Use nameLocalized for anything a reader sees.
9128
9477
  */
9129
9478
  name: string;
9479
+ /**
9480
+ * Planet or point name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9481
+ */
9482
+ nameLocalized?: string;
9130
9483
  /**
9131
9484
  * Ecliptic longitude in degrees (0-360) measured from 0 Aries. This is the value a wheel plots.
9132
9485
  */
9133
9486
  longitude: number;
9134
9487
  /**
9135
- * Zodiac sign containing the planet.
9488
+ * Zodiac sign containing the planet. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
9136
9489
  */
9137
9490
  sign: string;
9491
+ /**
9492
+ * Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9493
+ */
9494
+ signLocalized?: string;
9138
9495
  /**
9139
9496
  * Degree within the sign (0-29.999).
9140
9497
  */
@@ -9158,17 +9515,29 @@ export type PostAstrologySynastryResponses = {
9158
9515
  */
9159
9516
  interAspects: Array<{
9160
9517
  /**
9161
- * Planet from person 1 chart.
9518
+ * Planet from person 1 chart. Always English, whatever the lang parameter says. Use planet1Localized for anything a reader sees.
9162
9519
  */
9163
9520
  planet1: string;
9164
9521
  /**
9165
- * Planet from person 2 chart.
9522
+ * Person 1 planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9523
+ */
9524
+ planet1Localized?: string;
9525
+ /**
9526
+ * Planet from person 2 chart. Always English, whatever the lang parameter says. Use planet2Localized for anything a reader sees.
9166
9527
  */
9167
9528
  planet2: string;
9168
9529
  /**
9169
- * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.).
9530
+ * Person 2 planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9531
+ */
9532
+ planet2Localized?: string;
9533
+ /**
9534
+ * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.). Always English, whatever the lang parameter says. Use typeLocalized for anything a reader sees.
9170
9535
  */
9171
9536
  type: string;
9537
+ /**
9538
+ * Aspect type name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
9539
+ */
9540
+ typeLocalized?: string;
9172
9541
  /**
9173
9542
  * Exact angle of this aspect type in degrees.
9174
9543
  */
@@ -10017,6 +10386,14 @@ export type PostAstrologyTransitAspectsResponses = {
10017
10386
  * Whether the planet appears to move backward from Earth perspective. Retrograde periods signal review and introspection.
10018
10387
  */
10019
10388
  isRetrograde: boolean;
10389
+ /**
10390
+ * Body name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10391
+ */
10392
+ nameLocalized?: string;
10393
+ /**
10394
+ * Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10395
+ */
10396
+ signLocalized?: string;
10020
10397
  }>;
10021
10398
  /**
10022
10399
  * Natal (birth chart) planetary positions used as the baseline for transit aspect comparison, each placed in its natal house.
@@ -10054,6 +10431,14 @@ export type PostAstrologyTransitAspectsResponses = {
10054
10431
  * Whether the planet appears to move backward from Earth perspective. Retrograde periods signal review and introspection.
10055
10432
  */
10056
10433
  isRetrograde: boolean;
10434
+ /**
10435
+ * Body name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10436
+ */
10437
+ nameLocalized?: string;
10438
+ /**
10439
+ * Zodiac sign name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10440
+ */
10441
+ signLocalized?: string;
10057
10442
  }>;
10058
10443
  /**
10059
10444
  * Transit-to-natal aspects with interpretations, strength ratings, and guidance. Each aspect represents a transiting planet forming a geometric angle to a natal planet.
@@ -10091,6 +10476,18 @@ export type PostAstrologyTransitAspectsResponses = {
10091
10476
  * Aspect nature. Harmonious (trine, sextile) flows easily. Challenging (square, opposition) creates tension and growth. Neutral (conjunction) blends energies.
10092
10477
  */
10093
10478
  interpretation: 'harmonious' | 'challenging' | 'neutral';
10479
+ /**
10480
+ * First planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10481
+ */
10482
+ planet1Localized?: string;
10483
+ /**
10484
+ * Second planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10485
+ */
10486
+ planet2Localized?: string;
10487
+ /**
10488
+ * Aspect type name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10489
+ */
10490
+ typeLocalized?: string;
10094
10491
  transitInterpretation?: {
10095
10492
  /**
10096
10493
  * Narrative interpretation of this transit aspect and its life impact.
@@ -10170,6 +10567,18 @@ export type PostAstrologyTransitAspectsResponses = {
10170
10567
  * Aspect nature. Harmonious (trine, sextile) flows easily. Challenging (square, opposition) creates tension and growth. Neutral (conjunction) blends energies.
10171
10568
  */
10172
10569
  interpretation: 'harmonious' | 'challenging' | 'neutral';
10570
+ /**
10571
+ * First planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10572
+ */
10573
+ planet1Localized?: string;
10574
+ /**
10575
+ * Second planet name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10576
+ */
10577
+ planet2Localized?: string;
10578
+ /**
10579
+ * Aspect type name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
10580
+ */
10581
+ typeLocalized?: string;
10173
10582
  } | null;
10174
10583
  /**
10175
10584
  * Transit aspect counts grouped by aspect type (conjunction, trine, square, opposition, sextile, etc.). Useful for quickly assessing the transit weather.
@@ -14816,20 +15225,25 @@ export type PostVedicAstrologyPlanetaryPositionsResponse = PostVedicAstrologyPla
14816
15225
  export type PostVedicAstrologyPlanetaryPositionsMonthlyData = {
14817
15226
  body?: {
14818
15227
  /**
14819
- * Year for monthly ephemeris (1900-2100).
15228
+ * Year for monthly ephemeris (1900-2100). Defaults to the current year (UTC).
14820
15229
  */
14821
- year: number;
15230
+ year?: number;
14822
15231
  /**
14823
- * Month number (1-12) for ephemeris.
15232
+ * Month number (1-12) for ephemeris. Defaults to the current month (UTC).
14824
15233
  */
14825
- month: number;
15234
+ month?: number;
14826
15235
  /**
14827
15236
  * Coordinate system for longitude output. "sidereal" (Nirayana) uses Lahiri ayanamsa - standard for Vedic astrology. "tropical" (Sayana) uses raw ecliptic longitude matching Western astrology. Defaults to "sidereal".
14828
15237
  */
14829
15238
  coordinateSystem?: 'sidereal' | 'tropical';
14830
15239
  };
14831
15240
  path?: never;
14832
- query?: never;
15241
+ query?: {
15242
+ /**
15243
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
15244
+ */
15245
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
15246
+ };
14833
15247
  url: '/vedic-astrology/planetary-positions/monthly';
14834
15248
  };
14835
15249
 
@@ -14943,11 +15357,11 @@ export type PostVedicAstrologyPlanetaryPositionsMonthlyResponses = {
14943
15357
  */
14944
15358
  200: {
14945
15359
  /**
14946
- * Year of the ephemeris.
15360
+ * Year of the ephemeris. Echoes the year that was requested, or the current UTC year when it was omitted.
14947
15361
  */
14948
15362
  year: number;
14949
15363
  /**
14950
- * Month of the ephemeris.
15364
+ * Month of the ephemeris. Echoes the month that was requested, or the current UTC month when it was omitted.
14951
15365
  */
14952
15366
  month: number;
14953
15367
  /**
@@ -14963,17 +15377,25 @@ export type PostVedicAstrologyPlanetaryPositionsMonthlyResponses = {
14963
15377
  */
14964
15378
  positions: Array<{
14965
15379
  /**
14966
- * Planet name, one of the Navagraha (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu).
15380
+ * Planet name, one of the Navagraha (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu). Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use planetLocalized for anything a reader sees.
14967
15381
  */
14968
15382
  planet: string;
15383
+ /**
15384
+ * Planet name in the requested language, for display. Present only when lang is set to a language other than English, since in English it would repeat planet exactly. Rahu and Ketu are rendered as the lunar nodes they are, so Spanish returns Nodo Norte and Nodo Sur while Hindi returns their Sanskrit names.
15385
+ */
15386
+ planetLocalized?: string;
14969
15387
  /**
14970
15388
  * Sidereal ecliptic longitude in degrees (0-360) using Lahiri ayanamsa.
14971
15389
  */
14972
15390
  longitude: number;
14973
15391
  /**
14974
- * Zodiac sign (rashi) the planet occupies on this date.
15392
+ * Zodiac sign (rashi) the planet occupies on this date. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use signLocalized for anything a reader sees.
14975
15393
  */
14976
15394
  sign: string;
15395
+ /**
15396
+ * Zodiac sign name in the requested language, for display. Present only when lang is set to a language other than English, since in English it would repeat sign exactly.
15397
+ */
15398
+ signLocalized?: string;
14977
15399
  /**
14978
15400
  * Degrees traversed within the current sign (0-30). Useful for precise transit tracking.
14979
15401
  */
@@ -21433,13 +21855,13 @@ export type PostVedicAstrologyAspectsResponse = PostVedicAstrologyAspectsRespons
21433
21855
  export type PostVedicAstrologyAspectsMonthlyData = {
21434
21856
  body?: {
21435
21857
  /**
21436
- * Year for monthly analysis (1900-2100).
21858
+ * Year for monthly analysis (1900-2100). Defaults to the current year (UTC).
21437
21859
  */
21438
- year: number;
21860
+ year?: number;
21439
21861
  /**
21440
- * Month number (1-12).
21862
+ * Month number (1-12). Defaults to the current month (UTC).
21441
21863
  */
21442
- month: number;
21864
+ month?: number;
21443
21865
  /**
21444
21866
  * Timezone offset from UTC in hours. Output times are converted to this timezone. Defaults to 0 (UTC).
21445
21867
  */
@@ -21450,7 +21872,12 @@ export type PostVedicAstrologyAspectsMonthlyData = {
21450
21872
  coordinateSystem?: 'sidereal' | 'tropical';
21451
21873
  };
21452
21874
  path?: never;
21453
- query?: never;
21875
+ query?: {
21876
+ /**
21877
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
21878
+ */
21879
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
21880
+ };
21454
21881
  url: '/vedic-astrology/aspects/monthly';
21455
21882
  };
21456
21883
 
@@ -21564,11 +21991,11 @@ export type PostVedicAstrologyAspectsMonthlyResponses = {
21564
21991
  */
21565
21992
  200: {
21566
21993
  /**
21567
- * Year of the aspect analysis.
21994
+ * Year of the aspect analysis. Echoes the year that was requested, or the current UTC year when it was omitted.
21568
21995
  */
21569
21996
  year: number;
21570
21997
  /**
21571
- * Month of the aspect analysis.
21998
+ * Month of the aspect analysis. Echoes the month that was requested, or the current UTC month when it was omitted.
21572
21999
  */
21573
22000
  month: number;
21574
22001
  /**
@@ -21580,13 +22007,21 @@ export type PostVedicAstrologyAspectsMonthlyResponses = {
21580
22007
  */
21581
22008
  events: Array<{
21582
22009
  /**
21583
- * First planet forming the aspect. One of the Navagraha, Sun through Ketu.
22010
+ * First planet forming the aspect. One of the Navagraha, Sun through Ketu. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use planet1Localized for anything a reader sees.
21584
22011
  */
21585
22012
  planet1: string;
21586
22013
  /**
21587
- * Second planet forming the aspect.
22014
+ * First planet name in the requested language, for display. Present only when lang is set to a language other than English, since in English it would repeat planet1 exactly.
22015
+ */
22016
+ planet1Localized?: string;
22017
+ /**
22018
+ * Second planet forming the aspect. Always English, whatever the lang parameter says. Use planet2Localized for anything a reader sees.
21588
22019
  */
21589
22020
  planet2: string;
22021
+ /**
22022
+ * Second planet name in the requested language, for display. Present only when lang is set to a language other than English.
22023
+ */
22024
+ planet2Localized?: string;
21590
22025
  /**
21591
22026
  * Aspect type. major: conjunction (0 deg), opposition (180 deg), trine (120 deg), square (90 deg), sextile (60 deg). Minor: vigintile (18 deg), semi-sextile (30 deg), undecile (32.73 deg), semi-quintile (36 deg), novile (40 deg), semi-square (45 deg), septile (51.43 deg), quintile (72 deg), binovile (80 deg), centile (100 deg), biseptile (102.86 deg), tredecile (108 deg), sesqui-square (135 deg), bi-quintile (144 deg), quincunx (150 deg), triseptile (154.29 deg), quadranovile (160 deg).
21592
22027
  */
@@ -21628,13 +22063,13 @@ export type PostVedicAstrologyAspectsMonthlyResponse = PostVedicAstrologyAspects
21628
22063
  export type PostVedicAstrologyAspectsLunarData = {
21629
22064
  body?: {
21630
22065
  /**
21631
- * Year for monthly analysis (1900-2100).
22066
+ * Year for monthly analysis (1900-2100). Defaults to the current year (UTC).
21632
22067
  */
21633
- year: number;
22068
+ year?: number;
21634
22069
  /**
21635
- * Month number (1-12).
22070
+ * Month number (1-12). Defaults to the current month (UTC).
21636
22071
  */
21637
- month: number;
22072
+ month?: number;
21638
22073
  /**
21639
22074
  * Timezone offset from UTC in hours. Output times are converted to this timezone. Defaults to 0 (UTC).
21640
22075
  */
@@ -21645,7 +22080,12 @@ export type PostVedicAstrologyAspectsLunarData = {
21645
22080
  coordinateSystem?: 'sidereal' | 'tropical';
21646
22081
  };
21647
22082
  path?: never;
21648
- query?: never;
22083
+ query?: {
22084
+ /**
22085
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
22086
+ */
22087
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
22088
+ };
21649
22089
  url: '/vedic-astrology/aspects/lunar';
21650
22090
  };
21651
22091
 
@@ -21759,11 +22199,11 @@ export type PostVedicAstrologyAspectsLunarResponses = {
21759
22199
  */
21760
22200
  200: {
21761
22201
  /**
21762
- * Year of the lunar aspect analysis.
22202
+ * Year of the lunar aspect analysis. Echoes the year that was requested, or the current UTC year when it was omitted.
21763
22203
  */
21764
22204
  year: number;
21765
22205
  /**
21766
- * Month of the lunar aspect analysis.
22206
+ * Month of the lunar aspect analysis. Echoes the month that was requested, or the current UTC month when it was omitted.
21767
22207
  */
21768
22208
  month: number;
21769
22209
  /**
@@ -21775,9 +22215,13 @@ export type PostVedicAstrologyAspectsLunarResponses = {
21775
22215
  */
21776
22216
  events: Array<{
21777
22217
  /**
21778
- * Planet that the Moon forms an aspect with.
22218
+ * Planet that the Moon forms an aspect with. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use planetLocalized for anything a reader sees.
21779
22219
  */
21780
22220
  planet: string;
22221
+ /**
22222
+ * Planet name in the requested language, for display. Present only when lang is set to a language other than English, since in English it would repeat planet exactly.
22223
+ */
22224
+ planetLocalized?: string;
21781
22225
  /**
21782
22226
  * Aspect type. major: conjunction, opposition, trine, square, sextile. Minor: vigintile, semi-sextile, undecile, semi-quintile, novile, semi-square, septile, quintile, binovile, centile, biseptile, tredecile, sesqui-square, bi-quintile, quincunx, triseptile, quadranovile.
21783
22227
  */
@@ -22090,13 +22534,13 @@ export type PostVedicAstrologyTransitResponse = PostVedicAstrologyTransitRespons
22090
22534
  export type PostVedicAstrologyTransitMonthlyData = {
22091
22535
  body?: {
22092
22536
  /**
22093
- * Year for monthly transit analysis (1900-2100).
22537
+ * Year for monthly transit analysis (1900-2100). Defaults to the current year (UTC).
22094
22538
  */
22095
- year: number;
22539
+ year?: number;
22096
22540
  /**
22097
- * Month number (1-12) for transit analysis.
22541
+ * Month number (1-12) for transit analysis. Defaults to the current month (UTC).
22098
22542
  */
22099
- month: number;
22543
+ month?: number;
22100
22544
  /**
22101
22545
  * Timezone offset from UTC in hours. Output times are converted to this timezone. Defaults to 0 (UTC).
22102
22546
  */
@@ -22107,7 +22551,12 @@ export type PostVedicAstrologyTransitMonthlyData = {
22107
22551
  coordinateSystem?: 'sidereal' | 'tropical';
22108
22552
  };
22109
22553
  path?: never;
22110
- query?: never;
22554
+ query?: {
22555
+ /**
22556
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
22557
+ */
22558
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
22559
+ };
22111
22560
  url: '/vedic-astrology/transit/monthly';
22112
22561
  };
22113
22562
 
@@ -22221,25 +22670,37 @@ export type PostVedicAstrologyTransitMonthlyResponses = {
22221
22670
  */
22222
22671
  200: {
22223
22672
  /**
22224
- * Year of the monthly transit analysis.
22673
+ * Year of the monthly transit analysis. Echoes the year that was requested, or the current UTC year when it was omitted.
22225
22674
  */
22226
22675
  year: number;
22227
22676
  /**
22228
- * Month of the monthly transit analysis.
22677
+ * Month of the monthly transit analysis. Echoes the month that was requested, or the current UTC month when it was omitted.
22229
22678
  */
22230
22679
  month: number;
22680
+ /**
22681
+ * Timezone offset from UTC in hours that the event dates and times are reported in. Echoes the requested timezone.
22682
+ */
22683
+ timezone: number;
22231
22684
  /**
22232
22685
  * Planetary positions at the beginning of the month (day 1, 00:00 UTC).
22233
22686
  */
22234
22687
  startingPositions: Array<{
22235
22688
  /**
22236
- * Planet (graha) name. One of the 9 Navagraha used in Vedic transit (Gochar) analysis.
22689
+ * Planet (graha) name. One of the 9 Navagraha used in Vedic transit (Gochar) analysis. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use planetLocalized for anything a reader sees.
22237
22690
  */
22238
22691
  planet: string;
22239
22692
  /**
22240
- * Zodiac sign (rashi) the planet occupies at the start of the month.
22693
+ * Planet name in the requested language, for display. Present only when lang is set to a language other than English.
22694
+ */
22695
+ planetLocalized?: string;
22696
+ /**
22697
+ * Zodiac sign (rashi) the planet occupies at the start of the month. Always English. Use signLocalized for anything a reader sees.
22241
22698
  */
22242
22699
  sign: string;
22700
+ /**
22701
+ * Zodiac sign name in the requested language, for display. Present only when lang is set to a language other than English.
22702
+ */
22703
+ signLocalized?: string;
22243
22704
  /**
22244
22705
  * Sidereal longitude at the start of the month.
22245
22706
  */
@@ -22250,17 +22711,29 @@ export type PostVedicAstrologyTransitMonthlyResponses = {
22250
22711
  */
22251
22712
  transitEvents: Array<{
22252
22713
  /**
22253
- * Planet that changes sign (rashi) during this month. One of the Navagraha: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu.
22714
+ * Planet that changes sign (rashi) during this month. One of the Navagraha: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use planetLocalized for anything a reader sees.
22254
22715
  */
22255
22716
  planet: string;
22256
22717
  /**
22257
- * Zodiac sign the planet is leaving (previous rashi).
22718
+ * Planet name in the requested language, for display. Present only when lang is set to a language other than English, since in English it would repeat planet exactly.
22719
+ */
22720
+ planetLocalized?: string;
22721
+ /**
22722
+ * Zodiac sign the planet is leaving (previous rashi). Always English. Use fromSignLocalized for anything a reader sees.
22258
22723
  */
22259
22724
  fromSign: string;
22260
22725
  /**
22261
- * Zodiac sign the planet is entering (new rashi transit).
22726
+ * Name of the sign being left, in the requested language, for display. Present only when lang is set to a language other than English.
22727
+ */
22728
+ fromSignLocalized?: string;
22729
+ /**
22730
+ * Zodiac sign the planet is entering (new rashi transit). Always English. Use toSignLocalized for anything a reader sees.
22262
22731
  */
22263
22732
  toSign: string;
22733
+ /**
22734
+ * Name of the sign being entered, in the requested language, for display. Present only when lang is set to a language other than English.
22735
+ */
22736
+ toSignLocalized?: string;
22264
22737
  /**
22265
22738
  * Date of the sign change (YYYY-MM-DD). Adjusted to requested timezone.
22266
22739
  */
@@ -22482,20 +22955,25 @@ export type PostVedicAstrologyParallelsResponse = PostVedicAstrologyParallelsRes
22482
22955
  export type PostVedicAstrologyParallelsMonthlyData = {
22483
22956
  body?: {
22484
22957
  /**
22485
- * Year for monthly parallel analysis (1900-2100).
22958
+ * Year for monthly parallel analysis (1900-2100). Defaults to the current year (UTC).
22486
22959
  */
22487
- year: number;
22960
+ year?: number;
22488
22961
  /**
22489
- * Month number (1-12) for parallel analysis.
22962
+ * Month number (1-12) for parallel analysis. Defaults to the current month (UTC).
22490
22963
  */
22491
- month: number;
22964
+ month?: number;
22492
22965
  /**
22493
22966
  * Timezone offset from UTC in hours. Output times are converted to this timezone. Defaults to 0 (UTC).
22494
22967
  */
22495
22968
  timezone?: number | string;
22496
22969
  };
22497
22970
  path?: never;
22498
- query?: never;
22971
+ query?: {
22972
+ /**
22973
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
22974
+ */
22975
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
22976
+ };
22499
22977
  url: '/vedic-astrology/parallels/monthly';
22500
22978
  };
22501
22979
 
@@ -22609,11 +23087,11 @@ export type PostVedicAstrologyParallelsMonthlyResponses = {
22609
23087
  */
22610
23088
  200: {
22611
23089
  /**
22612
- * Year of the parallel analysis.
23090
+ * Year of the parallel analysis. Echoes the year that was requested, or the current UTC year when it was omitted.
22613
23091
  */
22614
23092
  year: number;
22615
23093
  /**
22616
- * Month of the parallel analysis.
23094
+ * Month of the parallel analysis. Echoes the month that was requested, or the current UTC month when it was omitted.
22617
23095
  */
22618
23096
  month: number;
22619
23097
  /**
@@ -22621,13 +23099,21 @@ export type PostVedicAstrologyParallelsMonthlyResponses = {
22621
23099
  */
22622
23100
  events: Array<{
22623
23101
  /**
22624
- * First planet in the parallel or contraparallel pair.
23102
+ * First planet in the parallel or contraparallel pair. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use planet1Localized for anything a reader sees.
22625
23103
  */
22626
23104
  planet1: string;
22627
23105
  /**
22628
- * Second planet in the pair.
23106
+ * First planet name in the requested language, for display. Present only when lang is set to a language other than English, since in English it would repeat planet1 exactly.
23107
+ */
23108
+ planet1Localized?: string;
23109
+ /**
23110
+ * Second planet in the pair. Always English, whatever the lang parameter says. Use planet2Localized for anything a reader sees.
22629
23111
  */
22630
23112
  planet2: string;
23113
+ /**
23114
+ * Second planet name in the requested language, for display. Present only when lang is set to a language other than English.
23115
+ */
23116
+ planet2Localized?: string;
22631
23117
  /**
22632
23118
  * Parallel = same declination (acts like conjunction in strength). Contraparallel = opposite declination (acts like opposition).
22633
23119
  */