Morphemeris DocsBeta

Secondary Progressions

GET /v1/progressed — Secondary progressed chart using the day-for-a-year method.

Secondary Progressions

Compute a secondary progressed chart. Secondary progressions use the "day-for-a-year" method: each day after birth corresponds to one year of life. The progressed chart for age 30 is computed using the planetary positions 30 days after birth.

Text
GET  /v1/progressed
POST /v1/progressed

Credit cost: 2

Parameters

ParameterTypeRequiredDefaultDescription
datetimestringOne of datetime or jdNatal datetime (ISO 8601 UTC)
jdnumberOne of datetime or jdNatal Julian Day in UT1
latnumberYesNatal latitude
lonnumberYesNatal longitude
target_datetimestringOne of target_datetime or target_jdProgression target (ISO 8601 UTC)
target_jdnumberOne of target_datetime or target_jdProgression target Julian Day
bodiesstringNo"planets"Comma-separated body names
systemstringNo"placidus"House system
siderealstringNoAyanamsha for sidereal mode
aspectsstringNoMajor 7Comma-separated aspect types
orbnumberNoGlobal orb override in degrees

The target_datetime must be after the natal datetime. If the target precedes the birth date, the API returns invalid_progression.

How it works

For someone born on June 15, 1990, requesting progressions for March 20, 2024:

  1. Calculate elapsed time — 2024-03-20 minus 1990-06-15 = ~33.76 years
  2. Convert to days — 33.76 years × 1 day/year = 33.76 days
  3. Compute progressed datetime — 1990-06-15 + 33.76 days = ~July 19, 1990
  4. Cast a natal chart for July 19, 1990 at the natal location

The progressed chart shows the slow evolution of the natal chart over a lifetime. The progressed Moon moves roughly 1° per month (12° per year), while the progressed Sun moves about 1° per year.

Response

The response has the same structure as /v1/natal-chart, with metadata.source set to "progressed".

JSON
{
  "data": {
    "metadata": {
      "source": "progressed",
      "jd": 2448100.0475,
      "datetime": "1990-07-19T13:08:00Z",
      "lat": 40.7128,
      "lon": -74.006,
      "..."
    },
    "bodies": [ "..." ],
    "houses": { "..." },
    "aspects": [ "..." ],
    "parallels": [],
    "dignities": [ "..." ]
  },
  "meta": { "..." }
}

The metadata shows the computed progressed datetime (not the target date).

Examples

Current progressions for a 1990 birth

Bash
curl "https://api.morphemeris.com/v1/progressed?\
datetime=1990-06-15T18:30:00Z&lat=40.7128&lon=-74.006\
&target_datetime=2024-03-20T00:00:00Z" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"
javascript
const res = await fetch(
  "https://api.morphemeris.com/v1/progressed?" + new URLSearchParams({
    datetime: "1990-06-15T18:30:00Z", lat: "40.7128", lon: "-74.006",
    target_datetime: "2024-03-20T00:00:00Z",
  }),
  { headers: { Authorization: "Bearer morphemeris_live_YOUR_KEY" } }
);
const { data } = await res.json();
Python
import requests

res = requests.get(
    "https://api.morphemeris.com/v1/progressed",
    params={
        "datetime": "1990-06-15T18:30:00Z", "lat": 40.7128, "lon": -74.006,
        "target_datetime": "2024-03-20T00:00:00Z",
    },
    headers={"Authorization": "Bearer morphemeris_live_YOUR_KEY"},
)
data = res.json()

Tips

  • The progressed Moon is the fastest-moving body in progressions — track it to find when it changes sign or aspects natal planets.
  • Progressed houses change very slowly. Some astrologers ignore progressed houses entirely and only interpret progressed planetary positions against the natal chart.
  • To compare progressed positions to natal positions, use /v1/synastry with the progressed datetime as one chart and the natal datetime as the other.