Progressed Calendar

POST/api/v1/western/progressions/{system}/calendar

Calendar endpoints aggregate exact aspect hits, sign ingresses, optional house ingresses, and system-specific extras like stations or Moon phases into one curated event feed.

This endpoint requires x-api-key. The example below is a complete authenticated request.

How It Works

Default calendar output is curated for significance. Add event_types to explicitly request specific event families such as house_ingress only.

Calendar windows are capped by system: 3 years for secondary and converse secondary, 2 years for tertiary, and 1 year for quotidian and quaternary.

Supported Systems

This calendar pattern works for all five systems. Replace {system} with secondary, converse-secondary, tertiary, quotidian, or quaternary.

Example Request

curl -X POST "https://api.freeastroapi.com/api/v1/western/progressions/secondary/calendar" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "natal": {
    "name": "User",
    "datetime": "1990-01-01 12:00",
    "time_known": true,
    "location": {
      "city": "London",
      "lat": 51.5074,
      "lng": -0.1278,
      "tz_str": "AUTO"
    }
  },
  "calendar": {
    "from": "2026-03-30",
    "to": "2027-03-30"
  }
}'

Real API Response Example

Captured from the live API on April 14, 2026 using the request above.

{
  "meta": {
    "endpoint": "calendar",
    "version": "v1",
    "system": "secondary",
    "zodiac_type": "tropical",
    "house_system": "placidus",
    "generated_at": "2026-04-14T15:54:56Z"
  },
  "window": {
    "from": "2026-03-30T00:00:00Z",
    "to": "2027-03-30T00:00:00Z"
  },
  "counts": {
    "exact_aspect": 12
  },
  "events": [
    {
      "type": "exact_aspect",
      "date": "2026-03-30T00:00:00Z",
      "title": "Progressed Mars Conjunction Uranus",
      "system": "secondary",
      "interpretation_key": "progressed_mars_conjunction_natal_uranus",
      "basis": {
        "age_years_decimal": 36.240337,
        "progressed_days_after_birth": 36.240337,
        "natal_datetime_utc": "1990-01-01T12:00:00Z",
        "progressed_datetime_utc": "1990-02-06T17:46:05Z"
      }
    },
    {
      "type": "exact_aspect",
      "date": "2026-04-19T22:30:00Z",
      "title": "Progressed Pluto Square Sun",
      "system": "secondary",
      "interpretation_key": "progressed_pluto_square_progressed_sun",
      "basis": {
        "age_years_decimal": 36.297662,
        "progressed_days_after_birth": 36.297662,
        "natal_datetime_utc": "1990-01-01T12:00:00Z",
        "progressed_datetime_utc": "1990-02-06T19:08:37Z"
      }
    },
    {
      "type": "exact_aspect",
      "date": "2026-05-04T00:00:00Z",
      "title": "Progressed Moon Opposition Sun",
      "system": "secondary",
      "interpretation_key": "progressed_moon_opposition_natal_sun",
      "basis": {
        "age_years_decimal": 36.336164,
        "progressed_days_after_birth": 36.336164,
        "natal_datetime_utc": "1990-01-01T12:00:00Z",
        "progressed_datetime_utc": "1990-02-06T20:04:04Z"
      }
    },
    {
      "type": "exact_aspect",
      "date": "2026-06-08T00:00:00Z",
      "title": "Progressed Moon Opposition Neptune",
      "system": "secondary",
      "interpretation_key": "progressed_moon_opposition_natal_neptune",
      "basis": {
        "age_years_decimal": 36.431991,
        "progressed_days_after_birth": 36.431991,
        "natal_datetime_utc": "1990-01-01T12:00:00Z",
        "progressed_datetime_utc": "1990-02-06T22:22:03Z"
      }
    },
    {
      "type": "exact_aspect",
      "date": "2026-07-13T00:00:00Z",
      "title": "Progressed Moon Opposition Neptune",
      "system": "secondary",
      "interpretation_key": "progressed_moon_opposition_progressed_neptune",
      "basis": {
        "age_years_decimal": 36.527817,
        "progressed_days_after_birth": 36.527817,
        "natal_datetime_utc": "1990-01-01T12:00:00Z",
        "progressed_datetime_utc": "1990-02-07T00:40:03Z"
      }
    },
    {
      "type": "exact_aspect",
      "date": "2026-09-11T00:00:00Z",
      "title": "Progressed Moon Opposition Saturn",
      "system": "secondary",
      "interpretation_key": "progressed_moon_opposition_natal_saturn",
      "basis": {
        "age_years_decimal": 36.692092,
        "progressed_days_after_birth": 36.692092,
        "natal_datetime_utc": "1990-01-01T12:00:00Z",
        "progressed_datetime_utc": "1990-02-07T04:36:36Z"
      }
    },
    {
      "type": "exact_aspect",
      "date": "2026-10-19T02:52:58Z",
      "title": "Progressed Moon Trine Pluto",
      "system": "secondary",
      "interpretation_key": "progressed_moon_trine_natal_pluto",
      "basis": {
        "age_years_decimal": 36.796461,
        "progressed_days_after_birth": 36.796461,
        "natal_datetime_utc": "1990-01-01T12:00:00Z",
        "progressed_datetime_utc": "1990-02-07T07:06:54Z"
      }
    },
    {
      "type": "exact_aspect",
      "date": "2026-11-05T11:43:07Z",
      "title": "Progressed Moon Trine Pluto",
      "system": "secondary",
      "interpretation_key": "progressed_moon_trine_progressed_pluto",
      "basis": {
        "age_years_decimal": 36.844014,
        "progressed_days_after_birth": 36.844014,
        "natal_datetime_utc": "1990-01-01T12:00:00Z",
        "progressed_datetime_utc": "1990-02-07T08:15:22Z"
      }
    }
  ]
}

Related Docs

Progressions overview Exact aspects