---
title: "Calculate Ephemeris"
method: POST
path: "/api/v1/ephemeris/calculate"
tags: ["Ephemeris", "ephemeris"]
---

# Calculate Ephemeris

`POST /api/v1/ephemeris/calculate`

## Request

- Base URL: `https://api.freeastroapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.freeastroapi.com/api/v1/ephemeris/calculate`
- Auth: none declared

## Request body

- EphemerisRequest
  - `start` string, required
  - `end` string, nullable
  - `step` string
  - `city` string, nullable
  - `zodiac_type` 'tropical' | 'sidereal'
  - `sidereal_ayanamsa` string, nullable
  - `house_system` string
  - `bodies` string[], nullable
  - `include_angles` boolean
  - `include_houses` boolean
  - `include_speed` boolean
  - `include_retrograde` boolean
  - `include_dignity` boolean
  - `include_sign_degree` boolean
  - `include_aspects` boolean
  - `include_minor_aspects` boolean
  - `include_moon_void_of_course` boolean
  - `include_fixed_stars` boolean
  - `fixed_stars` string[], nullable
  - `fixed_star_packs` string[], nullable
  - `lat` number, nullable
  - `lng` number, nullable
  - `tz_str` string, nullable
  - `dst_policy` 'reject' | 'earlier' | 'later' | 'shift_forward', nullable: Optional DST fold/gap policy. Omit to preserve legacy behavior.
  - `format` 'json' | 'table'
  - `response_mode` 'json' | 'table', nullable
  - `table_style` 'rows' | 'columns' | 'grid'
  - `include_sidereal_time` boolean, nullable
  - `cell_format` 'parts' | 'text', nullable
  - `include_chart_links` boolean
  - `sign_display` 'abbr' | 'full', nullable
  - `show_motion_markers` boolean, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/freeastroapi/apis/astroservice-api.md) · [All operations](https://skmtc.dev/freeastroapi/apis/astroservice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/freeastroapi/apis/astroservice-api/revisions/0c9b4a759522?raw)