---
title: "Get Transit Insights"
method: POST
path: "/api/v1/western/transits/insights"
tags: ["Western", "Western Synastry"]
---

# Get Transit Insights

`POST /api/v1/western/transits/insights`

## 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/transits/insights`
- Auth: none declared

Compute derived transit insight windows from the transit timeline engine.

## Request body

- TransitTimelineRequest
  - `natal` union, required
    - object
      - `name` string, nullable
      - `year` integer, required: Astronomical year (0-2399; 0 = 1 BCE)
      - `month` integer, required
      - `day` integer, required
      - `hour` integer, nullable
      - `minute` integer, nullable
      - `time_known` boolean
      - `city` string, nullable, required
      - `lat` number, nullable
      - `lng` number, nullable
      - `tz_str` string, nullable
      - `dst_policy` 'reject' | 'earlier' | 'later' | 'shift_forward', nullable: Optional DST fold/gap policy. Omit to preserve legacy behavior; use reject for strict integrations.
      - `renderer` 'default'
      - `theme` string, nullable
      - `format` string, nullable
      - `lang` string, nullable
      - `size` integer, nullable
      - `glyphs` boolean, nullable
      - `show_aspects` boolean, nullable
      - `show_houses` boolean, nullable
      - `show_positions_panel` boolean, nullable
      - `show_legend` boolean, nullable
      - `custom_css` string, nullable
      - `house_system` string, nullable
      - `orb_settings` AspectOrbSettings: Per-aspect detection orbs, expressed in degrees.
        - `conjunction` number, nullable
        - `opposition` number, nullable
        - `trine` number, nullable
        - `square` number, nullable
        - `sextile` number, nullable
        - `quincunx` number, nullable
        - `quintile` number, nullable
        - `semi_sextile` number, nullable
        - `semi_square` number, nullable
        - `sesquiquadrate` number, nullable
      - `include_speed` boolean, nullable
      - `lilith` boolean, nullable
      - `mean_lilith` boolean, nullable
      - `true_lilith` boolean, nullable
      - `chiron` boolean, nullable
      - `chiron_invisible_door` boolean, nullable
      - `chiron_visible_door` boolean, nullable
      - `true_node` boolean, nullable
      - `mean_node` boolean, nullable
      - `pholus` boolean, nullable
      - `ceres` boolean, nullable
      - `pallas` boolean, nullable
      - `juno` boolean, nullable
      - `vesta` boolean, nullable
      - `eris` boolean, nullable
      - `eros` boolean, nullable
      - `vertex` boolean, nullable
      - `include_minor_aspects` boolean, nullable
      - `include_declination_aspects` boolean, nullable
      - `declination_orb` number, nullable
      - `include_stelliums` boolean, nullable
      - `stellium_policy` 'legacy' | 'classified', nullable: Optional stellium classification policy. Natal insights defaults omission to 'classified'; other shared-request endpoints retain legacy omission behavior. 'legacy' preserves count-based sign/house groups; 'classified' requires a conjunction cluster and reports loose sign/house occupancy as concentrations.
      - `include_tables` boolean, nullable
      - `include_fixed_stars` boolean, nullable
      - `fixed_stars` string[], nullable
      - `fixed_star_packs` string[], nullable
      - `include_features` string[], nullable
      - `include_dominants` boolean, nullable
      - `dominants_method` 'traditional' | 'modern', nullable: Opt in to detailed planet dominance scores, weighted elements, and a signature sign. Omit this field to keep the default response unchanged.
      - `include_dignity` boolean, nullable
      - `include_rulers` boolean, nullable
      - `include_configurations` boolean, nullable
      - `zodiac_type` string, nullable
      - `sidereal_ayanamsa` string, nullable
      - `view` 'all' | 'grouped-top' | 'grouped-all' | 'grouped-canonical', nullable
      - `separate_signatures_from_facts` boolean, nullable
      - `response_format` 'full' | 'flat', nullable: Use 'flat' to return a shallow no-code-friendly response with a single text field.
      - `interpretation` InterpretationSettings
        - `enable` boolean
        - `template_id` string, nullable
        - `language` string, nullable
        - `style` string, nullable
      - `psychological_report` PsychologicalReportSettings
        - `enabled` boolean
        - `mode` 'async' | 'sync'
        - `style` 'standard' | 'jungian_parental', nullable
        - `tone` string, nullable
        - `depth` string, nullable
        - `audience` string, nullable
        - `focus_areas` string[], nullable
        - `excluded_topics` string[], nullable
        - `custom_instructions` string, nullable
        - `report_structure` object, nullable
        - `markdown` boolean
        - `output_format` 'json' | 'pdf', nullable
        - `include_chart_in_pdf` boolean
        - `include_svg_chart_in_pdf` boolean
        - `include_natal_chart_in_response` boolean
        - `pdf_matrix_position` 'end' | 'after_chart', nullable
        - `chart_config` object, nullable
        - `pdf_footer_label` string, nullable
        - `include_profile_branding_logo` boolean
        - `callback_url` string, nullable
        - `callback_signing_secret` string, nullable
    - object
      - `name` string, nullable
      - `year` integer, required: Astronomical year (0-2399; 0 = 1 BCE)
      - `month` integer, required
      - `day` integer, required
      - `hour` integer, nullable
      - `minute` integer, nullable
      - `time_known` boolean
      - `city` string, nullable
      - `lat` number, nullable, required
      - `lng` number, nullable, required
      - `tz_str` string, nullable
      - `dst_policy` 'reject' | 'earlier' | 'later' | 'shift_forward', nullable: Optional DST fold/gap policy. Omit to preserve legacy behavior; use reject for strict integrations.
      - `renderer` 'default'
      - `theme` string, nullable
      - `format` string, nullable
      - `lang` string, nullable
      - `size` integer, nullable
      - `glyphs` boolean, nullable
      - `show_aspects` boolean, nullable
      - `show_houses` boolean, nullable
      - `show_positions_panel` boolean, nullable
      - `show_legend` boolean, nullable
      - `custom_css` string, nullable
      - `house_system` string, nullable
      - `orb_settings` AspectOrbSettings: Per-aspect detection orbs, expressed in degrees.
        - `conjunction` number, nullable
        - `opposition` number, nullable
        - `trine` number, nullable
        - `square` number, nullable
        - `sextile` number, nullable
        - `quincunx` number, nullable
        - `quintile` number, nullable
        - `semi_sextile` number, nullable
        - `semi_square` number, nullable
        - `sesquiquadrate` number, nullable
      - `include_speed` boolean, nullable
      - `lilith` boolean, nullable
      - `mean_lilith` boolean, nullable
      - `true_lilith` boolean, nullable
      - `chiron` boolean, nullable
      - `chiron_invisible_door` boolean, nullable
      - `chiron_visible_door` boolean, nullable
      - `true_node` boolean, nullable
      - `mean_node` boolean, nullable
      - `pholus` boolean, nullable
      - `ceres` boolean, nullable
      - `pallas` boolean, nullable
      - `juno` boolean, nullable
      - `vesta` boolean, nullable
      - `eris` boolean, nullable
      - `eros` boolean, nullable
      - `vertex` boolean, nullable
      - `include_minor_aspects` boolean, nullable
      - `include_declination_aspects` boolean, nullable
      - `declination_orb` number, nullable
      - `include_stelliums` boolean, nullable
      - `stellium_policy` 'legacy' | 'classified', nullable: Optional stellium classification policy. Natal insights defaults omission to 'classified'; other shared-request endpoints retain legacy omission behavior. 'legacy' preserves count-based sign/house groups; 'classified' requires a conjunction cluster and reports loose sign/house occupancy as concentrations.
      - `include_tables` boolean, nullable
      - `include_fixed_stars` boolean, nullable
      - `fixed_stars` string[], nullable
      - `fixed_star_packs` string[], nullable
      - `include_features` string[], nullable
      - `include_dominants` boolean, nullable
      - `dominants_method` 'traditional' | 'modern', nullable: Opt in to detailed planet dominance scores, weighted elements, and a signature sign. Omit this field to keep the default response unchanged.
      - `include_dignity` boolean, nullable
      - `include_rulers` boolean, nullable
      - `include_configurations` boolean, nullable
      - `zodiac_type` string, nullable
      - `sidereal_ayanamsa` string, nullable
      - `view` 'all' | 'grouped-top' | 'grouped-all' | 'grouped-canonical', nullable
      - `separate_signatures_from_facts` boolean, nullable
      - `response_format` 'full' | 'flat', nullable: Use 'flat' to return a shallow no-code-friendly response with a single text field.
      - `interpretation` InterpretationSettings
        - `enable` boolean
        - `template_id` string, nullable
        - `language` string, nullable
        - `style` string, nullable
      - `psychological_report` PsychologicalReportSettings
        - `enabled` boolean
        - `mode` 'async' | 'sync'
        - `style` 'standard' | 'jungian_parental', nullable
        - `tone` string, nullable
        - `depth` string, nullable
        - `audience` string, nullable
        - `focus_areas` string[], nullable
        - `excluded_topics` string[], nullable
        - `custom_instructions` string, nullable
        - `report_structure` object, nullable
        - `markdown` boolean
        - `output_format` 'json' | 'pdf', nullable
        - `include_chart_in_pdf` boolean
        - `include_svg_chart_in_pdf` boolean
        - `include_natal_chart_in_response` boolean
        - `pdf_matrix_position` 'end' | 'after_chart', nullable
        - `chart_config` object, nullable
        - `pdf_footer_label` string, nullable
        - `include_profile_branding_logo` boolean
        - `callback_url` string, nullable
        - `callback_signing_secret` string, nullable
  - `range_start` string, required
  - `range_end` string, required
  - `mode` 'month' | 'year_slow'
  - `include_houses` boolean, nullable
  - `transit_categories` string[], nullable
  - `transit_planets` string[], nullable
  - `natal_points` string[], nullable
  - `aspect_types` string[], nullable
  - `orb_settings` object, nullable

## Response `200`

Successful Response

- TransitInsightsResponse
  - `meta` TransitInsightMeta, required
    - `endpoint` string
    - `detector_version` string, required
    - `mode` string, required
    - `range_start` string, required
    - `range_end` string, required
    - `generated_at` string, required
    - `time_known` boolean, required
    - `include_houses` boolean, required
    - `timeline_pass_count` integer, required
    - `generated_fact_count` integer, required
  - `summary` object, required
  - `importance` TransitInsightImportance[], required
    - `id` string, required
    - `title` string, required
    - `category` string, required
    - `focus_type` string, required
    - `score` number, required
    - `rank` integer, required
    - `peak_datetime` string, nullable
    - `window_days` integer, nullable
    - `source_fact_ids` string[], required
    - `driver_tags` string[], required
  - `facts` TransitInsightFact[], required
    - `id` string, required
    - `category` string, required
    - `detector` string, required
    - `kind` string, required
    - `subjects` string[], required
    - `strength` number, required
    - `priority` integer, required
    - `evidence` object, required
    - `flags` object, required
    - `tags` string[], required
    - `entities` object, required
    - `search_text` string, required
    - `relation_key` string, required
    - `index_keys` 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)