---
title: "Get Ephemeris"
method: GET
path: "/api/v1/ephemeris"
tags: ["Ephemeris", "ephemeris"]
---

# Get Ephemeris

`GET /api/v1/ephemeris`

## 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`
- Auth: none declared

## Query parameters

- `start` string, required
- `end` string, nullable
- `step` string
- `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
- `timezone` string, nullable
- `dst_policy` 'reject' | 'earlier' | 'later' | 'shift_forward', nullable: Optional DST fold/gap policy. Omit to preserve legacy behavior.
- `format` 'json' | 'table', nullable
- `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)