sdk-dotnet

# RoxyApi .NET SDK - Complete Method Reference

> .NET SDK for RoxyAPI. Multi-domain spiritual and metaphysical intelligence API. Fully typed, generated from the OpenAPI spec. Install: `dotnet add package RoxyApi.Sdk`

```csharp
using RoxyApi;
using RoxyApi.Models;
using Microsoft.Kiota.Abstractions; // the Date type

var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
```

How the calls below map to the API:

- **The fluent path mirrors the URL.** `GET /astrology/horoscope/{sign}/daily` is `roxy.Astrology.Horoscope["aries"].Daily.GetAsync()`. Each path segment is a property; each `{param}` is an indexer.
- **Request bodies use a target-typed `new()`.** The body type is inferred from the method, so you never name it. Property names are the PascalCase of the JSON fields (`birth_date` becomes `BirthDate`).
- **Query parameters use a configuration lambda.** `await roxy.Crystals.Search.GetAsync(c => c.QueryParameters.Q = "amethyst");`
- **Dates use `new Date(year, month, day)`; times use `new Time(hour, minute, second)`** (both from `Microsoft.Kiota.Abstractions`).
- **`Timezone` is a union:** `new() { Double = -5 }` (decimal offset) or `new() { String = "America/New_York" }` (IANA name, resolved to the DST-correct offset).
- **Every call is async and throws `RoxyError` on an error response** (see Error handling below). Capture the result directly: `var chart = await roxy.Astrology.NatalChart.PostAsync(new() { ... });`

**Multi-language responses.** Interpretations are available in 10 languages: en, tr, de, es, fr, hi, pt, ru, zh-Hans, zh-Hant. Add `c => c.QueryParameters.Lang = PostLangQueryParameterType.Es` (the enum lives in that endpoint namespace) to any supported endpoint. Supported: astrology, vedicAstrology, forecast, humanDesign, chineseAstrology, fengShui, mesoamericanAstrology, vastu, numerology, kabbalah, tarot, biorhythm, ayurveda, iching, crystals, angelNumbers. English-only: dreams, location, usage, languages. The two Chinese scripts currently ship on chineseAstrology and fengShui. Untranslated fields fall back to English.

---

<!-- Method sections below are generated from the OpenAPI spec by tools/RoxyDevTools. Do not hand-edit between the BEGIN/END:METHODS markers; edit the spec instead. Each example is verified to compile by tests/RoxyApi.Tests/Generated/MethodReferenceExamples.g.cs. The intro above and the Error Handling / Links sections below are curated. -->
<!-- BEGIN:METHODS -->
## [Western Astrology](https://roxyapi.com/api-reference/western-astrology) - `roxy.Astrology`

Western astrology API for natal birth charts, daily, weekly, monthly, and yearly horoscopes with unique content per s...

```csharp
// Get all zodiac signs - Complete zodiac signs list with dates and elements
await roxy.Astrology.Signs.GetAsync();

// Get zodiac sign details - Complete astrology sign profile with personality traits
await roxy.Astrology.Signs["aries"].GetAsync();

// Get all planet meanings - Complete astrology planet interpretations list
await roxy.Astrology.PlanetMeanings.GetAsync();

// Get planet meaning details - Complete astrology planet interpretation
await roxy.Astrology.PlanetMeanings["sun"].GetAsync();

// Generate natal chart - Birth chart calculator API with houses and aspects
await roxy.Astrology.NatalChart.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } });

// Get planetary positions - Ephemeris calculator for all planets
await roxy.Astrology.Planets.PostAsync(new() { Date = new Date(2025, 12, 18), Time = new Time(12, 0, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } });

// Monthly Ephemeris - Daily tropical planetary positions for a month
await roxy.Astrology.Planets.Monthly.PostAsync(new() { Year = 2026, Month = 8 });

// Get current moon phase - Lunar phase calculator with zodiac sign
await roxy.Astrology.MoonPhase.Current.GetAsync(c => { c.QueryParameters.Date = new Date(2025, 12, 18); c.QueryParameters.Time = new Time(12, 0, 0); c.QueryParameters.Timezone = "America/New_York"; });

// Get upcoming moon phases - Next new moon, full moon, quarters
await roxy.Astrology.MoonPhase.Upcoming.GetAsync(c => { c.QueryParameters.StartDate = new Date(2025, 12, 18); c.QueryParameters.Count = 8; });

// Get lunar calendar - Moon phases for entire month
await roxy.Astrology.MoonPhase.Calendar[2026][3].GetAsync();

// Calculate synastry - Relationship compatibility analysis API
await roxy.Astrology.Synastry.PostAsync(new() { Person1 = new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" }, Name = "Alex" }, Person2 = new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" }, Name = "Alex" } });

// Calculate house cusps - House system calculator with comparison
await roxy.Astrology.Houses.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } });

// Calculate planetary aspects - Aspect finder for any date and time
await roxy.Astrology.Aspects.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Timezone = new() { String = "America/New_York" }, Planets = ["Sun"], AspectTypes = ["CONJUNCTION"] });

// Monthly Aspects - Tropical aspect calendar for an entire month
await roxy.Astrology.Aspects.Monthly.PostAsync(new() { Year = 2026, Month = 3, Timezone = new() { String = "America/New_York" } });

// Detect aspect patterns - Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle, Stellium
await roxy.Astrology.AspectPatterns.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } }, c => { c.QueryParameters.StrictOrbs = "false"; c.QueryParameters.Include = ""; });

// Calculate planetary transits - Current transits with natal chart comparison
await roxy.Astrology.Transits.PostAsync(new() { Date = new Date(2025, 12, 19), Time = new Time(12, 0, 0), Timezone = new() { Double = 0 } });

// Monthly Transits - Tropical sign ingresses for an entire month
await roxy.Astrology.Transits.Monthly.PostAsync(new() { Year = 2026, Month = 3, Timezone = new() { String = "America/New_York" } });

// Transit Aspects - Detailed transit-to-natal aspect analysis with interpretations
await roxy.Astrology.TransitAspects.PostAsync(new() { NatalChart = new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } }, TransitDate = new Date(2026, 2, 3), TransitTime = new Time(12, 0, 0), MinStrength = 50 });

// Monthly Parallels - Declination contacts for an entire month
await roxy.Astrology.Parallels.Monthly.PostAsync(new() { Year = 2026, Month = 3, Timezone = new() { String = "America/New_York" }, Orb = 1.5 });

// Ecliptic Crossings - Node passages for a whole year
await roxy.Astrology.EclipticCrossings.PostAsync(new() { Year = 2026, Timezone = new() { String = "America/New_York" } });

// Solar Return Chart - Annual birthday forecast with relocated chart
await roxy.Astrology.SolarReturn.PostAsync(new() { BirthDate = new Date(1990, 7, 15), BirthTime = new Time(14, 30, 0), ReturnYear = 2026, Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } });

// Lunar Return Chart - Monthly emotional forecast with Moon cycle chart
await roxy.Astrology.LunarReturn.PostAsync(new() { BirthDate = new Date(1990, 7, 15), BirthTime = new Time(14, 30, 0), ReturnDate = new Date(2026, 2, 12), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } });

// Composite Chart - Midpoint relationship chart with interpretations
await roxy.Astrology.CompositeChart.PostAsync(new() { Person1 = new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } }, Person2 = new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } } });

// Compatibility score - Relationship compatibility API
await roxy.Astrology.CompatibilityScore.PostAsync(new() { Person1 = new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } }, Person2 = new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } } });

// Daily horoscope by zodiac sign - Transit-based editorial columns
await roxy.Astrology.Horoscope["aries"].Daily.GetAsync(c => { c.QueryParameters.Date = new Date(2026, 4, 3); c.QueryParameters.Timezone = "America/New_York"; });

// Weekly horoscope by zodiac sign - Seven-day editorial column
await roxy.Astrology.Horoscope["aries"].Weekly.GetAsync(c => { c.QueryParameters.Date = new Date(2026, 4, 3); c.QueryParameters.Timezone = "America/New_York"; });

// Monthly horoscope by zodiac sign - Editorial column with key dates
await roxy.Astrology.Horoscope["aries"].Monthly.GetAsync(c => { c.QueryParameters.Date = new Date(2026, 4, 3); c.QueryParameters.Timezone = "America/New_York"; });

// Yearly horoscope by zodiac sign - Year ahead forecast with themes, key periods, eclipses and retrogrades
await roxy.Astrology.Horoscope["aries"].Yearly.GetAsync(c => { c.QueryParameters.Year = 2026; c.QueryParameters.Timezone = "America/New_York"; });

// Planetary Return Chart - Saturn return, Jupiter return, and inner planet cycles
await roxy.Astrology.PlanetaryReturns.PostAsync(new() { BirthDate = new Date(1990, 7, 15), BirthTime = new Time(14, 30, 0), ApproximateDate = new Date(2026, 8, 15), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } });

// Astrocartography map - planetary lines and relocation calculator
await roxy.Astrology.Astrocartography.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } }, c => c.QueryParameters.Include = "chiron");

// Generate relocation chart - Relocated birth chart calculator with shifted houses and angles
await roxy.Astrology.RelocationChart.PostAsync(new() { Date = new Date(1961, 8, 4), Time = new Time(19, 24, 0), Timezone = new() { Double = -10 }, BirthLatitude = 21.3069, BirthLongitude = -157.8583, RelocationLatitude = 40.7167, RelocationLongitude = -74.006 });

// Local space astrology map - Directional planetary compass lines
await roxy.Astrology.LocalSpace.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } }, c => c.QueryParameters.Include = "chiron,lilith");

// Fixed stars and star conjunctions calculator - Regulus, Spica, Algol natal report
await roxy.Astrology.FixedStars.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } }, c => c.QueryParameters.Orb = 1);

// Arabic lots calculator - seven Hermetic parts including Part of Fortune and Spirit
await roxy.Astrology.ArabicLots.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } });

// Asteroid goddesses calculator - Ceres, Pallas, Juno, and Vesta natal positions
await roxy.Astrology.Asteroids.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } });

// Black Moon Lilith calculator - mean and true lunar apogee in the natal chart
await roxy.Astrology.Lilith.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } });

// Secondary progressions calculator - progressed chart, progressed Sun and Moon
await roxy.Astrology.Progressions.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" }, TargetDate = new Date(2025, 7, 15) });

// Solar arc directions calculator - directed chart at one degree per year
await roxy.Astrology.SolarArc.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" }, TargetDate = new Date(2025, 7, 15) });

// Annual profections calculator - lord of the year and yearly time lord by age
await roxy.Astrology.Profections.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" }, TargetDate = new Date(2025, 8, 4) });
```

---

## [Vedic Astrology](https://roxyapi.com/api-reference/vedic-astrology) - `roxy.VedicAstrology`

Vedic astrology (Jyotish) and KP API for kundli generation with the sixteen Shodasavarga divisional charts (D1 to D60...

```csharp
// Get birth chart (D1 Rashi chart) - Kundli Calculator API
await roxy.VedicAstrology.BirthChart.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24, AvasthaInfo = true, ModernPlanets = true });

// Get Navamsa chart (D9) - Marriage Compatibility Calculator
await roxy.VedicAstrology.Navamsa.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// Get divisional chart (Varga) - D2 to D60 Calculator
await roxy.VedicAstrology.DivisionalChart.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24, Division = 10 });

// Calculate compatibility score - Gun Milan API (Ashtakoot Matching)
await roxy.VedicAstrology.Compatibility.PostAsync(new() { Person1 = new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 } }, Person2 = new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 } }, AyanamsaValue = 24 });

// Calculate ten porutham match - Dashakoot South Indian Kundli Matching API
await roxy.VedicAstrology.Compatibility.Dashakoot.PostAsync(new() { Person1 = new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 } }, Person2 = new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 } }, AyanamsaValue = 24 });

// Compare malefic affliction - Papasamyam Kundli Matching API
await roxy.VedicAstrology.Compatibility.Papasamyam.PostAsync(new() { Person1 = new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 } }, Person2 = new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 } }, AyanamsaValue = 24 });

// Get planetary positions - Graha Positions API
await roxy.VedicAstrology.PlanetaryPositions.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// Monthly Ephemeris - Daily sidereal planetary positions for a month
await roxy.VedicAstrology.PlanetaryPositions.Monthly.PostAsync(new() { Year = 2026, Month = 2 });

// Get current Mahadasha, Antardasha, Pratyantardasha, Sookshma, Prana - Dasha Calculator API
await roxy.VedicAstrology.Dasha.Current.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24, Significators = false, Datetime = DateTimeOffset.Parse("2026-08-23T13:47:46Z") });

// Get all 9 Mahadasha periods (120-year cycle)
await roxy.VedicAstrology.Dasha.Major.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24, Significators = false });

// Get all Antardashas (sub-periods) for a specific Mahadasha
await roxy.VedicAstrology.Dasha.Sub["Jupiter"].PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24, Significators = false });

// Get all Pratyantardashas (antara periods) for a Mahadasha and Antardasha
await roxy.VedicAstrology.Dasha.Sub["Saturn"]["Venus"].PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24, Significators = false });

// Get all Sookshma dashas for a Mahadasha, Antardasha and Pratyantardasha
await roxy.VedicAstrology.Dasha.Sub["Saturn"]["Venus"]["Rahu"].PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24, Significators = false });

// Get all Prana dashas for a Mahadasha, Antardasha, Pratyantardasha and Sookshma
await roxy.VedicAstrology.Dasha.Sub["Saturn"]["Venus"]["Rahu"]["Jupiter"].PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24, Significators = false });

// Daily Reading - Composed Gochara, Panchanga and Dasha for one native on one day
await roxy.VedicAstrology.Daily.PostAsync(new() { BirthDate = new Date(1984, 11, 3), BirthTime = new Time(1, 35, 0), Latitude = 28.8944, Longitude = 76.5894, Timezone = new() { Double = 5.5 }, Date = new Date(2026, 6, 21) });

// Get basic Panchang - Tithi Nakshatra Yoga Karana Calculator
await roxy.VedicAstrology.Panchang.Basic.PostAsync(new() { Date = new Date(2025, 12, 17), Time = new Time(12, 0, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 } });

// Get detailed Panchang with Rahu Kaal, Yamaganda, Gulika
await roxy.VedicAstrology.Panchang.Detailed.PostAsync(new() { Date = new Date(2026, 2, 3), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 } });

// Get Choghadiya - 8 Muhurta divisions of day and night
await roxy.VedicAstrology.Panchang.Choghadiya.PostAsync(new() { Date = new Date(2026, 2, 3), Latitude = 17.385044, Longitude = 78.486671, Timezone = new() { Double = 5.5 } });

// Get Hora - 24 Planetary Hours (12 day + 12 night)
await roxy.VedicAstrology.Panchang.Hora.PostAsync(new() { Date = new Date(2026, 2, 3), Latitude = 17.385044, Longitude = 78.486671, Timezone = new() { Double = 5.5 } });

// Check Manglik Dosha - Mangal Dosha Calculator API
await roxy.VedicAstrology.Dosha.Manglik.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// Check Kalsarpa Dosha - Kalsarpa Yoga Calculator API
await roxy.VedicAstrology.Dosha.Kalsarpa.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// Check Sadhesati - Sade Sati Calculator API (Saturn Transit)
await roxy.VedicAstrology.Dosha.Sadhesati.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// List all planetary yogas - 301 entry Vedic Yoga Glossary
await roxy.VedicAstrology.Yoga.GetAsync();

// Get yoga details by ID - Vedic Yoga Glossary Entry
await roxy.VedicAstrology.Yoga["gajakesari"].GetAsync();

// Detect classical Vedic yogas in a birth chart
await roxy.VedicAstrology.Yoga.Detect.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// Get KP-Newcomb ayanamsa - Dynamic daily calculation
await roxy.VedicAstrology.Kp.Ayanamsa.GetAsync(c => { c.QueryParameters.Date = new Date(2025, 12, 26); c.QueryParameters.Time = new Time(9, 0, 0); c.QueryParameters.Timezone = "Asia/Kolkata"; });

// Get KP planetary positions with sub-lords
await roxy.VedicAstrology.Kp.Planets.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// Get KP Placidus house cusps with sub-lords
await roxy.VedicAstrology.Kp.Cusps.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// Generate complete KP birth chart
await roxy.VedicAstrology.Kp.Chart.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// Get KP ruling planets with optional significators
await roxy.VedicAstrology.Kp.RulingPlanets.PostAsync(new() { Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, Datetime = DateTimeOffset.Parse("2025-01-15T10:30:00Z"), BirthDate = new Date(1990, 7, 4), BirthTime = new Time(10, 12, 0) });

// Get KP ruling planets with significators at intervals
await roxy.VedicAstrology.Kp.RulingPlanetsInterval.PostAsync(new() { StartDatetime = DateTimeOffset.Parse("2026-02-03T00:00:00Z"), EndDatetime = DateTimeOffset.Parse("2026-02-03T01:00:00Z"), IntervalMinutes = 5, Latitude = 17.385044, Longitude = 78.486671, Timezone = new() { Double = 5.5 } });

// Find KP sublord changes
await roxy.VedicAstrology.Kp.SublordChanges.PostAsync(new() { StartDate = new Date(2025, 1, 1), EndDate = new Date(2025, 1, 31), Timezone = new() { Double = 5.5 } });

// Find KP rasi ingress times
await roxy.VedicAstrology.Kp.RasiChanges.PostAsync(new() { StartDate = new Date(2025, 1, 1), EndDate = new Date(2025, 12, 31), Timezone = new() { Double = 5.5 } });

// Get KP planets at time intervals
await roxy.VedicAstrology.Kp.PlanetsInterval.PostAsync(new() { StartDatetime = DateTimeOffset.Parse("2025-01-15T00:00:00Z"), EndDatetime = DateTimeOffset.Parse("2025-01-15T23:59:00Z"), IntervalMinutes = 60, Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 } });

// Cast a KP horary (Prashna) chart from a number 1-249 - KP Horary API
await roxy.VedicAstrology.Kp.Horary.PostAsync(new() { HoraryNumber = 108, Date = new Date(2026, 3, 8), Time = new Time(14, 30, 0), Latitude = 19.076, Longitude = 72.8777, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// Daily finance score from four KP sub lord layers - KP Daily Finance API
await roxy.VedicAstrology.Kp.DailyFinance.PostAsync(new() { BirthDate = new Date(1990, 6, 15), BirthTime = new Time(7, 30, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, Date = new Date(2026, 9, 14), Time = new Time(12, 0, 0), GainHouses = [2], LossHouses = [6], Weights = new() { Cusps = 30, Dasha = 40, RulingPlanets = 15, MoonWindows = 15 } });

// Get planetary aspects (Drishti) - Mutual aspects between all planets
await roxy.VedicAstrology.Aspects.PostAsync(new() { Date = new Date(2026, 2, 3), Time = new Time(12, 0, 0), Latitude = 17.385044, Longitude = 78.486671, Timezone = new() { Double = 5.5 } });

// Monthly Planetary Aspects - Major and minor aspect events for a month
await roxy.VedicAstrology.Aspects.Monthly.PostAsync(new() { Year = 2026, Month = 2, Timezone = new() { Double = 5.5 } });

// Monthly Lunar Aspects - Moon aspect events with all planets for a month
await roxy.VedicAstrology.Aspects.Lunar.PostAsync(new() { Year = 2026, Month = 2, Timezone = new() { Double = 5.5 } });

// Transit Analysis - Compare current planets to natal chart (Gochar)
await roxy.VedicAstrology.Transit.PostAsync(new() { BirthDate = new Date(1990, 7, 4), BirthTime = new Time(10, 12, 0), TransitDate = new Date(2026, 2, 3), TransitTime = new Time(12, 0, 0), Latitude = 17.385044, Longitude = 78.486671, Timezone = new() { Double = 5.5 } });

// Monthly Transit - Planetary sign changes for an entire month
await roxy.VedicAstrology.Transit.Monthly.PostAsync(new() { Year = 2026, Month = 2, Timezone = new() { Double = 5.5 } });

// Declination Parallels - Planets at same or opposite declination
await roxy.VedicAstrology.Parallels.PostAsync(new() { Date = new Date(2026, 2, 3), Time = new Time(12, 0, 0), Latitude = 17.385044, Longitude = 78.486671, Timezone = new() { Double = 5.5 }, Orb = 1.5 });

// Monthly Declination Parallels - Parallel and contraparallel events for a month
await roxy.VedicAstrology.Parallels.Monthly.PostAsync(new() { Year = 2026, Month = 2, Timezone = new() { Double = 5.5 } });

// Ecliptic Crossings - When planets cross the ecliptic plane
await roxy.VedicAstrology.EclipticCrossings.PostAsync(new() { Year = 2026, Timezone = new() { Double = 5.5 } });

// List all 12 Rashis - Vedic Zodiac Signs Reference
await roxy.VedicAstrology.Rashis.GetAsync();

// Get Rashi by ID - Vedic Zodiac Sign Detail
await roxy.VedicAstrology.Rashis["mesha"].GetAsync();

// List all 27 Nakshatras - Lunar Mansions Reference
await roxy.VedicAstrology.Nakshatras.GetAsync();

// Get Nakshatra by ID - Lunar Mansion Detail
await roxy.VedicAstrology.Nakshatras["ashwini"].GetAsync();

// Get upagraha (sub-planet) positions - Upagraha Calculator API
await roxy.VedicAstrology.Upagraha.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// Get Ashtakavarga (planetary strength) analysis - Ashtakavarga Calculator API
await roxy.VedicAstrology.Ashtakavarga.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// Get Shadbala (six-fold planetary strength) analysis - Shadbala Calculator API
await roxy.VedicAstrology.Shadbala.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// List all 17 avastha states - Planetary State Reference
await roxy.VedicAstrology.Avasthas.GetAsync();

// Get avastha by ID - Planetary State Detail
await roxy.VedicAstrology.Avasthas["dipta"].GetAsync();

// Get the twelve Arudha padas - Arudha Lagna Calculator API
await roxy.VedicAstrology.Arudha.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// Get Chara Karakas including Atmakaraka - Jaimini Karaka Calculator API
await roxy.VedicAstrology.CharaKarakas.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// Get Bhava Bala (house strength) for all twelve houses - Bhava Bala Calculator API
await roxy.VedicAstrology.BhavaBala.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// Get the Bhav Chalit (Chalit Kundli) cusp-based house chart - Bhav Chalit API
await roxy.VedicAstrology.BhavChalit.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// Heliacal rising and setting (udaya and asta) - Graha Asta Calculator API
await roxy.VedicAstrology.Heliacal.PostAsync(new() { Date = new Date(2026, 7, 25), Latitude = 19.076, Longitude = 72.8777, Timezone = new() { Double = 5.5 } });
```

---

## [Forecast](https://roxyapi.com/api-reference/forecast) - `roxy.Forecast`

Astrology forecast API that merges upcoming transit aspects, sign ingresses, retrograde stations, new and full moons,...

```csharp
// Cross-domain forecast timeline - Transits, ingresses, stations, dasha changes, critical days
await roxy.Forecast.Timeline.PostAsync(new() { BirthData = new() { Date = new Date(1990, 7, 15), Time = new Time(13, 30, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 0 }, StartDate = new Date(2026, 6, 1), EndDate = new Date(2026, 8, 30), MinSignificance = 0, DomainWeights = new() { Western = 1.5, Vedic = 1.5, Biorhythm = 1.5 } });

// Western astrology forecast - aspects, ingresses, stations, eclipses, moon phases
await roxy.Forecast.Transits.PostAsync(new() { BirthData = new() { Date = new Date(1990, 7, 15), Time = new Time(13, 30, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 0 }, StartDate = new Date(2026, 6, 1), EndDate = new Date(2026, 8, 30), MinSignificance = 0 });

// Significant dates - High-significance cross-domain forecast highlights
await roxy.Forecast.SignificantDates.PostAsync(new() { BirthData = new() { Date = new Date(1990, 7, 15), Time = new Time(13, 30, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 0 }, StartDate = new Date(2026, 6, 1), EndDate = new Date(2026, 8, 30), MinSignificance = 70, DomainWeights = new() { Western = 1.5, Vedic = 1.5, Biorhythm = 1.5 } });

// Forecast digest - Pre-summarized next 24h, 7d, 30d, and 90d rollups
await roxy.Forecast.Digest.PostAsync(new() { BirthData = new() { Date = new Date(1990, 7, 15), Time = new Time(13, 30, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 0 }, StartDate = new Date(2026, 6, 1), MinSignificance = 0, DomainWeights = new() { Western = 1.5, Vedic = 1.5, Biorhythm = 1.5 }, Top = 3 });

// Solar return chart - Annual birthday forecast chart for a single subject
await roxy.Forecast.SolarReturn.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Year = 2026, Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" } });
```

---

## [Human Design](https://roxyapi.com/api-reference/human-design) - `roxy.HumanDesign`

Human Design API that generates the full bodygraph from a birth moment: type, strategy, inner authority, profile, def...

```csharp
// Generate full Human Design bodygraph - Type, authority, profile, centers, channels, gates
await roxy.HumanDesign.Bodygraph.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(13, 0, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 0 });

// Calculate Human Design connection chart - Two-person composite bodygraph compatibility
await roxy.HumanDesign.Connection.PostAsync(new() { PersonA = new() { Date = new Date(1990, 7, 15), Time = new Time(13, 0, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 0 }, PersonB = new() { Date = new Date(1990, 7, 15), Time = new Time(13, 0, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 0 } });

// Calculate Human Design Penta - Small-group BG5 operating system for three to five people
await roxy.HumanDesign.Penta.PostAsync(new() { Members = [new() { Date = new Date(1990, 7, 15), Time = new Time(13, 0, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 0 }] });

// Generate Human Design transit overlay - Current planetary activations on a natal bodygraph
await roxy.HumanDesign.Transit.PostAsync(new() { BirthData = new() { Date = new Date(1990, 7, 15), Time = new Time(13, 0, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 0 }, Date = new Date(2026, 5, 23), Time = new Time(12, 0, 0) });

// Calculate Human Design type, authority and profile
await roxy.HumanDesign.Type.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(13, 0, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 0 });

// Calculate the 26 Human Design gate activations
await roxy.HumanDesign.Gates.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(13, 0, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 0 });

// Look up a Human Design gate by number
await roxy.HumanDesign.Gates[34].GetAsync();

// Calculate the defined Human Design channels
await roxy.HumanDesign.Channels.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(13, 0, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 0 });

// Calculate the nine Human Design centers
await roxy.HumanDesign.Centers.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(13, 0, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 0 });

// Look up a Human Design center by id
await roxy.HumanDesign.Centers["sacral"].GetAsync();

// Calculate the Human Design profile and line keynotes
await roxy.HumanDesign.Profile.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(13, 0, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 0 });

// Calculate Human Design Variables - The four arrows and Color, Tone, Base substructure
await roxy.HumanDesign.Variables.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(13, 0, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 0 });
```

---

## [Chinese Astrology](https://roxyapi.com/api-reference/chinese-astrology) - `roxy.ChineseAstrology`

Chinese zodiac and BaZi astrology API: Four Pillars charts, Chinese zodiac signs and the Chinese lunisolar calendar f...

```csharp
// Generate BaZi chart - Four Pillars of Destiny calculator API
await roxy.ChineseAstrology.Bazi.Chart.PostAsync(new() { Date = new Date(1990, 6, 15), Time = new Time(14, 30, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 116.4 });

// Calculate luck pillars - BaZi Da Yun ten-year cycle API
await roxy.ChineseAstrology.Bazi.LuckPillars.PostAsync(new() { Date = new Date(1990, 6, 15), Time = new Time(14, 30, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 116.4, Count = 8, AnnualFromYear = 2026, AnnualYears = 10 });

// Calculate Day Master strength - BaZi favorable element API
await roxy.ChineseAstrology.Bazi.DayMaster.PostAsync(new() { Date = new Date(1990, 6, 15), Time = new Time(14, 30, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 116.4 });

// Calculate BaZi compatibility - Four Pillars matchmaking API
await roxy.ChineseAstrology.Bazi.Compatibility.PostAsync(new() { PersonA = new() { Date = new Date(1990, 6, 15), Time = new Time(14, 30, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 116.4 }, PersonB = new() { Date = new Date(1990, 6, 15), Time = new Time(14, 30, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 116.4 } });

// Calculate BaZi annual forecast - Liu Nian yearly pillar API
await roxy.ChineseAstrology.Bazi.AnnualForecast.PostAsync(new() { Date = new Date(1990, 6, 15), Time = new Time(14, 30, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 116.4, Year = 2026 });

// List the 12 Chinese zodiac animals - Sheng Xiao sign catalogue
await roxy.ChineseAstrology.Zodiac.Animals.GetAsync(c => { c.QueryParameters.Limit = 12; c.QueryParameters.Offset = 0; });

// Get one Chinese zodiac animal - Full sign profile with compatibility partners
await roxy.ChineseAstrology.Zodiac.Animals["rat"].GetAsync();

// Find the Chinese zodiac animal for a birth date - Sheng Xiao calculator
await roxy.ChineseAstrology.Zodiac.Sign.PostAsync(new() { Date = new Date(1990, 6, 15) });

// Chinese zodiac compatibility - Trine, six harmony, clash and harm analysis
await roxy.ChineseAstrology.Zodiac.Compatibility["rat"]["dragon"].GetAsync();

// Daily Chinese zodiac reading - Day pillar forecast by animal sign
await roxy.ChineseAstrology.Zodiac["rat"].Daily.GetAsync(c => { c.QueryParameters.Date = new Date(2026, 4, 3); c.QueryParameters.Timezone = "America/New_York"; });

// List the 24 solar terms - Jie Qi calendar API with exact instants
await roxy.ChineseAstrology.Calendar.SolarTerms[2026].GetAsync();

// Convert lunar and Gregorian dates - Chinese lunisolar calendar API
await roxy.ChineseAstrology.Calendar.LunarDate.PostAsync(new() { Date = new Date(1990, 6, 15), LunarYear = 1990, LunarMonth = 5, LunarDay = 23, IsLeapMonth = false });

// Get the almanac for a day - Tong Shu API with day officers and mansions
await roxy.ChineseAstrology.Calendar.Day[new Date(1990, 6, 15)].GetAsync();

// Get a month of almanac days - Chinese calendar month view API
await roxy.ChineseAstrology.Calendar.Monthly.GetAsync(c => { c.QueryParameters.Year = 1990; c.QueryParameters.Month = 6; });

// Find auspicious days - Chinese date selection API for weddings and openings
await roxy.ChineseAstrology.Calendar.AuspiciousDays.PostAsync(new() { StartDate = new Date(2026, 3, 1), EndDate = new Date(2026, 4, 30) });

// List the five elements - Wu Xing API with generating and controlling cycles
await roxy.ChineseAstrology.Elements.GetAsync(c => { c.QueryParameters.Limit = 5; c.QueryParameters.Offset = 0; });
```

---

## [Feng Shui](https://roxyapi.com/api-reference/feng-shui) - `roxy.FengShui`

Compute classical feng shui from one API: Xuan Kong flying star natal charts for any of the nine periods and 24 mount...

```csharp
// Calculate Kua number - Feng shui personal direction calculator API
await roxy.FengShui.Kua.PostAsync(new() { Date = new Date(1985, 7, 15) });

// Look up a Kua number - Eight Mansions reference API
await roxy.FengShui.Kua[8].GetAsync();

// Generate Eight Mansions map - Ba Zhai lucky direction API
await roxy.FengShui.EightMansions.PostAsync(new() { Kua = 6, Date = new Date(1985, 7, 15) });

// Generate flying star natal chart - Xuan Kong Fei Xing API
await roxy.FengShui.FlyingStars.Natal.PostAsync(new() { Period = 9, FacingDegrees = 180 });

// Annual flying stars - Yearly feng shui star chart API
await roxy.FengShui.FlyingStars.Annual[2026].GetAsync();

// Monthly flying stars - Month by month feng shui overlay API
await roxy.FengShui.FlyingStars.Monthly.GetAsync(c => { c.QueryParameters.Year = 2026; c.QueryParameters.Month = 1; });

// List the nine flying stars - Xuan Kong star reference API
await roxy.FengShui.FlyingStars.Stars.GetAsync(c => { c.QueryParameters.Limit = 9; c.QueryParameters.Offset = 0; });

// Annual afflictions - Tai Sui, San Sha and Five Yellow API
await roxy.FengShui.Afflictions[2026].GetAsync();

// List Bagua sectors - Feng shui bagua map API
await roxy.FengShui.Bagua.GetAsync(c => { c.QueryParameters.Limit = 9; c.QueryParameters.Offset = 0; });

// Look up a Bagua sector - Life area reference API
await roxy.FengShui.Bagua["wealth"].GetAsync();

// List the nine periods - San Yuan period table API
await roxy.FengShui.Periods.GetAsync(c => c.QueryParameters.Date = new Date(2026, 8, 23));
```

---

## [Mesoamerican Astrology](https://roxyapi.com/api-reference/mesoamerican-astrology) - `roxy.MesoamericanAstrology`

Calculate Mayan astrology day signs, the Tzolkin sacred round, the Haab year, the full Long Count and the Aztec tonal...

```csharp
// Mayan day sign for a date - Tzolkin calculator API
await roxy.MesoamericanAstrology.Mayan.Tzolkin.PostAsync(new() { Date = new Date(2012, 12, 21) });

// Generate a Mayan chart - Tzolkin, Haab and Long Count calculator API
await roxy.MesoamericanAstrology.Mayan.Chart.PostAsync(new() { Date = new Date(2012, 12, 21) });

// Convert a Maya Long Count - Long Count calendar converter API
await roxy.MesoamericanAstrology.Mayan.LongCount.Convert.PostAsync(new() { Date = new Date(2012, 12, 21), LongCount = "13.0.0.0.0" });

// Daily Mayan energy reading - Tzolkin day sign of the day API
await roxy.MesoamericanAstrology.Mayan.Daily.GetAsync(c => c.QueryParameters.Date = new Date(2026, 9, 2));

// Monthly Tzolkin calendar grid - Maya calendar month API
await roxy.MesoamericanAstrology.Mayan.Calendar.Monthly.GetAsync(c => { c.QueryParameters.Year = 2026; c.QueryParameters.Month = 9; });

// Mayan nawal compatibility - Tzolkin pair analysis API
await roxy.MesoamericanAstrology.Mayan.Compatibility.PostAsync(new() { PersonA = new() { Date = new Date(2012, 12, 21) }, PersonB = new() { Date = new Date(2012, 12, 21) } });

// List the 20 Mayan day signs - Tzolkin nawal catalogue API
await roxy.MesoamericanAstrology.Mayan.DaySigns.GetAsync(c => { c.QueryParameters.Limit = 20; c.QueryParameters.Offset = 0; });

// Get one Mayan day sign - Nawal profile API
await roxy.MesoamericanAstrology.Mayan.DaySigns["imix"].GetAsync();

// List the 20 Mayan trecenas - Tzolkin thirteen day period API
await roxy.MesoamericanAstrology.Mayan.Trecenas.GetAsync(c => { c.QueryParameters.Limit = 20; c.QueryParameters.Offset = 0; });

// Get one Mayan trecena - Thirteen day period profile API
await roxy.MesoamericanAstrology.Mayan.Trecenas[1].GetAsync();

// List the 19 Haab periods - Maya solar calendar month API
await roxy.MesoamericanAstrology.Mayan.HaabMonths.GetAsync(c => { c.QueryParameters.Limit = 19; c.QueryParameters.Offset = 0; });

// Get one Haab period - Maya solar calendar month profile API
await roxy.MesoamericanAstrology.Mayan.HaabMonths["pop"].GetAsync();

// Aztec day sign for a date - Tonalpohualli calculator API
await roxy.MesoamericanAstrology.Aztec.Tonalpohualli.PostAsync(new() { Date = new Date(2012, 12, 21) });

// Daily Aztec energy reading - Tonalpohualli day sign of the day API
await roxy.MesoamericanAstrology.Aztec.Daily.GetAsync(c => c.QueryParameters.Date = new Date(2026, 9, 2));

// List the 20 Aztec day signs - Tonalpohualli sign catalogue API
await roxy.MesoamericanAstrology.Aztec.DaySigns.GetAsync(c => { c.QueryParameters.Limit = 20; c.QueryParameters.Offset = 0; });

// Get one Aztec day sign - Tonalpohualli sign profile API
await roxy.MesoamericanAstrology.Aztec.DaySigns["cipactli"].GetAsync();

// List the 20 Aztec trecenas - Tonalpohualli thirteen day period API
await roxy.MesoamericanAstrology.Aztec.Trecenas.GetAsync(c => { c.QueryParameters.Limit = 20; c.QueryParameters.Offset = 0; });

// Get one Aztec trecena - Tonalpohualli period profile API
await roxy.MesoamericanAstrology.Aztec.Trecenas[1].GetAsync();
```

---

## [Vastu](https://roxyapi.com/api-reference/vastu) - `roxy.Vastu`

Vastu Shastra API for directional home and plot analysis: entrance padas with the classical effect of each of the 32...

```csharp
// Calculate entrance pada - Vastu main door direction API
await roxy.Vastu.Entrance.PostAsync(new() { Plot = new() { Width = 30, Depth = 40, Polygon = [new() { X = 15, Y = 0 }] }, FacingDegrees = 15, DoorPosition = 0.4 });

// Generate Vastu Purusha Mandala - 81 pada and 64 pada grid API
await roxy.Vastu.Mandala.PostAsync(new() { Plot = new() { Width = 30, Depth = 40, Polygon = [new() { X = 15, Y = 0 }] } });

// Analyse a plot - Vastu land and site assessment API
await roxy.Vastu.Plot.PostAsync(new() { Plot = new() { Width = 30, Depth = 40, Polygon = [new() { X = 15, Y = 0 }] }, FacingDegrees = 15 });

// Calculate Ayadi shadvarga - Vastu proportion and yoni calculator API
await roxy.Vastu.Ayadi.PostAsync(new() { Length = 11, Breadth = 11, Perimeter = 11, Circumference = 11, HastaInches = 18 });

// Check room placement - Vastu room direction compliance API
await roxy.Vastu.Rooms.PostAsync(new() { Plot = new() { Width = 30, Depth = 40, Polygon = [new() { X = 15, Y = 0 }] }, FacingDegrees = 15, Rooms = [new() { Polygon = [new() { X = 15, Y = 0 }] }] });

// Find griha pravesh dates - Vastu house warming muhurta API
await roxy.Vastu.Timing.GrihaPravesh.PostAsync(new() { StartDate = new Date(2027, 1, 20), EndDate = new Date(2027, 3, 20), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { String = "America/New_York" } });

// List the eight directions - Vastu dikpala and direction reference API
await roxy.Vastu.Directions.GetAsync(c => { c.QueryParameters.Limit = 8; c.QueryParameters.Offset = 0; });

// Look up one direction - Vastu dikpala reference API
await roxy.Vastu.Directions["Northeast"].GetAsync();

// List the 45 devatas - Vastu Purusha Mandala reference API
await roxy.Vastu.Devatas.GetAsync(c => { c.QueryParameters.Limit = 45; c.QueryParameters.Offset = 0; });

// Look up one devata - Vastu mandala devata reference API
await roxy.Vastu.Devatas["jayanta"].GetAsync();
```

---

## [Numerology](https://roxyapi.com/api-reference/numerology) - `roxy.Numerology`

Numerology API for life path numbers, complete numerology charts and compatibility, in both Pythagorean and Chaldean...

```csharp
// Calculate Life Path number - Calculator and meaning API
await roxy.Numerology.LifePath.PostAsync(new() { Year = 1990, Month = 7, Day = 15 });

// Calculate Expression number - Destiny number calculator API
await roxy.Numerology.Expression.PostAsync(new() { FullName = "John William Smith" });

// Calculate Bridge Numbers - Numerology bridge numbers API
await roxy.Numerology.Bridge.PostAsync(new() { FullName = "John William Smith", Year = 1990, Month = 7, Day = 15 });

// Calculate Soul Urge number - Heart Desire number calculator API
await roxy.Numerology.SoulUrge.PostAsync(new() { FullName = "John William Smith" });

// Calculate Personality number - Outer personality numerology API
await roxy.Numerology.Personality.PostAsync(new() { FullName = "John William Smith" });

// Calculate Birth Day number - Birthday numerology API
await roxy.Numerology.BirthDay.PostAsync(new() { Day = 23 });

// Calculate Maturity number - Realization number numerology API
await roxy.Numerology.Maturity.PostAsync(new() { LifePath = 5, Expression = 7, FullName = "John William Smith", Year = 1990, Month = 7, Day = 15 });

// Analyze Karmic Lessons - Missing numbers numerology API
await roxy.Numerology.KarmicLessons.PostAsync(new() { FullName = "John William Smith" });

// Detect Karmic Debt numbers - Karmic debt 13, 14, 16, 19 API
await roxy.Numerology.KarmicDebt.PostAsync(new() { Year = 1990, Month = 7, Day = 15, FullName = "John William Smith" });

// Calculate Personal Day - Daily numerology forecast API
await roxy.Numerology.PersonalDay.PostAsync(new() { Month = 7, Day = 18, TargetDate = new Date(2026, 4, 4) });

// Calculate Personal Month - Monthly numerology forecast API
await roxy.Numerology.PersonalMonth.PostAsync(new() { Month = 7, Day = 18, Year = 2026, TargetMonth = 4 });

// Calculate Personal Year - Personal Year number forecast API
await roxy.Numerology.PersonalYear.PostAsync(new() { Month = 7, Day = 15, Year = 2025 });

// Calculate numerology compatibility - Love match scoring API
await roxy.Numerology.Compatibility.PostAsync(new() { Person1 = new() { FullName = "John William Smith", Year = 1990, Month = 7, Day = 15, LifePath = 5, Expression = 7, SoulUrge = 6 }, Person2 = new() { FullName = "Jane Marie Doe", Year = 1992, Month = 3, Day = 22, LifePath = 3, Expression = 9, SoulUrge = 2 } });

// Generate numerology chart - Complete numerology reading API
await roxy.Numerology.Chart.PostAsync(new() { FullName = "John William Smith", Year = 1990, Month = 7, Day = 15, CurrentYear = 2025, TargetDate = new Date(2026, 10, 28) });

// Get number meaning - Numerology number meanings API
await roxy.Numerology.Meanings["5"].GetAsync();

// Get daily numerology number - Number of the Day API
await roxy.Numerology.Daily.PostAsync(new() { Seed = "user123", Date = new Date(2026, 3, 6) });

// Calculate Chaldean numerology - Chaldean name number calculator API
await roxy.Numerology.Chaldean.PostAsync(new() { Name = "Helen" });

// Get compound number meaning - Chaldean compound numbers 10 to 52 API
await roxy.Numerology.CompoundNumber["23"].GetAsync();

// Calculate dual numerology - Pythagorean and Chaldean name number API
await roxy.Numerology.Dual.PostAsync(new() { Name = "David" });

// Calculate business name numerology - Brand name numerology API
await roxy.Numerology.BusinessName.PostAsync(new() { Name = "Ford" });
```

---

## [Kabbalah](https://roxyapi.com/api-reference/kabbalah) - `roxy.Kabbalah`

Kabbalah API for gematria, the 72 names, the Tree of Life and the Hebrew birthday

```csharp
// Calculate gematria - Hebrew gematria calculator API with every spelling shown
await roxy.Kabbalah.Gematria.PostAsync(new() { Text = "Sarah", TextHebrew = "שלום", IncludeMatches = true, LatinCiphers = false });

// List gematria ciphers - gematria methods API with provenance on every row
await roxy.Kabbalah.Ciphers.GetAsync();

// Generate a name profile - Kabbalah name numerology API with the spelling shown
await roxy.Kabbalah.NameProfile.PostAsync(new() { Name = "Sarah", NameHebrew = "שרה" });

// Generate a birth profile - Hebrew birthday and birth angel API
await roxy.Kabbalah.BirthProfile.PostAsync(new() { Date = new Date(1990, 6, 15), Time = new Time(14, 30, 0), Timezone = new() { String = "America/New_York" }, AfterSunset = false, TargetDate = new Date(2026, 10, 28) });

// List the 72 names - Shem HaMephorash API derived from the verses
await roxy.Kabbalah.Names.GetAsync(c => { c.QueryParameters.Limit = 20; c.QueryParameters.Offset = 0; c.QueryParameters.Longitude = 131.18; });

// Get one of the 72 names - 72 names of God API by index
await roxy.Kabbalah.Names[27].GetAsync();

// Get the Tree of Life - sephirot and 22 paths API with typed school variants
await roxy.Kabbalah.Tree.GetAsync();

// Get one sephirah - sefirot meaning API with the paths that touch it
await roxy.Kabbalah.Sephirot["tiferet"].GetAsync();

// List the Hebrew letters - Hebrew alphabet API with the Sefer Yetzirah attributions
await roxy.Kabbalah.Letters.GetAsync();

// Get one Hebrew letter - Hebrew letter meaning API
await roxy.Kabbalah.Letters["shin"].GetAsync();

// Compare two names - gematria name compatibility API with every component published
await roxy.Kabbalah.Compatibility.PostAsync(new() { FirstName = "Sarah", FirstNameHebrew = "שרה", SecondName = "David", SecondNameHebrew = "דוד" });

// Get the sephirah of the day - Omer count API with the sephirot pairing
await roxy.Kabbalah.Daily.GetAsync(c => { c.QueryParameters.Date = new Date(2026, 4, 4); c.QueryParameters.Timezone = "Asia/Jerusalem"; c.QueryParameters.AfterSunset = "false"; });
```

---

## [Tarot](https://roxyapi.com/api-reference/tarot) - `roxy.Tarot`

Tarot reading API with the complete 78-card Rider-Waite-Smith deck and card meanings for love, career, health, and sp...

```csharp
// List all 78 tarot cards - Tarot deck catalog API
await roxy.Tarot.Cards.GetAsync(c => { c.QueryParameters.Limit = 20; c.QueryParameters.Offset = 0; c.QueryParameters.Number = 1; });

// Get tarot card by id - Tarot card meaning API
await roxy.Tarot.Cards["fool"].GetAsync();

// Draw tarot cards - Seeded tarot draw API
await roxy.Tarot.Draw.PostAsync(new() { Count = 3, Seed = "user123-2025-12-27", AllowReversals = true, AllowDuplicates = false });

// Daily tarot card - Card of the day API
await roxy.Tarot.Daily.PostAsync(new() { Seed = "user123", Date = new Date(2026, 3, 6) });

// Yes or no answer - Yes no tarot reading API
await roxy.Tarot.YesNo.PostAsync(new() { Question = "Should I accept the job offer?", Seed = "reading-2f9c1a" });

// Three card spread, past present future - Tarot spread API
await roxy.Tarot.Spreads.ThreeCard.PostAsync(new() { Question = "What do I need to know about my career?", Seed = "reading-2f9c1a" });

// Celtic Cross spread, 10 cards - Tarot spread API
await roxy.Tarot.Spreads.CelticCross.PostAsync(new() { Question = "What should I know about this situation?", Seed = "reading-2f9c1a" });

// Love spread, 5 cards - Relationship tarot reading API
await roxy.Tarot.Spreads.Love.PostAsync(new() { Question = "What do I need to know about my relationship?", Seed = "reading-2f9c1a" });

// Career spread, 7 cards - Career tarot reading API
await roxy.Tarot.Spreads.Career.PostAsync(new() { Question = "What do I need to know about my career path?", Seed = "reading-2f9c1a" });

// Custom spread builder - Configurable tarot spread API
await roxy.Tarot.Spreads.Custom.PostAsync(new() { SpreadName = "My Custom Spread", Positions = [new() { Name = "Core Issue", Interpretation = "What is really going on" }], Question = "How do I move forward with this project?", Seed = "reading-2f9c1a" });
```

---

## [Biorhythm](https://roxyapi.com/api-reference/biorhythm) - `roxy.Biorhythm`

Biorhythm API for entertainment and reflection, with 10 model cycle types across 3 primary (physical, emotional, inte...

```csharp
// Get biorhythm reading - Complete cycle analysis for any date
await roxy.Biorhythm.Reading.PostAsync(new() { BirthDate = new Date(1990, 7, 15), TargetDate = new Date(2026, 4, 10) });

// Get biorhythm forecast - Multi-day cycle predictions with best and worst days
await roxy.Biorhythm.Forecast.PostAsync(new() { BirthDate = new Date(1990, 7, 15), StartDate = new Date(2026, 4, 1), EndDate = new Date(2026, 4, 30) });

// Find critical days - Zero crossing detection for any date range
await roxy.Biorhythm.CriticalDays.PostAsync(new() { BirthDate = new Date(1990, 7, 15), StartDate = new Date(2026, 4, 1), EndDate = new Date(2026, 6, 30) });

// Calculate compatibility - Biorhythm alignment between two people
await roxy.Biorhythm.Compatibility.PostAsync(new() { Person1 = new() { BirthDate = new Date(1990, 7, 15) }, Person2 = new() { BirthDate = new Date(1992, 3, 22) }, TargetDate = new Date(2026, 4, 10) });

// Get phase info - Lightweight cycle status for dashboards and widgets
await roxy.Biorhythm.Phases.PostAsync(new() { BirthDate = new Date(1990, 7, 15), TargetDate = new Date(2026, 4, 10) });

// Get daily biorhythm - Seeded reading for daily check-in features
await roxy.Biorhythm.Daily.PostAsync(new() { Seed = "user123", Date = new Date(2026, 3, 6) });
```

---

## [Ayurveda](https://roxyapi.com/api-reference/ayurveda) - `roxy.Ayurveda`

Ayurveda API for dosha profiles, the dinacharya daily routine and the ritucharya seasonal regimen, with a verse cited...

```csharp
// Ayurvedic constitution from a birth chart - Dosha profile API
await roxy.Ayurveda.Constitution.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24 });

// Dinacharya daily routine - Brahma muhurta and dosha clock API
await roxy.Ayurveda.Dinacharya.PostAsync(new() { Date = new Date(2026, 6, 21), Latitude = 51.5074, Longitude = -0.1278, Timezone = new() { String = "Europe/London" } });

// Ayurveda seasonal regimen - Ritucharya and ritu resolution API
await roxy.Ayurveda.Ritucharya.PostAsync(new() { Date = new Date(2026, 3, 1) });

// Daily Ayurveda reading - Dosha clock and brahma muhurta by location API
await roxy.Ayurveda.Daily.GetAsync(c => { c.QueryParameters.Date = new Date(2026, 6, 21); c.QueryParameters.Latitude = 51.5074; c.QueryParameters.Longitude = -0.1278; c.QueryParameters.Timezone = "Europe/London"; });

// List the three doshas - Dosha catalogue API
await roxy.Ayurveda.Doshas.GetAsync(c => { c.QueryParameters.Limit = 3; c.QueryParameters.Offset = 0; });

// Get one dosha - Vata pitta kapha profile API
await roxy.Ayurveda.Doshas["vata"].GetAsync();

// List the six tastes - Ayurveda rasa and dosha matrix API
await roxy.Ayurveda.Tastes.GetAsync(c => { c.QueryParameters.Limit = 6; c.QueryParameters.Offset = 0; });

// List the twenty qualities - Ayurveda guna pairs API
await roxy.Ayurveda.Qualities.GetAsync(c => { c.QueryParameters.Limit = 10; c.QueryParameters.Offset = 0; });
```

---

## [I-Ching](https://roxyapi.com/api-reference/i-ching) - `roxy.Iching`

I-Ching oracle API with all 64 hexagrams, 384 changing lines, 8 trigrams, and modern interpretations for love, career...

```csharp
// Daily hexagram - Daily I-Ching oracle API
await roxy.Iching.Daily.PostAsync(new() { Seed = "user123", Date = new Date(2026, 3, 6) });

// Cast daily reading with changing lines - I-Ching divination API
await roxy.Iching.Daily.Cast.PostAsync(new() { Seed = "user123", Date = new Date(2026, 3, 6) });

// List all 64 hexagrams - I-Ching hexagram catalog API
await roxy.Iching.Hexagrams.GetAsync(c => { c.QueryParameters.Limit = 20; c.QueryParameters.Offset = 0; });

// Random hexagram - I-Ching hexagram picker API
await roxy.Iching.Hexagrams.Random.GetAsync();

// Lookup hexagram by line pattern - I-Ching binary lookup API
await roxy.Iching.Hexagrams.Lookup.GetAsync(c => c.QueryParameters.Lines = "111111");

// Get hexagram by number - I-Ching hexagram detail API
await roxy.Iching.Hexagrams[1].GetAsync();

// Cast an I-Ching reading - Hexagram divination API
await roxy.Iching.Cast.GetAsync(c => c.QueryParameters.Seed = "user123-question1");

// List all 8 trigrams - Bagua trigram catalog API
await roxy.Iching.Trigrams.GetAsync();

// Get trigram by number or name - Bagua trigram detail API
await roxy.Iching.Trigrams["Heaven"].GetAsync();
```

---

## [Crystals and Healing Stones](https://roxyapi.com/api-reference/crystals-and-healing-stones) - `roxy.Crystals`

Crystal healing API covering the most popular and widely-searched healing crystals and gemstones, from Amethyst and R...

```csharp
// Crystals by zodiac sign - Zodiac birthstone API
await roxy.Crystals.Zodiac["pisces"].GetAsync(c => { c.QueryParameters.Limit = 20; c.QueryParameters.Offset = 0; });

// Crystals by chakra - Chakra healing stones API
await roxy.Crystals.Chakra["Heart"].GetAsync(c => { c.QueryParameters.Limit = 20; c.QueryParameters.Offset = 0; });

// Crystals by element - Elemental crystal lookup API
await roxy.Crystals.Element["Water"].GetAsync(c => { c.QueryParameters.Limit = 20; c.QueryParameters.Offset = 0; });

// Birthstones by month - Birthstone lookup API
await roxy.Crystals.Birthstone[2].GetAsync();

// Search crystals - Crystal search API
await roxy.Crystals.Search.GetAsync(c => { c.QueryParameters.Q = "love"; c.QueryParameters.Limit = 20; c.QueryParameters.Offset = 0; });

// Crystal pairings - Crystal combination API
await roxy.Crystals.Pairings["amethyst"].GetAsync();

// Daily crystal - Crystal of the day API
await roxy.Crystals.Daily.PostAsync(new() { Seed = "user123", Date = new Date(2026, 3, 6) });

// Random crystal - Crystal discovery API
await roxy.Crystals.Random.GetAsync();

// List crystal colors - Crystal color filter API
await roxy.Crystals.Colors.GetAsync();

// List crystal planets - Planetary ruler filter API
await roxy.Crystals.Planets.GetAsync();

// List all crystals - Crystal healing database API
await roxy.Crystals.GetAsync(c => { c.QueryParameters.Color = "pink"; c.QueryParameters.Planet = "Venus"; c.QueryParameters.Limit = 20; c.QueryParameters.Offset = 0; });

// Get crystal by id - Crystal healing properties API
await roxy.Crystals["amethyst"].GetAsync();
```

---

## [Dreams](https://roxyapi.com/api-reference/dreams) - `roxy.Dreams`

Dream interpretation API with a 2,200+ symbol dream dictionary and psychological meanings covering animals, objects,...

```csharp
// List and search dream symbols - Dream dictionary API
await roxy.Dreams.Symbols.GetAsync(c => { c.QueryParameters.Q = "water"; c.QueryParameters.Letter = "a"; c.QueryParameters.Limit = 20; c.QueryParameters.Offset = 0; });

// Random dream symbols - Dream symbol discovery API
await roxy.Dreams.Symbols.Random.GetAsync(c => c.QueryParameters.Count = 1);

// Symbol counts by letter - Dream dictionary index API
await roxy.Dreams.Symbols.Letters.GetAsync();

// Get dream symbol by id - Dream interpretation API
await roxy.Dreams.Symbols["snake"].GetAsync();

// Daily dream symbol - Dream symbol of the day API
await roxy.Dreams.Daily.PostAsync(new() { Seed = "user123", Date = new Date(2026, 3, 6) });
```

---

## [Angel Numbers](https://roxyapi.com/api-reference/angel-numbers) - `roxy.AngelNumbers`

Angel numbers API with meanings for 111, 222, 333, 444, 555, 666, 777, 888, 999, 1111, and 75+ sequences covering eve...

```csharp
// List all angel numbers - Angel number catalog API
await roxy.AngelNumbers.Numbers.GetAsync(c => { c.QueryParameters.Limit = 20; c.QueryParameters.Offset = 0; });

// Get angel number meaning - Angel number lookup API
await roxy.AngelNumbers.Numbers["444"].GetAsync();

// Analyze any number sequence - Angel number analysis API
await roxy.AngelNumbers.Lookup.GetAsync(c => c.QueryParameters.Number = "1234");

// Daily angel number - Angel number of the day API
await roxy.AngelNumbers.Daily.PostAsync(new() { Seed = "user123", Date = new Date(2026, 3, 6) });
```

---

## [Location and Timezone](https://roxyapi.com/api-reference/location-and-timezone) - `roxy.Location`

Timezone and location API with city search and geocoding across 5,180,000+ cities, towns and villages in 240+ countri...

```csharp
// Search cities worldwide - Geocoding autocomplete with coordinates and timezone
await roxy.Location.Search.GetAsync(c => { c.QueryParameters.Q = "berlin"; c.QueryParameters.Limit = 10; c.QueryParameters.Offset = 0; });

// List all countries - ISO codes and city coverage
await roxy.Location.Countries.GetAsync(c => { c.QueryParameters.Limit = 50; c.QueryParameters.Offset = 0; });

// Get cities in a country - Geocoding directory sorted by population
await roxy.Location.Countries["DE"].GetAsync(c => { c.QueryParameters.Limit = 20; c.QueryParameters.Offset = 0; });
```

---

## [Usage](https://roxyapi.com/api-reference/usage) - `roxy.Usage`

Monitor your API usage, check rate limits, and track request consumption

```csharp
// Get API usage statistics
await roxy.Usage.GetAsync();
```

---

## [Reports](https://roxyapi.com/api-reference/reports) - `roxy.Reports`

Branded reports built from the API: a natal chart and more as a print-ready PDF, self-contained HTML or Markdown, whi...

```csharp
// Natal chart report - Branded PDF report API
await roxy.Reports.Natal.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" }, Branding = new() { Name = "Luna Rivera Astrology", Logo = "https://example.com/logo.png", Footer = "For reflection and entertainment. Book a reading at example.com.", Website = "https://example.com", Email = "hello@example.com" }, Readings = true });

// Synastry report - Branded PDF report API
await roxy.Reports.Synastry.PostAsync(new() { Person1 = new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" }, Name = "Alex" }, Person2 = new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" }, Name = "Alex" }, Branding = new() { Name = "Luna Rivera Astrology", Logo = "https://example.com/logo.png", Footer = "For reflection and entertainment. Book a reading at example.com.", Website = "https://example.com", Email = "hello@example.com" }, Readings = true });

// Kundli report - Branded PDF report API
await roxy.Reports.Kundli.PostAsync(new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 }, AyanamsaValue = 24, Branding = new() { Name = "Luna Rivera Astrology", Logo = "https://example.com/logo.png", Footer = "For reflection and entertainment. Book a reading at example.com.", Website = "https://example.com", Email = "hello@example.com" }, Readings = true });

// Kundli matching report - Branded PDF report API
await roxy.Reports.Matchmaking.PostAsync(new() { Person1 = new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 } }, Person2 = new() { Date = new Date(1990, 7, 4), Time = new Time(10, 12, 0), Latitude = 28.6139, Longitude = 77.209, Timezone = new() { Double = 5.5 } }, AyanamsaValue = 24, Branding = new() { Name = "Luna Rivera Astrology", Logo = "https://example.com/logo.png", Footer = "For reflection and entertainment. Book a reading at example.com.", Website = "https://example.com", Email = "hello@example.com" }, Readings = true });

// Yearly forecast report - Branded PDF report API
await roxy.Reports.YearlyForecast.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(14, 30, 0), Year = 2026, Latitude = 40.7128, Longitude = -74.006, Timezone = new() { String = "America/New_York" }, Branding = new() { Name = "Luna Rivera Astrology", Logo = "https://example.com/logo.png", Footer = "For reflection and entertainment. Book a reading at example.com.", Website = "https://example.com", Email = "hello@example.com" }, Readings = true });

// Human Design report - Branded PDF report API
await roxy.Reports.HumanDesign.PostAsync(new() { Date = new Date(1990, 7, 15), Time = new Time(13, 0, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 0, Branding = new() { Name = "Luna Rivera Astrology", Logo = "https://example.com/logo.png", Footer = "For reflection and entertainment. Book a reading at example.com.", Website = "https://example.com", Email = "hello@example.com" }, Readings = true });

// BaZi report - Branded PDF report API
await roxy.Reports.Bazi.PostAsync(new() { Date = new Date(1990, 6, 15), Time = new Time(14, 30, 0), Timezone = new() { String = "America/New_York" }, Latitude = 0, Longitude = 116.4, Year = 2027, Branding = new() { Name = "Luna Rivera Astrology", Logo = "https://example.com/logo.png", Footer = "For reflection and entertainment. Book a reading at example.com.", Website = "https://example.com", Email = "hello@example.com" }, Readings = true });

// Numerology report - Branded PDF report API
await roxy.Reports.Numerology.PostAsync(new() { FullName = "John William Smith", Year = 1990, Month = 7, Day = 15, CurrentYear = 2025, TargetDate = new Date(2026, 10, 28), Branding = new() { Name = "Luna Rivera Astrology", Logo = "https://example.com/logo.png", Footer = "For reflection and entertainment. Book a reading at example.com.", Website = "https://example.com", Email = "hello@example.com" }, Readings = true });

// Tarot reading report - Branded PDF report API
await roxy.Reports.Tarot.PostAsync(new() { Question = "What should I know about this situation?", Seed = "reading-2f9c1a", Branding = new() { Name = "Luna Rivera Astrology", Logo = "https://example.com/logo.png", Footer = "For reflection and entertainment. Book a reading at example.com.", Website = "https://example.com", Email = "hello@example.com" }, Readings = true });
```

---

## [Languages](https://roxyapi.com/api-reference/languages) - `roxy.Languages`

List the response languages accepted by the `lang` query parameter on every i18n-aware endpoint

```csharp
// Get field labels for a language
await roxy.Languages.FieldLabels.GetAsync();

// List supported response languages
await roxy.Languages.GetAsync();
```
<!-- END:METHODS -->

---

## Error handling

Calls throw `RoxyApi.Models.RoxyError` (a subclass of `Microsoft.Kiota.Abstractions.ApiException`) on every error status the endpoint declares. A status the endpoint does not declare, such as a 5xx from the edge, throws the base `ApiException` with `ResponseStatusCode` set. A request that still fails after the last retry throws the error of the final response.

```csharp
try
{
    var chart = await roxy.Astrology.NatalChart.PostAsync(new() { /* ... */ });
}
catch (RoxyApi.Models.RoxyError e)
{
    // e.Code is stable (switch on it); e.Message may change wording.
    // e.ResponseStatusCode is the HTTP status. On a 400, e.Issues lists each invalid field.
    Console.WriteLine($"{e.ResponseStatusCode} {e.Code}: {e.Message}");
}
```

Codes: validation_error (400, with e.Issues), api_key_required / invalid_api_key / subscription_not_found / subscription_inactive / api_key_revoked (401), not_found (404), bad_request and other status-derived codes for a client error the endpoint itself detected, such as a date window whose endDate precedes startDate (4xx), rate_limit_exceeded (429), internal_error (500).

Retries are on by default: `new RoxyClient(apiKey)` resends a request up to twice after a 429, 500, 502, 503 or 504, or a connection that was never made, waiting for `Retry-After` when present (up to `MaxDelay`, default 30 seconds) and a jittered backoff otherwise. `new RoxyClient(apiKey, new RoxyRetryOptions { MaxRetries = 0 })` turns retries off. A read timeout is never retried. On a persistent failure the total is 1 + `MaxRetries` requests, so 3 by default and exactly 1 with `MaxRetries = 0`.

## Advanced

`new RoxyClient(apiKey)` is the common path. For a custom `HttpClient`, proxy, or middleware, build the client from a Kiota request adapter:

```csharp
using Microsoft.Kiota.Http.HttpClientLibrary;

var adapter = new HttpClientRequestAdapter(authProvider, httpClient: yourHttpClient);
var roxy = new RoxyClient(adapter);
```

## Links

- Documentation: https://roxyapi.com/docs
- Interactive API docs: https://roxyapi.com/api-reference
- Pricing and API keys: https://roxyapi.com/pricing
- MCP for AI agents: https://roxyapi.com/docs/mcp
- Templates: https://roxyapi.com/templates
- Source and issues: https://github.com/RoxyAPI/sdk-dotnet
- Other SDKs: TypeScript https://www.npmjs.com/package/@roxyapi/sdk, Python https://pypi.org/project/roxy-sdk/, PHP https://packagist.org/packages/roxyapi/sdk, Go https://pkg.go.dev/github.com/RoxyAPI/sdk-go, Rust https://crates.io/crates/roxyapi