# openephemeris-com Predictive API

**Canonical:** https://apis.io/apis/openephemeris-com/openephemeris-com-predictive-api/  
**Provider:** openephemeris-com — https://apis.io/providers/openephemeris-com/  
**Base URL:** https://api.openephemeris.com  
**Documentation:** https://openephemeris.com/docs

openephemeris-com Predictive API is one of 20 APIs that [openephemeris-com](https://apis.io/providers/openephemeris-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include predictive. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Look ahead (or behind). Find exact times for transits, cast solar & lunar returns, calculate progressions, and run traditional time-lord techniques (primary directions, firdaria, annual profections, zodiacal releasing). **5 units per request** (progressed-chart and transit-chart snapshot calls are 1 unit).

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| POST | `/ephemeris/progressed` | Calculate progressed chart (Secondary, Tertiary, Solar Arc) |
| POST | `/mundane/chart` | Mundane Chart |
| POST | `/predictive/eclipses/natal-hits` | Eclipses That Hit a Natal Chart |
| POST | `/predictive/primary-directions` | Calculate Primary Directions |
| POST | `/predictive/returns` | Calculate Planetary Return Timing |
| POST | `/predictive/returns/lunar` | Calculate Lunar Return Timing |
| POST | `/predictive/returns/solar` | Calculate Solar Return Timing |
| POST | `/predictive/sky-recurrence` | Sky Recurrence: When Does Your Sky Return? |
| POST | `/predictive/time-lords/distributions` | Distribution Through the Bounds |
| POST | `/predictive/time-lords/firdaria` | Firdaria Planetary Periods |
| POST | `/predictive/time-lords/profections` | Annual Profections Time Lords |
| POST | `/predictive/time-lords/zodiacal-releasing` | Zodiacal Releasing Time Lords |
| POST | `/predictive/transit-chart` | Calculate transit chart (full chart snapshot) |
| POST | `/predictive/transits/planet-to-degree` | Calculate Planetary Transit to Degree |
| POST | `/predictive/transits/search` | Search Transit Events |
| POST | `/predictive/transits/sign-ingresses` | Calculate Sign Ingresses |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/openephemeris-com/openapi/openephemeris-com-predictive-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/openephemeris-com/json-schema/openephemeris-com-acgccgrequest-payload-schema.json
- **JSONSchema** — https://artifacts.apis.io/openephemeris-com/json-schema/openephemeris-com-acgrequest-payload-schema.json
- **JSONSchema** — https://artifacts.apis.io/openephemeris-com/json-schema/openephemeris-com-natal-chart-enhanced-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/openephemeris-com/json-schema/openephemeris-com-vedic-chart-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/openephemeris-com/json-schema/openephemeris-com-zodiacal-releasing-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/openephemeris-com/json-schema/openephemeris-com-acglocal-space-request-payload-schema.json

## Other openephemeris-com APIs (12)

- [openephemeris-com ACG API](https://apis.io/apis/openephemeris-com/openephemeris-com-acg-api/)
- [openephemeris-com Agricultural API](https://apis.io/apis/openephemeris-com/openephemeris-com-agricultural-api/)
- [openephemeris-com API Metadata API](https://apis.io/apis/openephemeris-com/openephemeris-com-api-metadata-api/)
- [openephemeris-com Calendar API](https://apis.io/apis/openephemeris-com/openephemeris-com-calendar-api/)
- [openephemeris-com Catalogs API](https://apis.io/apis/openephemeris-com/openephemeris-com-catalogs-api/)
- [openephemeris-com Chinese API](https://apis.io/apis/openephemeris-com/openephemeris-com-chinese-api/)
- [openephemeris-com Comparative API](https://apis.io/apis/openephemeris-com/openephemeris-com-comparative-api/)
- [openephemeris-com Eclipse API](https://apis.io/apis/openephemeris-com/openephemeris-com-eclipse-api/)
- [openephemeris-com Electional API](https://apis.io/apis/openephemeris-com/openephemeris-com-electional-api/)
- [openephemeris-com Ephemeris API](https://apis.io/apis/openephemeris-com/openephemeris-com-ephemeris-api/)
- [openephemeris-com Health API](https://apis.io/apis/openephemeris-com/openephemeris-com-health-api/)
- [openephemeris-com Human Design API](https://apis.io/apis/openephemeris-com/openephemeris-com-human-design-api/)

## Tags

predictive

---

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