@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.
@@ -32,9 +32,13 @@ export type NatalChartResponse = {
32
32
  */
33
33
  planets: Array<{
34
34
  /**
35
- * 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.
35
+ * 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.
36
36
  */
37
37
  name: string;
38
+ /**
39
+ * 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.
40
+ */
41
+ nameLocalized?: string;
38
42
  /**
39
43
  * Tropical ecliptic longitude in degrees (0-360).
40
44
  */
@@ -44,9 +48,13 @@ export type NatalChartResponse = {
44
48
  */
45
49
  latitude: number;
46
50
  /**
47
- * Tropical zodiac sign this planet occupies.
51
+ * 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.
48
52
  */
49
53
  sign: string;
54
+ /**
55
+ * 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.
56
+ */
57
+ signLocalized?: string;
50
58
  /**
51
59
  * Degree within the zodiac sign (0-29.999).
52
60
  */
@@ -94,9 +102,13 @@ export type NatalChartResponse = {
94
102
  */
95
103
  longitude: number;
96
104
  /**
97
- * Zodiac sign on this house cusp.
105
+ * Zodiac sign on this house cusp. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
98
106
  */
99
107
  sign: string;
108
+ /**
109
+ * 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.
110
+ */
111
+ signLocalized?: string;
100
112
  /**
101
113
  * Degree within the zodiac sign (0-29.999).
102
114
  */
@@ -111,17 +123,29 @@ export type NatalChartResponse = {
111
123
  */
112
124
  aspects: Array<{
113
125
  /**
114
- * First planet in the aspect pair.
126
+ * First planet in the aspect pair. Always English, whatever the lang parameter says. Use planet1Localized for anything a reader sees.
115
127
  */
116
128
  planet1: string;
117
129
  /**
118
- * Second planet in the aspect pair.
130
+ * 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.
131
+ */
132
+ planet1Localized?: string;
133
+ /**
134
+ * Second planet in the aspect pair. Always English, whatever the lang parameter says. Use planet2Localized for anything a reader sees.
119
135
  */
120
136
  planet2: string;
121
137
  /**
122
- * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.).
138
+ * 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.
139
+ */
140
+ planet2Localized?: string;
141
+ /**
142
+ * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.). Always English, whatever the lang parameter says. Use typeLocalized for anything a reader sees.
123
143
  */
124
144
  type: string;
145
+ /**
146
+ * 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.
147
+ */
148
+ typeLocalized?: string;
125
149
  /**
126
150
  * Exact angle of this aspect type in degrees.
127
151
  */
@@ -224,9 +248,13 @@ export type NatalChartResponse = {
224
248
  */
225
249
  ascendant: {
226
250
  /**
227
- * Zodiac sign on the Ascendant (rising sign).
251
+ * Zodiac sign on the Ascendant (rising sign). Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
228
252
  */
229
253
  sign: string;
254
+ /**
255
+ * 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.
256
+ */
257
+ signLocalized?: string;
230
258
  /**
231
259
  * Degree within the Ascendant sign (0-29.999).
232
260
  */
@@ -241,9 +269,13 @@ export type NatalChartResponse = {
241
269
  */
242
270
  midheaven: {
243
271
  /**
244
- * Zodiac sign on the Midheaven (MC).
272
+ * Zodiac sign on the Midheaven (MC). Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
245
273
  */
246
274
  sign: string;
275
+ /**
276
+ * 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.
277
+ */
278
+ signLocalized?: string;
247
279
  /**
248
280
  * Degree within the Midheaven sign (0-29.999).
249
281
  */
@@ -273,6 +305,10 @@ export type NatalChartResponse = {
273
305
  * 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.
274
306
  */
275
307
  sect: 'day' | 'night';
308
+ /**
309
+ * 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.
310
+ */
311
+ signLocalized?: string;
276
312
  };
277
313
  /**
278
314
  * 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.
@@ -290,23 +326,39 @@ export type NatalChartResponse = {
290
326
  * Absolute ecliptic longitude of the Vertex (0-360).
291
327
  */
292
328
  longitude: number;
329
+ /**
330
+ * 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.
331
+ */
332
+ signLocalized?: string;
293
333
  };
294
334
  /**
295
335
  * Chart summary with dominant element, modality, retrograde planets, and distribution analysis.
296
336
  */
297
337
  summary: {
298
338
  /**
299
- * Most represented element in the chart (Fire, Earth, Air, Water).
339
+ * Most represented element in the chart (Fire, Earth, Air, Water). Always English, whatever the lang parameter says. Use dominantElementLocalized for anything a reader sees.
300
340
  */
301
341
  dominantElement: string;
302
342
  /**
303
- * Most represented modality in the chart (Cardinal, Fixed, Mutable).
343
+ * 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.
344
+ */
345
+ dominantElementLocalized?: string;
346
+ /**
347
+ * Most represented modality in the chart (Cardinal, Fixed, Mutable). Always English, whatever the lang parameter says. Use dominantModalityLocalized for anything a reader sees.
304
348
  */
305
349
  dominantModality: string;
306
350
  /**
307
- * Planets in retrograde motion at the time of birth.
351
+ * 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.
352
+ */
353
+ dominantModalityLocalized?: string;
354
+ /**
355
+ * Planets in retrograde motion at the time of birth. Always English, whatever the lang parameter says. Use retrogradePlanetsLocalized for anything a reader sees.
308
356
  */
309
357
  retrogradePlanets: Array<string>;
358
+ /**
359
+ * 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.
360
+ */
361
+ retrogradePlanetsLocalized?: Array<string>;
310
362
  /**
311
363
  * Count of planets in each element. Shows elemental emphasis in the personality.
312
364
  */
@@ -478,17 +530,29 @@ export type AspectsResponse = {
478
530
  */
479
531
  aspects: Array<{
480
532
  /**
481
- * First planet in the aspect pair.
533
+ * First planet in the aspect pair. Always English, whatever the lang parameter says. Use planet1Localized for anything a reader sees.
482
534
  */
483
535
  planet1: string;
484
536
  /**
485
- * Second planet in the aspect pair.
537
+ * 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.
538
+ */
539
+ planet1Localized?: string;
540
+ /**
541
+ * Second planet in the aspect pair. Always English, whatever the lang parameter says. Use planet2Localized for anything a reader sees.
486
542
  */
487
543
  planet2: string;
488
544
  /**
489
- * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.).
545
+ * 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.
546
+ */
547
+ planet2Localized?: string;
548
+ /**
549
+ * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.). Always English, whatever the lang parameter says. Use typeLocalized for anything a reader sees.
490
550
  */
491
551
  type: string;
552
+ /**
553
+ * 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.
554
+ */
555
+ typeLocalized?: string;
492
556
  /**
493
557
  * Exact angle defining this aspect type in degrees.
494
558
  */
@@ -751,9 +815,13 @@ export type TransitsResponse = {
751
815
  */
752
816
  transitPlanets: Array<{
753
817
  /**
754
- * 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.
818
+ * 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.
755
819
  */
756
820
  name: string;
821
+ /**
822
+ * 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.
823
+ */
824
+ nameLocalized?: string;
757
825
  /**
758
826
  * Tropical ecliptic longitude in degrees (0-360). Primary coordinate for sign and aspect calculation.
759
827
  */
@@ -763,9 +831,13 @@ export type TransitsResponse = {
763
831
  */
764
832
  latitude: number;
765
833
  /**
766
- * Tropical zodiac sign the planet currently occupies. Changes when longitude crosses a 30-degree boundary.
834
+ * 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.
767
835
  */
768
836
  sign: string;
837
+ /**
838
+ * 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.
839
+ */
840
+ signLocalized?: string;
769
841
  /**
770
842
  * Degree within the current zodiac sign (0-29.999). Indicates how far into the sign the planet has progressed.
771
843
  */
@@ -784,17 +856,29 @@ export type TransitsResponse = {
784
856
  */
785
857
  transitAspects?: Array<{
786
858
  /**
787
- * Transiting planet forming the aspect.
859
+ * Transiting planet forming the aspect. Always English, whatever the lang parameter says. Use transitPlanetLocalized for anything a reader sees.
788
860
  */
789
861
  transitPlanet: string;
790
862
  /**
791
- * Natal planet being aspected.
863
+ * 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.
864
+ */
865
+ transitPlanetLocalized?: string;
866
+ /**
867
+ * Natal planet being aspected. Always English, whatever the lang parameter says. Use natalPlanetLocalized for anything a reader sees.
792
868
  */
793
869
  natalPlanet: string;
794
870
  /**
795
- * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.).
871
+ * 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.
872
+ */
873
+ natalPlanetLocalized?: string;
874
+ /**
875
+ * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.). Always English, whatever the lang parameter says. Use typeLocalized for anything a reader sees.
796
876
  */
797
877
  type: string;
878
+ /**
879
+ * 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.
880
+ */
881
+ typeLocalized?: string;
798
882
  /**
799
883
  * Exact angle of this aspect type in degrees.
800
884
  */
@@ -1095,6 +1179,10 @@ export type RelocationChartResponse = {
1095
1179
  * Degree within the zodiac sign on this cusp (0-29.999).
1096
1180
  */
1097
1181
  degree: number;
1182
+ /**
1183
+ * 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.
1184
+ */
1185
+ signLocalized?: string;
1098
1186
  }>;
1099
1187
  /**
1100
1188
  * House system used for the relocated chart (placidus, whole-sign, equal, or koch). Quadrant systems fall back to whole-sign above the polar circle.
@@ -1105,9 +1193,13 @@ export type RelocationChartResponse = {
1105
1193
  */
1106
1194
  ascendant: {
1107
1195
  /**
1108
- * Tropical zodiac sign on this relocated angle.
1196
+ * Tropical zodiac sign on this relocated angle. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
1109
1197
  */
1110
1198
  sign: string;
1199
+ /**
1200
+ * 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.
1201
+ */
1202
+ signLocalized?: string;
1111
1203
  /**
1112
1204
  * Degree within the zodiac sign on this angle (0-29.999).
1113
1205
  */
@@ -1122,9 +1214,13 @@ export type RelocationChartResponse = {
1122
1214
  */
1123
1215
  midheaven: {
1124
1216
  /**
1125
- * Tropical zodiac sign on this relocated angle.
1217
+ * Tropical zodiac sign on this relocated angle. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
1126
1218
  */
1127
1219
  sign: string;
1220
+ /**
1221
+ * 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.
1222
+ */
1223
+ signLocalized?: string;
1128
1224
  /**
1129
1225
  * Degree within the zodiac sign on this angle (0-29.999).
1130
1226
  */
@@ -1150,6 +1246,10 @@ export type RelocationChartResponse = {
1150
1246
  * Absolute ecliptic longitude of the Vertex (0-360).
1151
1247
  */
1152
1248
  longitude: number;
1249
+ /**
1250
+ * 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.
1251
+ */
1252
+ signLocalized?: string;
1153
1253
  };
1154
1254
  /**
1155
1255
  * How relocation reshapes the chart: Ascendant shift, planets that change house, angular planets, and the move geometry from the birthplace.
@@ -1164,9 +1264,13 @@ export type RelocationChartResponse = {
1164
1264
  */
1165
1265
  planetsChangedHouse: Array<{
1166
1266
  /**
1167
- * Body that occupies a different house after relocation.
1267
+ * Body that occupies a different house after relocation. Always English, whatever the lang parameter says. Use planetLocalized for anything a reader sees.
1168
1268
  */
1169
1269
  planet: string;
1270
+ /**
1271
+ * 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.
1272
+ */
1273
+ planetLocalized?: string;
1170
1274
  /**
1171
1275
  * House this body occupied in the birthplace chart (1-12).
1172
1276
  */
@@ -1177,9 +1281,13 @@ export type RelocationChartResponse = {
1177
1281
  relocatedHouse: number;
1178
1282
  }>;
1179
1283
  /**
1180
- * Bodies within three degrees of a relocated angle (Ascendant, Imum Coeli, Descendant, or Midheaven), where their influence is strongest at this location.
1284
+ * 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.
1181
1285
  */
1182
1286
  angularPlanets: Array<string>;
1287
+ /**
1288
+ * 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.
1289
+ */
1290
+ angularPlanetsLocalized?: Array<string>;
1183
1291
  /**
1184
1292
  * Great-circle distance from the birthplace to the new location in kilometers.
1185
1293
  */
@@ -1232,6 +1340,14 @@ export type RelocationPlanet = {
1232
1340
  * Whether the planet appears to move backward from Earth perspective. Retrograde periods signal review and introspection.
1233
1341
  */
1234
1342
  isRetrograde: boolean;
1343
+ /**
1344
+ * 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.
1345
+ */
1346
+ nameLocalized?: string;
1347
+ /**
1348
+ * 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.
1349
+ */
1350
+ signLocalized?: string;
1235
1351
  /**
1236
1352
  * Relocated placement interpretation. The planet keeps its natal sign, so this reads its meaning through the new house it occupies at this location.
1237
1353
  */
@@ -1821,17 +1937,25 @@ export type ProgressionsResponse = {
1821
1937
  */
1822
1938
  planets: Array<{
1823
1939
  /**
1824
- * Body name in canonical English. One of the 10 classical planets, the lunar nodes, Chiron, or Black Moon Lilith.
1940
+ * 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.
1825
1941
  */
1826
1942
  name: string;
1943
+ /**
1944
+ * 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.
1945
+ */
1946
+ nameLocalized?: string;
1827
1947
  /**
1828
1948
  * Progressed tropical ecliptic longitude in degrees (0 to 360).
1829
1949
  */
1830
1950
  longitude: number;
1831
1951
  /**
1832
- * Tropical zodiac sign the progressed body falls in.
1952
+ * Tropical zodiac sign the progressed body falls in. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
1833
1953
  */
1834
1954
  sign: string;
1955
+ /**
1956
+ * 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.
1957
+ */
1958
+ signLocalized?: string;
1835
1959
  /**
1836
1960
  * Degree of the progressed body within its zodiac sign (0 to 29.999).
1837
1961
  */
@@ -1862,9 +1986,13 @@ export type ProgressionsResponse = {
1862
1986
  */
1863
1987
  longitude: number;
1864
1988
  /**
1865
- * Tropical zodiac sign the progressed angle falls in.
1989
+ * Tropical zodiac sign the progressed angle falls in. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
1866
1990
  */
1867
1991
  sign: string;
1992
+ /**
1993
+ * 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.
1994
+ */
1995
+ signLocalized?: string;
1868
1996
  /**
1869
1997
  * Degree of the progressed angle within its zodiac sign (0 to 29.999).
1870
1998
  */
@@ -1879,9 +2007,13 @@ export type ProgressionsResponse = {
1879
2007
  */
1880
2008
  longitude: number;
1881
2009
  /**
1882
- * Tropical zodiac sign the progressed angle falls in.
2010
+ * Tropical zodiac sign the progressed angle falls in. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
1883
2011
  */
1884
2012
  sign: string;
2013
+ /**
2014
+ * 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.
2015
+ */
2016
+ signLocalized?: string;
1885
2017
  /**
1886
2018
  * Degree of the progressed angle within its zodiac sign (0 to 29.999).
1887
2019
  */
@@ -8220,6 +8352,186 @@ export type PostAstrologyPlanetsResponses = {
8220
8352
  };
8221
8353
  };
8222
8354
  export type PostAstrologyPlanetsResponse = PostAstrologyPlanetsResponses[keyof PostAstrologyPlanetsResponses];
8355
+ export type PostAstrologyPlanetsMonthlyData = {
8356
+ body?: {
8357
+ /**
8358
+ * Year for the monthly ephemeris (1900-2100). Defaults to the current year (UTC).
8359
+ */
8360
+ year?: number;
8361
+ /**
8362
+ * Month number (1-12) for the ephemeris. Defaults to the current month (UTC).
8363
+ */
8364
+ month?: number;
8365
+ };
8366
+ path?: never;
8367
+ query?: {
8368
+ /**
8369
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
8370
+ */
8371
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
8372
+ };
8373
+ url: '/astrology/planets/monthly';
8374
+ };
8375
+ export type PostAstrologyPlanetsMonthlyErrors = {
8376
+ /**
8377
+ * Validation error. `issues[]` lists every failed field.
8378
+ */
8379
+ 400: {
8380
+ /**
8381
+ * First issue summary.
8382
+ */
8383
+ error: string;
8384
+ code: 'validation_error';
8385
+ /**
8386
+ * Every validation failure. Use this to rebuild a valid request.
8387
+ */
8388
+ issues: Array<{
8389
+ /**
8390
+ * Dot-separated field path, or "(root)" for top-level.
8391
+ */
8392
+ path: string;
8393
+ message: string;
8394
+ /**
8395
+ * Zod issue code (invalid_type, too_small, too_big, invalid_string, ...).
8396
+ */
8397
+ code?: string;
8398
+ /**
8399
+ * Expected type for invalid_type.
8400
+ */
8401
+ expected?: string;
8402
+ /**
8403
+ * Minimum bound for too_small issues.
8404
+ */
8405
+ minimum?: number | string;
8406
+ /**
8407
+ * Maximum bound for too_big issues.
8408
+ */
8409
+ maximum?: number | string;
8410
+ inclusive?: boolean;
8411
+ /**
8412
+ * Format name for string issues (regex, email, url, uuid).
8413
+ */
8414
+ format?: string;
8415
+ /**
8416
+ * Regex pattern when format is regex.
8417
+ */
8418
+ pattern?: string;
8419
+ }>;
8420
+ };
8421
+ /**
8422
+ * Invalid or missing API key
8423
+ */
8424
+ 401: {
8425
+ /**
8426
+ * Human-readable error message. May change wording.
8427
+ */
8428
+ error: string;
8429
+ /**
8430
+ * Machine-readable error code. Stable identifier.
8431
+ */
8432
+ code: string;
8433
+ };
8434
+ /**
8435
+ * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
8436
+ */
8437
+ 405: {
8438
+ error: string;
8439
+ code: 'method_not_allowed';
8440
+ /**
8441
+ * Allowed HTTP methods for this path. Mirrors the Allow response header.
8442
+ */
8443
+ allow: Array<string>;
8444
+ /**
8445
+ * Link to the product page for this domain.
8446
+ */
8447
+ docs?: string;
8448
+ };
8449
+ /**
8450
+ * Monthly rate limit exceeded
8451
+ */
8452
+ 429: {
8453
+ /**
8454
+ * Human-readable error message. May change wording.
8455
+ */
8456
+ error: string;
8457
+ /**
8458
+ * Machine-readable error code. Stable identifier.
8459
+ */
8460
+ code: string;
8461
+ };
8462
+ /**
8463
+ * Internal server error
8464
+ */
8465
+ 500: {
8466
+ /**
8467
+ * Human-readable error message. May change wording.
8468
+ */
8469
+ error: string;
8470
+ /**
8471
+ * Machine-readable error code. Stable identifier.
8472
+ */
8473
+ code: string;
8474
+ };
8475
+ };
8476
+ export type PostAstrologyPlanetsMonthlyError = PostAstrologyPlanetsMonthlyErrors[keyof PostAstrologyPlanetsMonthlyErrors];
8477
+ export type PostAstrologyPlanetsMonthlyResponses = {
8478
+ /**
8479
+ * Monthly ephemeris data
8480
+ */
8481
+ 200: {
8482
+ /**
8483
+ * Year of the ephemeris. Echoes the year that was requested, or the current UTC year when it was omitted.
8484
+ */
8485
+ year: number;
8486
+ /**
8487
+ * Month of the ephemeris. Echoes the month that was requested, or the current UTC month when it was omitted.
8488
+ */
8489
+ month: number;
8490
+ /**
8491
+ * Daily planetary position entries for the entire month.
8492
+ */
8493
+ days: Array<{
8494
+ /**
8495
+ * Date in YYYY-MM-DD format.
8496
+ */
8497
+ date: string;
8498
+ /**
8499
+ * Tropical positions of all 14 Western bodies on this date at noon UTC.
8500
+ */
8501
+ positions: Array<{
8502
+ /**
8503
+ * 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.
8504
+ */
8505
+ planet: string;
8506
+ /**
8507
+ * 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.
8508
+ */
8509
+ planetLocalized?: string;
8510
+ /**
8511
+ * 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.
8512
+ */
8513
+ longitude: number;
8514
+ /**
8515
+ * 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.
8516
+ */
8517
+ sign: string;
8518
+ /**
8519
+ * 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.
8520
+ */
8521
+ signLocalized?: string;
8522
+ /**
8523
+ * Degrees traversed within the current sign (0-30). Useful for precise transit tracking and for printing a position as sign plus degree.
8524
+ */
8525
+ degreeInSign: number;
8526
+ /**
8527
+ * Whether the body is in apparent retrograde motion on this date. The lunar nodes are always retrograde and Black Moon Lilith is always direct.
8528
+ */
8529
+ isRetrograde: boolean;
8530
+ }>;
8531
+ }>;
8532
+ };
8533
+ };
8534
+ export type PostAstrologyPlanetsMonthlyResponse = PostAstrologyPlanetsMonthlyResponses[keyof PostAstrologyPlanetsMonthlyResponses];
8223
8535
  export type GetAstrologyMoonPhaseCurrentData = {
8224
8536
  body?: never;
8225
8537
  path?: never;
@@ -8899,38 +9211,58 @@ export type PostAstrologySynastryResponses = {
8899
9211
  */
8900
9212
  ascendant: {
8901
9213
  /**
8902
- * Ascendant (rising sign) of this person.
9214
+ * Ascendant (rising sign) of this person. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
8903
9215
  */
8904
9216
  sign: string;
9217
+ /**
9218
+ * 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.
9219
+ */
9220
+ signLocalized?: string;
8905
9221
  /**
8906
9222
  * Degree within the Ascendant sign (0-29.999).
8907
9223
  */
8908
9224
  degree: number;
8909
9225
  };
8910
9226
  /**
8911
- * Sun sign (zodiac sign) of this person. Core identity and ego expression.
9227
+ * 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.
8912
9228
  */
8913
9229
  sunSign: string;
8914
9230
  /**
8915
- * Moon sign of this person. Emotional nature and inner needs.
9231
+ * 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.
9232
+ */
9233
+ sunSignLocalized?: string;
9234
+ /**
9235
+ * Moon sign of this person. Emotional nature and inner needs. Always English, whatever the lang parameter says. Use moonSignLocalized for anything a reader sees.
8916
9236
  */
8917
9237
  moonSign: string;
9238
+ /**
9239
+ * 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.
9240
+ */
9241
+ moonSignLocalized?: string;
8918
9242
  /**
8919
9243
  * 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.
8920
9244
  */
8921
9245
  planets: Array<{
8922
9246
  /**
8923
- * Planet or point name. Matches the names used in interAspects.
9247
+ * Planet or point name. Matches the names used in interAspects. Always English, whatever the lang parameter says. Use nameLocalized for anything a reader sees.
8924
9248
  */
8925
9249
  name: string;
9250
+ /**
9251
+ * 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.
9252
+ */
9253
+ nameLocalized?: string;
8926
9254
  /**
8927
9255
  * Ecliptic longitude in degrees (0-360) measured from 0 Aries. This is the value a wheel plots.
8928
9256
  */
8929
9257
  longitude: number;
8930
9258
  /**
8931
- * Zodiac sign containing the planet.
9259
+ * Zodiac sign containing the planet. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
8932
9260
  */
8933
9261
  sign: string;
9262
+ /**
9263
+ * 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.
9264
+ */
9265
+ signLocalized?: string;
8934
9266
  /**
8935
9267
  * Degree within the sign (0-29.999).
8936
9268
  */
@@ -8958,38 +9290,58 @@ export type PostAstrologySynastryResponses = {
8958
9290
  */
8959
9291
  ascendant: {
8960
9292
  /**
8961
- * Ascendant (rising sign) of this person.
9293
+ * Ascendant (rising sign) of this person. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
8962
9294
  */
8963
9295
  sign: string;
9296
+ /**
9297
+ * 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.
9298
+ */
9299
+ signLocalized?: string;
8964
9300
  /**
8965
9301
  * Degree within the Ascendant sign (0-29.999).
8966
9302
  */
8967
9303
  degree: number;
8968
9304
  };
8969
9305
  /**
8970
- * Sun sign (zodiac sign) of this person. Core identity and ego expression.
9306
+ * 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.
8971
9307
  */
8972
9308
  sunSign: string;
8973
9309
  /**
8974
- * Moon sign of this person. Emotional nature and inner needs.
9310
+ * 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.
9311
+ */
9312
+ sunSignLocalized?: string;
9313
+ /**
9314
+ * Moon sign of this person. Emotional nature and inner needs. Always English, whatever the lang parameter says. Use moonSignLocalized for anything a reader sees.
8975
9315
  */
8976
9316
  moonSign: string;
9317
+ /**
9318
+ * 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.
9319
+ */
9320
+ moonSignLocalized?: string;
8977
9321
  /**
8978
9322
  * 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.
8979
9323
  */
8980
9324
  planets: Array<{
8981
9325
  /**
8982
- * Planet or point name. Matches the names used in interAspects.
9326
+ * Planet or point name. Matches the names used in interAspects. Always English, whatever the lang parameter says. Use nameLocalized for anything a reader sees.
8983
9327
  */
8984
9328
  name: string;
9329
+ /**
9330
+ * 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.
9331
+ */
9332
+ nameLocalized?: string;
8985
9333
  /**
8986
9334
  * Ecliptic longitude in degrees (0-360) measured from 0 Aries. This is the value a wheel plots.
8987
9335
  */
8988
9336
  longitude: number;
8989
9337
  /**
8990
- * Zodiac sign containing the planet.
9338
+ * Zodiac sign containing the planet. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
8991
9339
  */
8992
9340
  sign: string;
9341
+ /**
9342
+ * 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.
9343
+ */
9344
+ signLocalized?: string;
8993
9345
  /**
8994
9346
  * Degree within the sign (0-29.999).
8995
9347
  */
@@ -9013,17 +9365,29 @@ export type PostAstrologySynastryResponses = {
9013
9365
  */
9014
9366
  interAspects: Array<{
9015
9367
  /**
9016
- * Planet from person 1 chart.
9368
+ * Planet from person 1 chart. Always English, whatever the lang parameter says. Use planet1Localized for anything a reader sees.
9017
9369
  */
9018
9370
  planet1: string;
9019
9371
  /**
9020
- * Planet from person 2 chart.
9372
+ * 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.
9373
+ */
9374
+ planet1Localized?: string;
9375
+ /**
9376
+ * Planet from person 2 chart. Always English, whatever the lang parameter says. Use planet2Localized for anything a reader sees.
9021
9377
  */
9022
9378
  planet2: string;
9023
9379
  /**
9024
- * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.).
9380
+ * 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.
9381
+ */
9382
+ planet2Localized?: string;
9383
+ /**
9384
+ * Aspect type (CONJUNCTION, OPPOSITION, TRINE, SQUARE, SEXTILE, etc.). Always English, whatever the lang parameter says. Use typeLocalized for anything a reader sees.
9025
9385
  */
9026
9386
  type: string;
9387
+ /**
9388
+ * 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.
9389
+ */
9390
+ typeLocalized?: string;
9027
9391
  /**
9028
9392
  * Exact angle of this aspect type in degrees.
9029
9393
  */
@@ -9847,6 +10211,14 @@ export type PostAstrologyTransitAspectsResponses = {
9847
10211
  * Whether the planet appears to move backward from Earth perspective. Retrograde periods signal review and introspection.
9848
10212
  */
9849
10213
  isRetrograde: boolean;
10214
+ /**
10215
+ * 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.
10216
+ */
10217
+ nameLocalized?: string;
10218
+ /**
10219
+ * 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.
10220
+ */
10221
+ signLocalized?: string;
9850
10222
  }>;
9851
10223
  /**
9852
10224
  * Natal (birth chart) planetary positions used as the baseline for transit aspect comparison, each placed in its natal house.
@@ -9884,6 +10256,14 @@ export type PostAstrologyTransitAspectsResponses = {
9884
10256
  * Whether the planet appears to move backward from Earth perspective. Retrograde periods signal review and introspection.
9885
10257
  */
9886
10258
  isRetrograde: boolean;
10259
+ /**
10260
+ * 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.
10261
+ */
10262
+ nameLocalized?: string;
10263
+ /**
10264
+ * 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.
10265
+ */
10266
+ signLocalized?: string;
9887
10267
  }>;
9888
10268
  /**
9889
10269
  * Transit-to-natal aspects with interpretations, strength ratings, and guidance. Each aspect represents a transiting planet forming a geometric angle to a natal planet.
@@ -9921,6 +10301,18 @@ export type PostAstrologyTransitAspectsResponses = {
9921
10301
  * Aspect nature. Harmonious (trine, sextile) flows easily. Challenging (square, opposition) creates tension and growth. Neutral (conjunction) blends energies.
9922
10302
  */
9923
10303
  interpretation: 'harmonious' | 'challenging' | 'neutral';
10304
+ /**
10305
+ * 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.
10306
+ */
10307
+ planet1Localized?: string;
10308
+ /**
10309
+ * 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.
10310
+ */
10311
+ planet2Localized?: string;
10312
+ /**
10313
+ * 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.
10314
+ */
10315
+ typeLocalized?: string;
9924
10316
  transitInterpretation?: {
9925
10317
  /**
9926
10318
  * Narrative interpretation of this transit aspect and its life impact.
@@ -10000,6 +10392,18 @@ export type PostAstrologyTransitAspectsResponses = {
10000
10392
  * Aspect nature. Harmonious (trine, sextile) flows easily. Challenging (square, opposition) creates tension and growth. Neutral (conjunction) blends energies.
10001
10393
  */
10002
10394
  interpretation: 'harmonious' | 'challenging' | 'neutral';
10395
+ /**
10396
+ * 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.
10397
+ */
10398
+ planet1Localized?: string;
10399
+ /**
10400
+ * 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.
10401
+ */
10402
+ planet2Localized?: string;
10403
+ /**
10404
+ * 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.
10405
+ */
10406
+ typeLocalized?: string;
10003
10407
  } | null;
10004
10408
  /**
10005
10409
  * Transit aspect counts grouped by aspect type (conjunction, trine, square, opposition, sextile, etc.). Useful for quickly assessing the transit weather.
@@ -14529,20 +14933,25 @@ export type PostVedicAstrologyPlanetaryPositionsResponse = PostVedicAstrologyPla
14529
14933
  export type PostVedicAstrologyPlanetaryPositionsMonthlyData = {
14530
14934
  body?: {
14531
14935
  /**
14532
- * Year for monthly ephemeris (1900-2100).
14936
+ * Year for monthly ephemeris (1900-2100). Defaults to the current year (UTC).
14533
14937
  */
14534
- year: number;
14938
+ year?: number;
14535
14939
  /**
14536
- * Month number (1-12) for ephemeris.
14940
+ * Month number (1-12) for ephemeris. Defaults to the current month (UTC).
14537
14941
  */
14538
- month: number;
14942
+ month?: number;
14539
14943
  /**
14540
14944
  * 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".
14541
14945
  */
14542
14946
  coordinateSystem?: 'sidereal' | 'tropical';
14543
14947
  };
14544
14948
  path?: never;
14545
- query?: never;
14949
+ query?: {
14950
+ /**
14951
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
14952
+ */
14953
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
14954
+ };
14546
14955
  url: '/vedic-astrology/planetary-positions/monthly';
14547
14956
  };
14548
14957
  export type PostVedicAstrologyPlanetaryPositionsMonthlyErrors = {
@@ -14653,11 +15062,11 @@ export type PostVedicAstrologyPlanetaryPositionsMonthlyResponses = {
14653
15062
  */
14654
15063
  200: {
14655
15064
  /**
14656
- * Year of the ephemeris.
15065
+ * Year of the ephemeris. Echoes the year that was requested, or the current UTC year when it was omitted.
14657
15066
  */
14658
15067
  year: number;
14659
15068
  /**
14660
- * Month of the ephemeris.
15069
+ * Month of the ephemeris. Echoes the month that was requested, or the current UTC month when it was omitted.
14661
15070
  */
14662
15071
  month: number;
14663
15072
  /**
@@ -14673,17 +15082,25 @@ export type PostVedicAstrologyPlanetaryPositionsMonthlyResponses = {
14673
15082
  */
14674
15083
  positions: Array<{
14675
15084
  /**
14676
- * Planet name, one of the Navagraha (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu).
15085
+ * 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.
14677
15086
  */
14678
15087
  planet: string;
15088
+ /**
15089
+ * 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.
15090
+ */
15091
+ planetLocalized?: string;
14679
15092
  /**
14680
15093
  * Sidereal ecliptic longitude in degrees (0-360) using Lahiri ayanamsa.
14681
15094
  */
14682
15095
  longitude: number;
14683
15096
  /**
14684
- * Zodiac sign (rashi) the planet occupies on this date.
15097
+ * 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.
14685
15098
  */
14686
15099
  sign: string;
15100
+ /**
15101
+ * 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.
15102
+ */
15103
+ signLocalized?: string;
14687
15104
  /**
14688
15105
  * Degrees traversed within the current sign (0-30). Useful for precise transit tracking.
14689
15106
  */
@@ -21006,13 +21423,13 @@ export type PostVedicAstrologyAspectsResponse = PostVedicAstrologyAspectsRespons
21006
21423
  export type PostVedicAstrologyAspectsMonthlyData = {
21007
21424
  body?: {
21008
21425
  /**
21009
- * Year for monthly analysis (1900-2100).
21426
+ * Year for monthly analysis (1900-2100). Defaults to the current year (UTC).
21010
21427
  */
21011
- year: number;
21428
+ year?: number;
21012
21429
  /**
21013
- * Month number (1-12).
21430
+ * Month number (1-12). Defaults to the current month (UTC).
21014
21431
  */
21015
- month: number;
21432
+ month?: number;
21016
21433
  /**
21017
21434
  * Timezone offset from UTC in hours. Output times are converted to this timezone. Defaults to 0 (UTC).
21018
21435
  */
@@ -21023,7 +21440,12 @@ export type PostVedicAstrologyAspectsMonthlyData = {
21023
21440
  coordinateSystem?: 'sidereal' | 'tropical';
21024
21441
  };
21025
21442
  path?: never;
21026
- query?: never;
21443
+ query?: {
21444
+ /**
21445
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
21446
+ */
21447
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
21448
+ };
21027
21449
  url: '/vedic-astrology/aspects/monthly';
21028
21450
  };
21029
21451
  export type PostVedicAstrologyAspectsMonthlyErrors = {
@@ -21134,11 +21556,11 @@ export type PostVedicAstrologyAspectsMonthlyResponses = {
21134
21556
  */
21135
21557
  200: {
21136
21558
  /**
21137
- * Year of the aspect analysis.
21559
+ * Year of the aspect analysis. Echoes the year that was requested, or the current UTC year when it was omitted.
21138
21560
  */
21139
21561
  year: number;
21140
21562
  /**
21141
- * Month of the aspect analysis.
21563
+ * Month of the aspect analysis. Echoes the month that was requested, or the current UTC month when it was omitted.
21142
21564
  */
21143
21565
  month: number;
21144
21566
  /**
@@ -21150,13 +21572,21 @@ export type PostVedicAstrologyAspectsMonthlyResponses = {
21150
21572
  */
21151
21573
  events: Array<{
21152
21574
  /**
21153
- * First planet forming the aspect. One of the Navagraha, Sun through Ketu.
21575
+ * 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.
21154
21576
  */
21155
21577
  planet1: string;
21156
21578
  /**
21157
- * Second planet forming the aspect.
21579
+ * 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.
21580
+ */
21581
+ planet1Localized?: string;
21582
+ /**
21583
+ * Second planet forming the aspect. Always English, whatever the lang parameter says. Use planet2Localized for anything a reader sees.
21158
21584
  */
21159
21585
  planet2: string;
21586
+ /**
21587
+ * Second planet name in the requested language, for display. Present only when lang is set to a language other than English.
21588
+ */
21589
+ planet2Localized?: string;
21160
21590
  /**
21161
21591
  * 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).
21162
21592
  */
@@ -21196,13 +21626,13 @@ export type PostVedicAstrologyAspectsMonthlyResponse = PostVedicAstrologyAspects
21196
21626
  export type PostVedicAstrologyAspectsLunarData = {
21197
21627
  body?: {
21198
21628
  /**
21199
- * Year for monthly analysis (1900-2100).
21629
+ * Year for monthly analysis (1900-2100). Defaults to the current year (UTC).
21200
21630
  */
21201
- year: number;
21631
+ year?: number;
21202
21632
  /**
21203
- * Month number (1-12).
21633
+ * Month number (1-12). Defaults to the current month (UTC).
21204
21634
  */
21205
- month: number;
21635
+ month?: number;
21206
21636
  /**
21207
21637
  * Timezone offset from UTC in hours. Output times are converted to this timezone. Defaults to 0 (UTC).
21208
21638
  */
@@ -21213,7 +21643,12 @@ export type PostVedicAstrologyAspectsLunarData = {
21213
21643
  coordinateSystem?: 'sidereal' | 'tropical';
21214
21644
  };
21215
21645
  path?: never;
21216
- query?: never;
21646
+ query?: {
21647
+ /**
21648
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
21649
+ */
21650
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
21651
+ };
21217
21652
  url: '/vedic-astrology/aspects/lunar';
21218
21653
  };
21219
21654
  export type PostVedicAstrologyAspectsLunarErrors = {
@@ -21324,11 +21759,11 @@ export type PostVedicAstrologyAspectsLunarResponses = {
21324
21759
  */
21325
21760
  200: {
21326
21761
  /**
21327
- * Year of the lunar aspect analysis.
21762
+ * Year of the lunar aspect analysis. Echoes the year that was requested, or the current UTC year when it was omitted.
21328
21763
  */
21329
21764
  year: number;
21330
21765
  /**
21331
- * Month of the lunar aspect analysis.
21766
+ * Month of the lunar aspect analysis. Echoes the month that was requested, or the current UTC month when it was omitted.
21332
21767
  */
21333
21768
  month: number;
21334
21769
  /**
@@ -21340,9 +21775,13 @@ export type PostVedicAstrologyAspectsLunarResponses = {
21340
21775
  */
21341
21776
  events: Array<{
21342
21777
  /**
21343
- * Planet that the Moon forms an aspect with.
21778
+ * 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.
21344
21779
  */
21345
21780
  planet: string;
21781
+ /**
21782
+ * 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.
21783
+ */
21784
+ planetLocalized?: string;
21346
21785
  /**
21347
21786
  * 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.
21348
21787
  */
@@ -21648,13 +22087,13 @@ export type PostVedicAstrologyTransitResponse = PostVedicAstrologyTransitRespons
21648
22087
  export type PostVedicAstrologyTransitMonthlyData = {
21649
22088
  body?: {
21650
22089
  /**
21651
- * Year for monthly transit analysis (1900-2100).
22090
+ * Year for monthly transit analysis (1900-2100). Defaults to the current year (UTC).
21652
22091
  */
21653
- year: number;
22092
+ year?: number;
21654
22093
  /**
21655
- * Month number (1-12) for transit analysis.
22094
+ * Month number (1-12) for transit analysis. Defaults to the current month (UTC).
21656
22095
  */
21657
- month: number;
22096
+ month?: number;
21658
22097
  /**
21659
22098
  * Timezone offset from UTC in hours. Output times are converted to this timezone. Defaults to 0 (UTC).
21660
22099
  */
@@ -21665,7 +22104,12 @@ export type PostVedicAstrologyTransitMonthlyData = {
21665
22104
  coordinateSystem?: 'sidereal' | 'tropical';
21666
22105
  };
21667
22106
  path?: never;
21668
- query?: never;
22107
+ query?: {
22108
+ /**
22109
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
22110
+ */
22111
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
22112
+ };
21669
22113
  url: '/vedic-astrology/transit/monthly';
21670
22114
  };
21671
22115
  export type PostVedicAstrologyTransitMonthlyErrors = {
@@ -21776,25 +22220,37 @@ export type PostVedicAstrologyTransitMonthlyResponses = {
21776
22220
  */
21777
22221
  200: {
21778
22222
  /**
21779
- * Year of the monthly transit analysis.
22223
+ * Year of the monthly transit analysis. Echoes the year that was requested, or the current UTC year when it was omitted.
21780
22224
  */
21781
22225
  year: number;
21782
22226
  /**
21783
- * Month of the monthly transit analysis.
22227
+ * Month of the monthly transit analysis. Echoes the month that was requested, or the current UTC month when it was omitted.
21784
22228
  */
21785
22229
  month: number;
22230
+ /**
22231
+ * Timezone offset from UTC in hours that the event dates and times are reported in. Echoes the requested timezone.
22232
+ */
22233
+ timezone: number;
21786
22234
  /**
21787
22235
  * Planetary positions at the beginning of the month (day 1, 00:00 UTC).
21788
22236
  */
21789
22237
  startingPositions: Array<{
21790
22238
  /**
21791
- * Planet (graha) name. One of the 9 Navagraha used in Vedic transit (Gochar) analysis.
22239
+ * 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.
21792
22240
  */
21793
22241
  planet: string;
21794
22242
  /**
21795
- * Zodiac sign (rashi) the planet occupies at the start of the month.
22243
+ * Planet name in the requested language, for display. Present only when lang is set to a language other than English.
22244
+ */
22245
+ planetLocalized?: string;
22246
+ /**
22247
+ * Zodiac sign (rashi) the planet occupies at the start of the month. Always English. Use signLocalized for anything a reader sees.
21796
22248
  */
21797
22249
  sign: string;
22250
+ /**
22251
+ * Zodiac sign name in the requested language, for display. Present only when lang is set to a language other than English.
22252
+ */
22253
+ signLocalized?: string;
21798
22254
  /**
21799
22255
  * Sidereal longitude at the start of the month.
21800
22256
  */
@@ -21805,17 +22261,29 @@ export type PostVedicAstrologyTransitMonthlyResponses = {
21805
22261
  */
21806
22262
  transitEvents: Array<{
21807
22263
  /**
21808
- * Planet that changes sign (rashi) during this month. One of the Navagraha: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu.
22264
+ * 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.
21809
22265
  */
21810
22266
  planet: string;
21811
22267
  /**
21812
- * Zodiac sign the planet is leaving (previous rashi).
22268
+ * 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.
22269
+ */
22270
+ planetLocalized?: string;
22271
+ /**
22272
+ * Zodiac sign the planet is leaving (previous rashi). Always English. Use fromSignLocalized for anything a reader sees.
21813
22273
  */
21814
22274
  fromSign: string;
21815
22275
  /**
21816
- * Zodiac sign the planet is entering (new rashi transit).
22276
+ * Name of the sign being left, in the requested language, for display. Present only when lang is set to a language other than English.
22277
+ */
22278
+ fromSignLocalized?: string;
22279
+ /**
22280
+ * Zodiac sign the planet is entering (new rashi transit). Always English. Use toSignLocalized for anything a reader sees.
21817
22281
  */
21818
22282
  toSign: string;
22283
+ /**
22284
+ * Name of the sign being entered, in the requested language, for display. Present only when lang is set to a language other than English.
22285
+ */
22286
+ toSignLocalized?: string;
21819
22287
  /**
21820
22288
  * Date of the sign change (YYYY-MM-DD). Adjusted to requested timezone.
21821
22289
  */
@@ -22030,20 +22498,25 @@ export type PostVedicAstrologyParallelsResponse = PostVedicAstrologyParallelsRes
22030
22498
  export type PostVedicAstrologyParallelsMonthlyData = {
22031
22499
  body?: {
22032
22500
  /**
22033
- * Year for monthly parallel analysis (1900-2100).
22501
+ * Year for monthly parallel analysis (1900-2100). Defaults to the current year (UTC).
22034
22502
  */
22035
- year: number;
22503
+ year?: number;
22036
22504
  /**
22037
- * Month number (1-12) for parallel analysis.
22505
+ * Month number (1-12) for parallel analysis. Defaults to the current month (UTC).
22038
22506
  */
22039
- month: number;
22507
+ month?: number;
22040
22508
  /**
22041
22509
  * Timezone offset from UTC in hours. Output times are converted to this timezone. Defaults to 0 (UTC).
22042
22510
  */
22043
22511
  timezone?: number | string;
22044
22512
  };
22045
22513
  path?: never;
22046
- query?: never;
22514
+ query?: {
22515
+ /**
22516
+ * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
22517
+ */
22518
+ lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
22519
+ };
22047
22520
  url: '/vedic-astrology/parallels/monthly';
22048
22521
  };
22049
22522
  export type PostVedicAstrologyParallelsMonthlyErrors = {
@@ -22154,11 +22627,11 @@ export type PostVedicAstrologyParallelsMonthlyResponses = {
22154
22627
  */
22155
22628
  200: {
22156
22629
  /**
22157
- * Year of the parallel analysis.
22630
+ * Year of the parallel analysis. Echoes the year that was requested, or the current UTC year when it was omitted.
22158
22631
  */
22159
22632
  year: number;
22160
22633
  /**
22161
- * Month of the parallel analysis.
22634
+ * Month of the parallel analysis. Echoes the month that was requested, or the current UTC month when it was omitted.
22162
22635
  */
22163
22636
  month: number;
22164
22637
  /**
@@ -22166,13 +22639,21 @@ export type PostVedicAstrologyParallelsMonthlyResponses = {
22166
22639
  */
22167
22640
  events: Array<{
22168
22641
  /**
22169
- * First planet in the parallel or contraparallel pair.
22642
+ * 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.
22170
22643
  */
22171
22644
  planet1: string;
22172
22645
  /**
22173
- * Second planet in the pair.
22646
+ * 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.
22647
+ */
22648
+ planet1Localized?: string;
22649
+ /**
22650
+ * Second planet in the pair. Always English, whatever the lang parameter says. Use planet2Localized for anything a reader sees.
22174
22651
  */
22175
22652
  planet2: string;
22653
+ /**
22654
+ * Second planet name in the requested language, for display. Present only when lang is set to a language other than English.
22655
+ */
22656
+ planet2Localized?: string;
22176
22657
  /**
22177
22658
  * Parallel = same declination (acts like conjunction in strength). Contraparallel = opposite declination (acts like opposition).
22178
22659
  */