---
title: "Get Annual Profections"
method: POST
path: "/api/v1/western/profections/annual"
tags: ["Western", "Western Synastry"]
---

# Get Annual Profections

`POST /api/v1/western/profections/annual`

## 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/profections/annual`
- Auth: none declared

Annual profections endpoint with a solar-return-style envelope and a timing-oriented body.

## Query parameters

- `include` string[], nullable: Optional CSV or repeated includes for profection payload expansion.

## Request body

- AnnualProfectionRequest
  - `name` string, nullable
  - `year` integer, required
  - `month` integer, required
  - `day` integer, required
  - `hour` integer, nullable
  - `minute` integer, nullable
  - `time_known` boolean
  - `city` string, required
  - `lat` number, nullable
  - `lng` number, nullable
  - `tz_str` string, nullable
  - `dst_policy` 'reject' | 'earlier' | 'later' | 'shift_forward', nullable
  - `annual_profection` AnnualProfectionTarget, required
    - `year` integer, required
    - `settings` AnnualProfectionSettings
      - `zodiac_type` 'Tropical' | 'Sidereal'
      - `sidereal_ayanamsa` string, nullable
      - `orb_policy` OrbPolicy
        - `default_orb_deg` number
        - `by_aspect_deg` object
        - `by_body_multiplier` object
        - `apply_separate` boolean
        - `apply_bonus` number

## Response `200`

Successful Response

- AnnualProfectionResponse
  - `meta` AnnualProfectionResponseMeta, required
    - `report_id` string, required
    - `generated_at` string, required
    - `engine` ProfectionEngineMeta
      - `name` string
      - `version` string
    - `calculation` AnnualProfectionMetaCalculation, required
      - `zodiac_type` string, required
      - `sidereal_ayanamsa` string, nullable
      - `profection_method` 'whole_sign', required
      - `orb_policy` ProfectionAspectOrbPolicy, required
        - `default_orb_deg` number, required
        - `by_aspect_deg` object
      - `includes` string[]
    - `annual_profection` AnnualProfectionMetaDetails, required
      - `target_year` integer, required
      - `age_at_start` integer, required
      - `period` ProfectionTimeWindow, required
        - `start` string, required
        - `end` string, required
    - `natal_reference` ProfectionNatalReference, required
      - `natal_datetime` string, required
      - `natal_location` ProfectionPublicLocation, required
        - `city` string, required
        - `lat` number, nullable
        - `lng` number, nullable
        - `timezone` string, nullable
      - `time_known` boolean, required
    - `warnings` ProfectionWarning[]
      - `code` string, required
      - `message` string, required
      - `severity` 'info' | 'warning' | 'critical'
    - `resolved_time` object, nullable
  - `subject` ProfectionSubject, required
    - `name` string, required
    - `datetime` string, required
    - `location` ProfectionPublicLocation, required
      - `city` string, required
      - `lat` number, nullable
      - `lng` number, nullable
      - `timezone` string, nullable
    - `settings` ProfectionSubjectSettings, required
      - `house_system` string, required
      - `zodiac_type` string, required
      - `time_known` boolean, required
      - `sidereal_ayanamsa` string, nullable
  - `profection` ProfectionBody, required
    - `annual` AnnualProfectionSummary, required
      - `age` integer, required
      - `activated_house` integer, nullable
      - `activated_sign_name` string, nullable
      - `activated_sign_id` string, nullable
      - `time_lord_name` string, nullable
      - `time_lord_id` string, nullable
      - `period` ProfectionTimeWindow, required
        - `start` string, required
        - `end` string, required
      - `notes` string[]
    - `monthly_profections` MonthlyProfectionItem[], nullable
      - `month_index` integer, required
      - `activated_house` integer, nullable
      - `activated_sign_name` string, nullable
      - `activated_sign_id` string, nullable
      - `time_lord_name` string, nullable
      - `time_lord_id` string, nullable
      - `period` ProfectionTimeWindow, required
        - `start` string, required
        - `end` string, required
    - `natal_time_lord_details` NatalTimeLordDetails
      - `id` string, required
      - `name` string, required
      - `sign_name` string, required
      - `sign_id` string, required
      - `pos` number, required
      - `abs_pos` number, required
      - `house` integer, nullable
      - `retrograde` boolean, required
      - `speed` number, nullable
    - `activated_house_planets` ActivatedHousePlanet[], nullable
      - `id` string, required
      - `name` string, required
      - `sign_name` string, required
      - `sign_id` string, required
      - `pos` number, required
      - `abs_pos` number, required
      - `house` integer, nullable
      - `retrograde` boolean, required
    - `time_lord_aspects` TimeLordAspect[], nullable
      - `time_lord_id` string, required
      - `time_lord_name` string, required
      - `other_body_id` string, required
      - `other_body_name` string, required
      - `other_body_sign_name` string, required
      - `other_body_sign_id` string, required
      - `other_body_house` integer, nullable
      - `other_body_abs_pos` number, required
      - `aspect` string, required
      - `orb` number, required
      - `deg` number, required
      - `is_major` boolean, required
      - `is_applying` boolean, 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)