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

# Get Converse Secondary Progressions

`POST /api/v1/western/progressions/converse-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/converse-secondary`
- Auth: none declared

## Query parameters

- `response_mode` 'full' | 'table'

## Request body

- ConverseSecondaryProgressionsRequest
  - `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
  - `converse_secondary_progression` ConverseSecondaryProgressionTarget, 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
  - ProgressionChartResponse
    - `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
    - `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
    - `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
  - 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)