---
title: "Get Secondary Progressions"
method: POST
path: "/api/v1/western/progressions/secondary"
tags: ["Western", "Western Synastry"]
---

# Get Secondary Progressions

`POST /api/v1/western/progressions/secondary`

## 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/western/progressions/secondary`
- Auth: none declared

Compute a secondary progressed chart using the classic symbolic timing rule:
1 day after birth = 1 year of life.

`target_date` accepts either `YYYY-MM-DD` or a full ISO datetime. Date-only values
are normalized to `00:00:00Z`. The endpoint returns the explicit progressed datetime
basis, the progressed chart, and optional movement/lifecycle/timeline expansions.

`orb_deg` is the maximum orb used for aspect detection and exact-hit refinement.
Timeline mode is opt-in through the `include=timeline` expansion and scans forward
from the target date for exact aspects, ingresses, stations, and major moon phases.

## Query parameters

- `include` string[], nullable: Optional CSV or repeated includes for payload expansion: natal_reference, movements, lifecycle, timeline, highlights.
- `response_mode` 'full' | 'table': Response shape. Default: `full`. Use `full` for the structured chart payload or `table` for lighter row-oriented tables.

## Request body

- SecondaryProgressionsRequest
  - `natal` SecondaryProgressionsNatalInput, required
    - `name` string
    - `datetime` string, required
    - `time_known` boolean
    - `location` SolarReturnLocation, required
      - `city` string, required
      - `lat` number, nullable
      - `lng` number, nullable
      - `tz_str` string, nullable
  - `secondary_progression` SecondaryProgressionTarget, required
    - `target_date` string, required
    - `target_location` SolarReturnLocation
      - `city` string, required
      - `lat` number, nullable
      - `lng` number, nullable
      - `tz_str` string, nullable
    - `settings` SecondaryProgressionsSettings
      - `zodiac_type` 'tropical' | 'sidereal'
      - `sidereal_ayanamsa` string, nullable
      - `house_system` string
      - `orb_deg` number
      - `aspect_set` 'major' | 'major_plus'
      - `include_angles` boolean
      - `include_houses` boolean
      - `include_aspects` boolean
      - `include_speed` boolean
      - `include_dignity` boolean
      - `include_minor_aspects` boolean
      - `include_stelliums` boolean
      - `include_features` string[], nullable
      - `include_dominants` boolean
      - `orb_settings` object, nullable
      - `timeline_years` number

## Response `200`

Successful Response

- union
  - SecondaryProgressionsResponse
    - `meta` SecondaryProgressionsMeta, required
      - `endpoint` 'secondary_progressions'
      - `version` string
      - `zodiac_type` 'tropical' | 'sidereal', required
      - `ayanamsa` string, nullable
      - `house_system` string, required
      - `calculation_method` 'secondary_progressions_day_for_year'
      - `target_date` string, required
      - `target_datetime` string, required
      - `orb_deg` number, required
      - `generated_at` string, required
    - `input` SecondaryProgressionsInput, required
      - `birth_datetime` string, required
      - `birth_location` object, required
      - `include_angles` boolean, required
      - `include_houses` boolean, required
      - `include_aspects` boolean, required
      - `include_speed` boolean, required
      - `include_dignity` boolean, required
      - `include_minor_aspects` boolean, required
      - `include_stelliums` boolean, required
      - `include_features` string[]
      - `include_dominants` boolean, required
      - `include_timeline` boolean, required
    - `progression_basis` ProgressionBasis, required
      - `age_years_decimal` number, required
      - `progressed_days_after_birth` number, nullable
      - `natal_datetime_utc` string, required
      - `progressed_datetime_utc` string, nullable
      - `arc_deg` number, nullable
    - `progressed_chart` ChartPayload, required
      - `points` object, required
      - `angles` object, nullable
      - `houses` HousePayload[], nullable
        - `house` integer, required
        - `longitude_deg` number, required
        - `longitude_text` string, nullable
        - `sign` SignInfo, required
          - `name` string, required
          - `index` integer, required
          - `abbr` string, required
        - `position_in_sign_deg` number, required
      - `stelliums` object, nullable
      - `dominants` object, nullable
    - `natal_reference` ChartPayload
      - `points` object, required
      - `angles` object, nullable
      - `houses` HousePayload[], nullable
        - `house` integer, required
        - `longitude_deg` number, required
        - `longitude_text` string, nullable
        - `sign` SignInfo, required
          - `name` string, required
          - `index` integer, required
          - `abbr` string, required
        - `position_in_sign_deg` number, required
      - `stelliums` object, nullable
      - `dominants` object, nullable
    - `movements` MovementsPayload
      - `ingresses` IngressEvent[]
        - `point` string, required
        - `from_sign` SignInfo, required
          - `name` string, required
          - `index` integer, required
          - `abbr` string, required
        - `to_sign` SignInfo, required
          - `name` string, required
          - `index` integer, required
          - `abbr` string, required
        - `event_date` string, required
        - `interpretation_key` string, required
      - `stations` StationEvent[]
        - `point` string, required
        - `station_type` 'retrograde' | 'direct', required
        - `event_date` string, required
        - `interpretation_key` string, required
      - `phase_markers` PhaseMarkerEvent[]
        - `name` string, required
        - `event_date` string, required
        - `interpretation_key` string, required
    - `aspects` AspectsPayload
      - `progressed_to_natal` ProgressedToNatalAspect[], required
        - `id` string, required
        - `aspect` AspectDescriptor, required
          - `name` string, required
          - `angle_deg` number, required
        - `progressed_point` string, required
        - `natal_point` string, required
        - `orb_deg` number, required
        - `separation_deg` number, required
        - `applying` boolean, required
        - `exact` boolean, required
        - `exact_date` string, nullable
        - `polarity` 'hard' | 'soft' | 'neutral', required
        - `strength` number, required
        - `category` 'major' | 'minor', required
        - `interpretation_key` string, required
      - `progressed_to_progressed` ProgressedToProgressedAspect[], required
        - `id` string, required
        - `aspect` AspectDescriptor, required
          - `name` string, required
          - `angle_deg` number, required
        - `point_1` string, required
        - `point_2` string, required
        - `orb_deg` number, required
        - `separation_deg` number, required
        - `applying` boolean, required
        - `exact` boolean, required
        - `exact_date` string, nullable
        - `polarity` 'hard' | 'soft' | 'neutral', required
        - `strength` number, required
        - `category` 'major' | 'minor', required
        - `interpretation_key` string, required
    - `lifecycle` LifecyclePayload
      - `progressed_moon` ProgressedMoonLifecycle, required
        - `phase_angle_deg` number, required
        - `phase_name` string, required
        - `waxing` boolean, required
        - `next_major_phase` NextMajorPhase, required
          - `name` string, required
          - `event_date` string, nullable
      - `progressed_sun` ProgressedSunLifecycle, required
        - `sign` SignInfo, required
          - `name` string, required
          - `index` integer, required
          - `abbr` string, required
        - `position_in_sign_deg` number, required
        - `next_ingress` IngressEvent
          - `point` string, required
          - `from_sign` SignInfo, required
            - `name` string, required
            - `index` integer, required
            - `abbr` string, required
          - `to_sign` SignInfo, required
            - `name` string, required
            - `index` integer, required
            - `abbr` string, required
          - `event_date` string, required
          - `interpretation_key` string, required
    - `highlights` HighlightPayload[], nullable
      - `type` 'aspect' | 'ingress' | 'station' | 'phase', required
      - `title` string, required
      - `severity` 'strong' | 'medium' | 'light', required
      - `score` integer, required
      - `category` string, required
      - `interpretation_key` string, required
      - `reason_codes` string[], required
    - `timeline` TimelinePayload
      - `from` string, required
      - `to` string, required
      - `events` TimelineEvent[], required
        - `date` string, required
        - `type` 'exact_at_target' | 'becomes_exact' | 'ingress' | 'station' | 'moon_phase', required
        - `title` string, required
        - `interpretation_key` string, required
  - ProgressionTableResponse
    - `meta` ProgressionChartMeta, required
      - `endpoint` 'progressions_chart'
      - `version` string
      - `system` 'secondary' | 'converse_secondary' | 'tertiary' | 'quotidian' | 'quaternary', required
      - `zodiac_type` 'tropical' | 'sidereal', required
      - `ayanamsa` string, nullable
      - `house_system` string, required
      - `calculation_method` string, required
      - `target_date` string, required
      - `target_datetime` string, required
      - `orb_deg` number, required
      - `generated_at` string, required
    - `input` SecondaryProgressionsInput, required
      - `birth_datetime` string, required
      - `birth_location` object, required
      - `include_angles` boolean, required
      - `include_houses` boolean, required
      - `include_aspects` boolean, required
      - `include_speed` boolean, required
      - `include_dignity` boolean, required
      - `include_minor_aspects` boolean, required
      - `include_stelliums` boolean, required
      - `include_features` string[]
      - `include_dominants` boolean, required
      - `include_timeline` boolean, required
    - `progression_basis` ProgressionBasis, required
      - `age_years_decimal` number, required
      - `progressed_days_after_birth` number, nullable
      - `natal_datetime_utc` string, required
      - `progressed_datetime_utc` string, nullable
      - `arc_deg` number, nullable
    - `tables` ProgressionTablesPayload, required
      - `points` TablePointRow[], required
        - `point` string, required
        - `name` string, required
        - `longitude_deg` number, required
        - `longitude_text` string, required
        - `sign` SignInfo, required
          - `name` string, required
          - `index` integer, required
          - `abbr` string, required
        - `position_in_sign_deg` number, required
        - `house` integer, nullable
        - `retrograde` boolean, required
        - `speed_longitude_deg_per_day` number, nullable
        - `dignity` string, nullable
      - `angles` TableAngleRow[]
        - `angle` string, required
        - `longitude_deg` number, required
        - `longitude_text` string, required
        - `sign` SignInfo, required
          - `name` string, required
          - `index` integer, required
          - `abbr` string, required
        - `position_in_sign_deg` number, required
      - `houses` TableHouseRow[]
        - `house` integer, required
        - `longitude_deg` number, required
        - `longitude_text` string, required
        - `sign` SignInfo, required
          - `name` string, required
          - `index` integer, required
          - `abbr` string, required
        - `position_in_sign_deg` number, required
      - `aspects` TableAspectRow[]
        - `relation` 'progressed_to_natal' | 'progressed_to_progressed', required
        - `point_1` string, required
        - `point_2` string, required
        - `aspect_name` string, required
        - `aspect_angle_deg` number, required
        - `orb_deg` number, required
        - `separation_deg` number, required
        - `applying` boolean, required
        - `exact` boolean, required
        - `exact_date` string, nullable
        - `interpretation_key` string, required
      - `events` TableEventRow[]
        - `type` string, required
        - `date` string, required
        - `title` string, required
        - `interpretation_key` string, required

## 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)