Complete request and response catalog

curl examples for all 78 calculations

Every command uses synthetic data, the production HTTPS origin, and your server-side COSMICEPHEMERIS_KEY. Every response example is generated by the local engine and checked against the published OpenAPI schema.

Create a free account Download OpenAPI Documentation home

Run these commands only from a trusted terminal or backend. Never put an API key in browser code, a mobile bundle, a shared shell history, or a public repository. Admitted requests consume the route’s normal unit; do not configure automatic retries.

Find an operation

Search the live catalog

Filter by route name, summary, or family. Each operation has a permanent link you can share.

Showing all 78 calculations.

  1. numerologyCalculate explicit Pythagorean numerology arithmetic (beta)
  2. place-searchSearch a pinned self-hosted place catalog (beta)
  3. timezone-resolveResolve a selected place and historical local civil time (beta)
  4. natal-contextBuild deterministic model-ready natal context (beta)
  5. birth-chartCalculate a full birth chart
  6. aspectsCalculate natal aspects inside a full chart envelope
  7. housesCalculate a selected house system
  8. synastryCalculate two charts and cross-chart aspects
  9. transitsCalculate transits at one requested instant
  10. horoscopeCalculate beta structured horoscope signals
  11. nakshatra-timelineCalculate Pro sidereal nakshatra/pada residences
  12. natal-svgRender a natal SVG wheel (beta)
  13. vargasCalculate twenty-four supported sidereal Vargas through D150 (beta)
  14. vimshottariCalculate a natal Vimshottari cycle (beta)
  15. ashtakootaCalculate bounded North-Indian Ashtakoota scores (beta)
  16. ashtakavargaCalculate Bhinnashtakavarga and Sarvashtakavarga tables with optional reductions (beta)
  17. compositeCalculate a shortest-arc midpoint composite (beta)
  18. panchangCalculate an instant Panchang and local solar events (beta)
  19. secondary-progressionsCalculate secondary-progressed planets with natal context (beta)
  20. varga-svgRender an original North/South Indian varga SVG (beta)
  21. lunar-nodesCalculate distinct mean and osculating lunar nodes (beta)
  22. returnsFind the next solar or lunar return and its chart (beta)
  23. solar-arcsCalculate named symbolic solar-arc directions (beta)
  24. moon-phasesCalculate Moon phase geometry or a bounded primary-phase calendar (beta)
  25. planetary-eventsSearch a bounded interval for planetary ingresses, stations and exact major aspects (beta)
  26. house-ingressesSearch transit crossings of fixed reference-chart house cusps (beta)
  27. aspect-windowsFind exact-hit-anchored major-aspect orb windows (beta)
  28. event-calendarCompose a bounded astrology event calendar (beta)
  29. event-rule-searchEvaluate a bounded versioned Boolean event rule
  30. convention-compareCompare calculation conventions or trusted signed releases
  31. chart-robustnessSeparate birth-time and convention sensitivity
  32. civil-time-auditAudit ambiguous or invalid local birth times without guessing
  33. chart-input-readinessGate chart workflows against birth-time data quality
  34. house-system-readinessPreflight every supported house system without fallback
  35. house-placement-stabilityMeasure planetary house-placement stability across supported systems
  36. aspect-policy-stabilityCompare several explicit aspect-orb policies on one chart
  37. house-boundary-proximityAudit planet clearance from house cusps across every 12-house system
  38. location-precision-auditAudit chart sensitivity to birth-coordinate precision
  39. location-transition-scanScan outward for observed location-sensitive chart transitions
  40. chart-uncertainty-envelopeSeparate observed chart sensitivity across time and location uncertainty
  41. electional-robustness-auditStress-test electional criteria across start-time and venue uncertainty
  42. electional-tolerance-frontierMeasure observed electional rule tolerance in time and venue directions
  43. electional-feasibility-auditExplain sampled electional feasibility and minimal observed rule relaxations
  44. electional-resolution-auditShow which observed electional match runs coarser sampling misses
  45. electional-sampling-phase-auditShow whether electional results change with the sampling anchor
  46. electional-criterion-omission-auditMeasure which selected electional criteria uniquely exclude observed samples
  47. electional-criterion-pair-auditExpose observed two-criterion electional exclusion interactions
  48. electional-criterion-relation-auditExpose observed compatibility and redundancy among electional criteria
  49. electional-criterion-budget-auditFind every optimal electional rule-relaxation combination by exact omission budget
  50. electional-criterion-budget-stability-auditAudit whether optimal electional rule relaxations survive sampling-grid changes
  51. electional-criterion-budget-regret-auditFind least sampling-sensitive electional rule relaxations by exact minimax regret
  52. electional-criterion-budget-pareto-auditEnumerate weight-free Pareto-efficient electional rule relaxations
  53. electional-criterion-shapley-auditAttribute excluded electional samples fairly across interacting criteria
  54. electional-criterion-conflict-core-auditFind the smallest electional rule combinations that make a window infeasible
  55. electional-criterion-robust-repair-auditFind the smallest criterion relaxations that work across every sampling grid
  56. electional-criterion-repair-impact-auditAudit what every minimal cross-grid criterion repair actually admits
  57. electional-criterion-repair-distinction-auditProve how every pair of minimal cross-grid criterion repairs differs
  58. electional-criterion-repair-overlap-auditClassify exact overlap and containment for every minimal repair pair
  59. electional-criterion-repair-hierarchy-auditBuild the exact containment hierarchy of minimal repair consequences
  60. electional-criterion-repair-coverage-auditAudit exact observation support and single-repair coverage loss
  61. electional-criterion-repair-resilience-auditAudit exact multi-repair failure tolerance
  62. electional-criterion-repair-loss-frontier-auditAudit exact worst-case repair-loss damage
  63. electional-criterion-repair-hardening-auditAudit exact single-repair hardening effects
  64. electional-criterion-repair-hardening-pareto-auditCompare exact repair-hardening Pareto tradeoffs
  65. electional-criterion-repair-hardening-pareto-hierarchy-auditMap the exact hierarchy of repair-hardening Pareto profiles
  66. electional-criterion-repair-hardening-regret-auditFind every least-worst-regret repair-hardening profile
  67. synastry-svgRender a deterministic synastry double wheel (beta)
  68. transit-svgRender a deterministic natal/transit double wheel (beta)
  69. natal-reportBuild a calculation-fact natal report with HTML, PDF, DOCX, XLSX, ODS, EPUB, ODT, RTF, JSON, CSV, XML, NDJSON, TSV, Markdown, text, or ZIP delivery (beta)
  70. birth-time-sensitivityHandle unknown/approximate birth time or sample an explicit interval (beta)
  71. fixed-starsCalculate six independently validated fixed stars (beta)
  72. relocation-chartRecalculate chart angles and houses for a new location (beta)
  73. astrocartographyCalculate astrocartography geometry and optional downloadable maps (beta)
  74. eclipse-geometrySearch bounded global solar and lunar eclipse geometry (beta)
  75. electional-searchFilter bounded hourly electional samples (beta)
  76. natal-analysisCalculate natal geometry with optional graha drishti or partial Shadbala foundation (beta)
  77. planetary-hoursCalculate classical unequal planetary hours for one local date (beta)
  78. davisonCalculate an uncorrected TT/arithmetic Davison relationship chart (beta)

Calculations · Beta calculations

Calculate explicit Pythagorean numerology arithmetic (beta)

#

POST /api/astro/numerology

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/numerology" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth_date": "2000-01-01",
  "name": "Ada Lovelace",
  "year": 2026
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Resolve a selected place and historical local civil time (beta)

#

POST /api/astro/timezone-resolve

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/timezone-resolve" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "place_id": "geonames:5128581:2026-10-02",
  "date": "1945-08-14",
  "time": "19:00"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Build deterministic model-ready natal context (beta)

#

POST /api/astro/natal-context

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/natal-context" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 0,
    "lon": 0
  },
  "formats": [
    "json",
    "xml",
    "markdown"
  ]
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations

Calculate a full birth chart

#

POST /api/astro/birth-chart

  • current
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/birth-chart" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "date": "1990-01-01",
  "time": "12:00",
  "timezone": "America/New_York",
  "lat": 40.7128,
  "lon": -74.006
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations

Calculate natal aspects inside a full chart envelope

#

POST /api/astro/aspects

  • current
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/aspects" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "1990-01-01",
    "time": "12:00",
    "timezone": "America/New_York",
    "lat": 40.7128,
    "lon": -74.006
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations

Calculate a selected house system

#

POST /api/astro/houses

  • current
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/houses" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "1990-01-01",
    "time": "12:00",
    "timezone": "America/New_York",
    "lat": 40.7128,
    "lon": -74.006
  },
  "system": "whole_sign"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations

Calculate two charts and cross-chart aspects

#

POST /api/astro/synastry

  • current
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/synastry" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "personA": {
    "date": "1990-01-01",
    "time": "12:00",
    "timezone": "America/New_York",
    "lat": 40.7128,
    "lon": -74.006
  },
  "personB": {
    "date": "1992-06-15",
    "time": "09:30",
    "timezone": "Europe/London",
    "lat": 51.5074,
    "lon": -0.1278
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations

Calculate transits at one requested instant

#

POST /api/astro/transits

  • current
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/transits" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "1990-01-01",
    "time": "12:00",
    "timezone": "America/New_York",
    "lat": 40.7128,
    "lon": -74.006
  },
  "transitDate": "2026-01-01",
  "transitTime": "12:00",
  "timezone": "UTC"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Beta interpretation

Calculate beta structured horoscope signals

#

POST /api/astro/horoscope

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/horoscope" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "1990-01-01",
    "time": "12:00",
    "timezone": "America/New_York",
    "lat": 40.7128,
    "lon": -74.006
  },
  "transitDate": "2026-01-01",
  "transitTime": "12:00",
  "timezone": "UTC"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Pro timeline

Calculate Pro sidereal nakshatra/pada residences

#

POST /api/astro/nakshatra-timeline

  • current
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/nakshatra-timeline" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "planet": "saturn",
  "start_utc": "2026-01-01T00:00:00Z",
  "end_utc": "2026-01-03T00:00:00Z",
  "ayanamsa": "lahiri"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Render a natal SVG wheel (beta)

#

POST /api/astro/natal-svg

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/natal-svg" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 0,
    "lon": 0
  },
  "house_system": "placidus",
  "theme": "dark",
  "show_aspects": true,
  "additional_points": [
    "vertex",
    "lot_of_fortune",
    "lot_of_spirit"
  ],
  "aspect_profile": "extended",
  "zodiac": "sidereal",
  "ayanamsa": "lahiri"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Calculate twenty-four supported sidereal Vargas through D150 (beta)

#

POST /api/astro/vargas

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/vargas" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 0,
    "lon": 0
  },
  "division": 9,
  "ayanamsa": "lahiri"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Calculate a natal Vimshottari cycle (beta)

#

POST /api/astro/vimshottari

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/vimshottari" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 0,
    "lon": 0
  },
  "ayanamsa": "lahiri"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Calculate bounded North-Indian Ashtakoota scores (beta)

#

POST /api/astro/ashtakoota

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/ashtakoota" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "groom": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 0,
    "lon": 0
  },
  "bride": {
    "date": "1992-06-15",
    "time": "09:30",
    "timezone": "Asia/Kolkata",
    "lat": 28.6139,
    "lon": 77.209
  },
  "ayanamsa": "lahiri"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Calculate Bhinnashtakavarga and Sarvashtakavarga tables with optional reductions (beta)

#

POST /api/astro/ashtakavarga

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/ashtakavarga" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 0,
    "lon": 0
  },
  "ayanamsa": "lahiri"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Calculate a shortest-arc midpoint composite (beta)

#

POST /api/astro/composite

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/composite" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "personA": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 0,
    "lon": 0
  },
  "personB": {
    "date": "1990-06-15",
    "time": "08:30",
    "timezone": "Asia/Kolkata",
    "lat": 28.6139,
    "lon": 77.209
  },
  "zodiac": "tropical",
  "house_system": "equal"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Calculate an instant Panchang and local solar events (beta)

#

POST /api/astro/panchang

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/panchang" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "at": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "Asia/Kolkata",
    "lat": 28.6139,
    "lon": 77.209
  },
  "ayanamsa": "lahiri"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Calculate secondary-progressed planets with natal context (beta)

#

POST /api/astro/secondary-progressions

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/secondary-progressions" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 0,
    "lon": 0
  },
  "target": {
    "date": "2026-09-14",
    "time": "12:00",
    "timezone": "UTC"
  },
  "zodiac": "tropical",
  "house_system": "equal"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Render an original North/South Indian varga SVG (beta)

#

POST /api/astro/varga-svg

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/varga-svg" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 0,
    "lon": 0
  },
  "division": 1,
  "layout": "north_indian",
  "theme": "dark",
  "ayanamsa": "lahiri"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Calculate distinct mean and osculating lunar nodes (beta)

#

POST /api/astro/lunar-nodes

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/lunar-nodes" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "at": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC"
  },
  "zodiac": "sidereal",
  "ayanamsa": "lahiri"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Find the next solar or lunar return and its chart (beta)

#

POST /api/astro/returns

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/returns" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 0,
    "lon": 0
  },
  "body": "sun",
  "after": {
    "date": "2026-09-14",
    "time": "12:00",
    "timezone": "UTC"
  },
  "zodiac": "tropical",
  "house_system": "equal"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Calculate named symbolic solar-arc directions (beta)

#

POST /api/astro/solar-arcs

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/solar-arcs" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 0,
    "lon": 0
  },
  "target": {
    "date": "2026-09-15",
    "time": "12:00",
    "timezone": "UTC"
  },
  "zodiac": "tropical",
  "house_system": "equal",
  "method": "mean_naibod"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Calculate Moon phase geometry or a bounded primary-phase calendar (beta)

#

POST /api/astro/moon-phases

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/moon-phases" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "mode": "instant",
  "at": {
    "date": "2026-01-18",
    "time": "19:52",
    "timezone": "UTC"
  },
  "display_timezone": "America/New_York"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Search a bounded interval for planetary ingresses, stations and exact major aspects (beta)

#

POST /api/astro/planetary-events

  • beta
  • 30,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/planetary-events" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-01-01T00:00:00Z",
  "end_utc": "2026-02-01T00:00:00Z",
  "event_types": [
    "sign_ingress",
    "station",
    "aspect"
  ],
  "bodies": [
    "sun",
    "moon",
    "mercury",
    "venus",
    "mars"
  ]
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Search transit crossings of fixed reference-chart house cusps (beta)

#

POST /api/astro/house-ingresses

  • beta
  • 30,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/house-ingresses" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "reference_birth": {
    "date": "1990-01-01",
    "time": "12:00:00",
    "timezone": "UTC",
    "lat": 40.7128,
    "lon": -74.006
  },
  "start_utc": "2026-01-01T00:00:00Z",
  "end_utc": "2026-01-08T00:00:00Z",
  "bodies": [
    "moon",
    "mercury"
  ]
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Find exact-hit-anchored major-aspect orb windows (beta)

#

POST /api/astro/aspect-windows

  • beta
  • 30,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/aspect-windows" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2025-03-01T00:00:00Z",
  "end_utc": "2025-04-01T00:00:00Z",
  "bodies": [
    "mercury",
    "neptune"
  ],
  "aspects": [
    "conjunction"
  ],
  "orb_degrees": 3,
  "include_ical": false
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Compose a bounded astrology event calendar (beta)

#

POST /api/astro/event-calendar

  • beta
  • 30,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/event-calendar" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-09-01T00:00:00Z",
  "end_utc": "2026-09-08T00:00:00Z",
  "event_types": [
    "moon_phase",
    "aspect"
  ],
  "bodies": [
    "sun",
    "moon"
  ],
  "display_timezone": "UTC",
  "include_csv": true,
  "group_passes": true
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Compare calculation conventions or trusted signed releases

#

POST /api/astro/convention-compare

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/convention-compare" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 0,
    "lon": 0
  },
  "profiles": [
    {
      "zodiac": "tropical",
      "house_system": "equal"
    },
    {
      "zodiac": "sidereal",
      "ayanamsa": "lahiri",
      "house_system": "whole_sign"
    }
  ]
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Separate birth-time and convention sensitivity

#

POST /api/astro/chart-robustness

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/chart-robustness" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth_time": {
    "status": "approximate",
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "America/New_York",
    "uncertainty_minutes": 30
  },
  "lat": 40.7128,
  "lon": -74.006,
  "profiles": [
    {
      "zodiac": "tropical",
      "house_system": "equal"
    },
    {
      "zodiac": "sidereal",
      "ayanamsa": "lahiri",
      "house_system": "whole_sign"
    }
  ]
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Audit ambiguous or invalid local birth times without guessing

#

POST /api/astro/civil-time-audit

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/civil-time-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "place_id": "geonames:5128581:2026-10-02",
  "date": "2024-11-03",
  "time": "01:30",
  "profile": {
    "zodiac": "tropical",
    "house_system": "equal"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Gate chart workflows against birth-time data quality

#

POST /api/astro/chart-input-readiness

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/chart-input-readiness" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "place_id": "geonames:5128581:2026-10-02",
  "birth_time": {
    "status": "exact",
    "date": "2024-11-03",
    "time": "01:30"
  },
  "profile": {
    "zodiac": "tropical",
    "house_system": "equal"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Preflight every supported house system without fallback

#

POST /api/astro/house-system-readiness

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/house-system-readiness" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 70,
    "lon": 20
  },
  "profile": {
    "zodiac": "tropical"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Measure planetary house-placement stability across supported systems

#

POST /api/astro/house-placement-stability

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/house-placement-stability" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 70,
    "lon": 20
  },
  "profile": {
    "zodiac": "tropical"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Compare several explicit aspect-orb policies on one chart

#

POST /api/astro/aspect-policy-stability

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/aspect-policy-stability" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "points": [
    "sun",
    "moon",
    "mercury",
    "venus",
    "mars"
  ],
  "policies": [
    {
      "id": "tight",
      "aspects": [
        {
          "aspect": "conjunction",
          "max_orb_degrees": 3
        },
        {
          "aspect": "square",
          "max_orb_degrees": 3
        },
        {
          "aspect": "trine",
          "max_orb_degrees": 3
        },
        {
          "aspect": "opposition",
          "max_orb_degrees": 3
        }
      ]
    },
    {
      "id": "wide",
      "aspects": [
        {
          "aspect": "conjunction",
          "max_orb_degrees": 8
        },
        {
          "aspect": "square",
          "max_orb_degrees": 6
        },
        {
          "aspect": "trine",
          "max_orb_degrees": 7
        },
        {
          "aspect": "opposition",
          "max_orb_degrees": 8
        }
      ]
    }
  ]
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Audit planet clearance from house cusps across every 12-house system

#

POST /api/astro/house-boundary-proximity

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/house-boundary-proximity" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "points": [
    "sun",
    "moon",
    "mercury"
  ],
  "threshold_degrees": 2
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Audit chart sensitivity to birth-coordinate precision

#

POST /api/astro/location-precision-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/location-precision-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical",
    "house_system": "placidus"
  },
  "radius_km": 25,
  "points": [
    "sun",
    "moon",
    "mercury"
  ]
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Scan outward for observed location-sensitive chart transitions

#

POST /api/astro/location-transition-scan

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/location-transition-scan" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical",
    "house_system": "placidus"
  },
  "max_radius_km": 100,
  "points": [
    "sun",
    "moon",
    "mercury"
  ]
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Separate observed chart sensitivity across time and location uncertainty

#

POST /api/astro/chart-uncertainty-envelope

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/chart-uncertainty-envelope" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical",
    "house_system": "placidus"
  },
  "time_uncertainty_minutes": 30,
  "location_radius_km": 25,
  "points": [
    "sun",
    "moon",
    "mercury"
  ]
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Stress-test electional criteria across start-time and venue uncertainty

#

POST /api/astro/electional-robustness-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-robustness-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "event": {
    "date": "2026-10-04",
    "time": "12:00",
    "timezone": "America/New_York",
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  },
  "time_tolerance_minutes": 30,
  "location_radius_km": 25
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Measure observed electional rule tolerance in time and venue directions

#

POST /api/astro/electional-tolerance-frontier

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-tolerance-frontier" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "event": {
    "date": "2026-10-04",
    "time": "12:00",
    "timezone": "America/New_York",
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  },
  "max_time_shift_minutes": 60,
  "max_location_radius_km": 50
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Explain sampled electional feasibility and minimal observed rule relaxations

#

POST /api/astro/electional-feasibility-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-feasibility-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  },
  "sample_minutes": 15
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Show which observed electional match runs coarser sampling misses

#

POST /api/astro/electional-resolution-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-resolution-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Show whether electional results change with the sampling anchor

#

POST /api/astro/electional-sampling-phase-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-sampling-phase-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Measure which selected electional criteria uniquely exclude observed samples

#

POST /api/astro/electional-criterion-omission-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-omission-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  },
  "sample_minutes": 15
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Expose observed two-criterion electional exclusion interactions

#

POST /api/astro/electional-criterion-pair-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-pair-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  },
  "sample_minutes": 15
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Expose observed compatibility and redundancy among electional criteria

#

POST /api/astro/electional-criterion-relation-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-relation-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  },
  "sample_minutes": 15
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Find every optimal electional rule-relaxation combination by exact omission budget

#

POST /api/astro/electional-criterion-budget-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-budget-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  },
  "sample_minutes": 15
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Audit whether optimal electional rule relaxations survive sampling-grid changes

#

POST /api/astro/electional-criterion-budget-stability-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-budget-stability-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Find least sampling-sensitive electional rule relaxations by exact minimax regret

#

POST /api/astro/electional-criterion-budget-regret-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-budget-regret-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Enumerate weight-free Pareto-efficient electional rule relaxations

#

POST /api/astro/electional-criterion-budget-pareto-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-budget-pareto-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Attribute excluded electional samples fairly across interacting criteria

#

POST /api/astro/electional-criterion-shapley-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-shapley-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Find the smallest electional rule combinations that make a window infeasible

#

POST /api/astro/electional-criterion-conflict-core-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-conflict-core-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Find the smallest criterion relaxations that work across every sampling grid

#

POST /api/astro/electional-criterion-robust-repair-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-robust-repair-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Audit what every minimal cross-grid criterion repair actually admits

#

POST /api/astro/electional-criterion-repair-impact-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-repair-impact-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Prove how every pair of minimal cross-grid criterion repairs differs

#

POST /api/astro/electional-criterion-repair-distinction-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-repair-distinction-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Classify exact overlap and containment for every minimal repair pair

#

POST /api/astro/electional-criterion-repair-overlap-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-repair-overlap-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Build the exact containment hierarchy of minimal repair consequences

#

POST /api/astro/electional-criterion-repair-hierarchy-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-repair-hierarchy-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Audit exact observation support and single-repair coverage loss

#

POST /api/astro/electional-criterion-repair-coverage-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-repair-coverage-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Audit exact multi-repair failure tolerance

#

POST /api/astro/electional-criterion-repair-resilience-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-repair-resilience-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Audit exact worst-case repair-loss damage

#

POST /api/astro/electional-criterion-repair-loss-frontier-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-repair-loss-frontier-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Audit exact single-repair hardening effects

#

POST /api/astro/electional-criterion-repair-hardening-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-repair-hardening-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Compare exact repair-hardening Pareto tradeoffs

#

POST /api/astro/electional-criterion-repair-hardening-pareto-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-repair-hardening-pareto-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Map the exact hierarchy of repair-hardening Pareto profiles

#

POST /api/astro/electional-criterion-repair-hardening-pareto-hierarchy-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-repair-hardening-pareto-hierarchy-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Find every least-worst-regret repair-hardening profile

#

POST /api/astro/electional-criterion-repair-hardening-regret-audit

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/electional-criterion-repair-hardening-regret-audit" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2026-10-04T00:00:00Z",
  "end_utc": "2026-10-05T00:00:00Z",
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "profile": {
    "zodiac": "tropical"
  },
  "filters": {
    "moon_signs": [
      "Aquarius",
      "Pisces"
    ],
    "mercury_motion": "direct"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Render a deterministic synastry double wheel (beta)

#

POST /api/astro/synastry-svg

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/synastry-svg" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "personA": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 0,
    "lon": 0
  },
  "personB": {
    "date": "1990-06-15",
    "time": "08:30",
    "timezone": "UTC",
    "lat": 10,
    "lon": 20
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Render a deterministic natal/transit double wheel (beta)

#

POST /api/astro/transit-svg

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/transit-svg" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 0,
    "lon": 0
  },
  "transitDate": "2026-09-23",
  "transitTime": "12:00",
  "timezone": "UTC"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Build a calculation-fact natal report with HTML, PDF, DOCX, XLSX, ODS, EPUB, ODT, RTF, JSON, CSV, XML, NDJSON, TSV, Markdown, text, or ZIP delivery (beta)

#

POST /api/astro/natal-report

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/natal-report" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 0,
    "lon": 0
  },
  "include_svg": true,
  "include_download": true,
  "download_format": "html",
  "report_branding": {
    "display_name": "North Star Studio",
    "accent": "blue"
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Handle unknown/approximate birth time or sample an explicit interval (beta)

#

POST /api/astro/birth-time-sensitivity

  • beta
  • 60,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/birth-time-sensitivity" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth_time": {
    "status": "unknown",
    "date": "2000-01-01",
    "timezone": "UTC"
  },
  "lat": 0,
  "lon": 0
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Calculate six independently validated fixed stars (beta)

#

POST /api/astro/fixed-stars

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/fixed-stars" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "at": {
    "date": "2026-09-23",
    "time": "12:00",
    "timezone": "UTC"
  },
  "stars": [
    "aldebaran",
    "antares",
    "fomalhaut",
    "regulus"
  ]
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Recalculate chart angles and houses for a new location (beta)

#

POST /api/astro/relocation-chart

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/relocation-chart" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "2000-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 0,
    "lon": 0
  },
  "location": {
    "lat": 51.5074,
    "lon": -0.1278
  },
  "house_system": "placidus"
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Calculate astrocartography geometry and optional downloadable maps (beta)

#

POST /api/astro/astrocartography

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/astrocartography" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "at": {
    "date": "2026-09-23",
    "time": "12:00",
    "timezone": "UTC"
  },
  "bodies": [
    "sun",
    "moon"
  ],
  "include_svg": true,
  "include_png": true,
  "theme": "dark",
  "include_geojson": true,
  "include_geojson_seq": true,
  "include_ndjson": true,
  "include_topojson": true,
  "include_kml": true,
  "include_gpx": true,
  "include_csv": true,
  "include_wkt": true,
  "include_wkb": true,
  "include_gml": true
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Search bounded global solar and lunar eclipse geometry (beta)

#

POST /api/astro/eclipse-geometry

  • beta
  • 30,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/eclipse-geometry" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "start_utc": "2024-01-01T00:00:00Z",
  "end_utc": "2025-01-01T00:00:00Z",
  "eclipse_types": [
    "solar",
    "lunar"
  ],
  "observer": {
    "lat": 25.286666667,
    "lon": -104.138333333
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Calculate natal geometry with optional graha drishti or partial Shadbala foundation (beta)

#

POST /api/astro/natal-analysis

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/natal-analysis" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "birth": {
    "date": "1990-01-01",
    "time": "12:00",
    "timezone": "UTC",
    "lat": 40.7128,
    "lon": -74.006
  },
  "points": [
    "sun",
    "moon",
    "mercury"
  ],
  "zodiac": "sidereal",
  "ayanamsa": "lahiri",
  "include_graha_drishti": true
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Calculate classical unequal planetary hours for one local date (beta)

#

POST /api/astro/planetary-hours

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/planetary-hours" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "date": "2026-09-23",
  "timezone": "America/New_York",
  "lat": 40.7128,
  "lon": -74.006
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.

Calculations · Beta calculations

Calculate an uncorrected TT/arithmetic Davison relationship chart (beta)

#

POST /api/astro/davison

  • beta
  • 15,000 ms engine timeout
  • One admitted calculation unit

Copy-paste curl

curl --fail-with-body --silent --show-error \
  --request POST "https://api.cosmicephemeris.com/api/astro/davison" \
  --header "Authorization: Bearer $COSMICEPHEMERIS_KEY" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "personA": {
    "date": "2000-01-01",
    "time": "12:00",
    "lat": 40,
    "lon": -74
  },
  "personB": {
    "date": "2000-01-03",
    "time": "12:00",
    "lat": 50,
    "lon": 2
  }
}
JSON
View schema-validated 200 response example

Generated from the canonical synthetic request by the local calculation engine. Large arrays and artifacts are shown in full.

Open to load the response example.