# Astronomy API v3

**Canonical:** https://apis.io/apis/astronomy-api/astronomy-api-v3/  
**Provider:** Astronomy API — https://apis.io/providers/astronomy-api/  
**Base URL:** https://api.astronomyapi.com/api/v3  
**Documentation:** https://docs.astronomyapi.com/api-v3-reference-draft/v3

Astronomy API v3 is one of 6 APIs that [Astronomy API](https://apis.io/providers/astronomy-api/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Astronomy, Positions, Events, and Star Charts. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Version 3 of the Astronomy API, published by the provider as a reference draft with a complete OpenAPI 3.1 definition before it ships — "so that the design can be read and argued with". A breaking redesign of the v2 request and response shapes: JSON numbers instead of strings, one representation per value, a declared meta.units block, ISO 8601 instants with an explicit sampling step and timezone, cursor pagination on positions, RFC 9457 problem details, bearer authentication, and apsis events alongside eclipses. Five operations across positions, events, search and the two studio renderers. NOT YET IN PRODUCTION — /api/v2 remains the callable surface.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/positions` | Positions of one or more bodies over a span of time |
| GET | `/events` | Eclipses and apsides for the observer's location |
| GET | `/search` | Find deep sky objects and stars |
| POST | `/studio/star-chart` | Render a star chart |
| POST | `/studio/moon-phase` | Render the Moon's phase |

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/astronomy-api/refs/heads/main/openapi/astronomy-api-v3-openapi.yaml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/astronomy-api/refs/heads/main/overlays/astronomy-api-v3-overlay.yaml
- **Documentation** — https://docs.astronomyapi.com/api-v3-reference-draft/v3
- **Documentation** — https://docs.astronomyapi.com/api-v3-reference-draft/v3/migrating-from-v2

## Other Astronomy API APIs (5)

- [Astronomy API](https://apis.io/apis/astronomy-api/astronomy-api/)
- [Astronomy API Bodies API](https://apis.io/apis/astronomy-api/astronomy-api-bodies-api/)
- [Astronomy API Events API](https://apis.io/apis/astronomy-api/astronomy-api-events-api/)
- [Astronomy API Search API](https://apis.io/apis/astronomy-api/astronomy-api-search-api/)
- [Astronomy API Studio API](https://apis.io/apis/astronomy-api/astronomy-api-studio-api/)

## Tags

Astronomy, Positions, Events, Star Charts

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/astronomy-api/astronomy-api-v3/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/astronomy-api/.