---
title: "Search Physical Examination Elections"
method: POST
path: "/api/v2/western/electional/physical-examination/search"
tags: ["Western v2"]
---

# Search Physical Examination Elections

`POST /api/v2/western/electional/physical-examination/search`

## 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/v2/western/electional/physical-examination/search`
- Auth: none declared

## Request body

- PhysicalExaminationElectionSearchRequest
  - `search_window` PhysicalExaminationElectionSearchWindowRequest, required
    - `start` string, required
    - `end` string, required
    - `step_minutes` integer
  - `location` PhysicalExaminationElectionLocationRequest
    - `city` string, nullable
    - `lat` number, nullable
    - `lng` number, nullable
    - `tz_str` string, nullable
  - `city` string, nullable
  - `lat` number, nullable
  - `lng` number, nullable
  - `tz_str` string, nullable
  - `search_tuning` PhysicalExaminationElectionSearchTuningRequest
    - `mode` 'direct' | 'year'
    - `coarse_step_minutes` integer, nullable
  - `patient_natal` PhysicalExaminationElectionNatalRequest
    - `name` string, nullable
    - `year` integer, required
    - `month` integer, required
    - `day` integer, required
    - `hour` integer, nullable
    - `minute` integer, nullable
    - `time_known` boolean
    - `city` string, nullable
    - `lat` number, nullable
    - `lng` number, nullable
    - `tz_str` string, nullable
  - `max_results` integer

## Response `200`

Successful Response

- PhysicalExaminationElectionSearchResponse
  - `meta` PhysicalExaminationElectionSearchMeta, required
    - `endpoint` string, required
    - `scoring_version` string, required
    - `calibration_version` string, required
    - `search_mode` 'direct' | 'year', required
    - `window_strategy` 'direct' | 'year_coarse_to_fine', required
    - `ranking_basis` string, required
    - `resolved_timezone` string, required
    - `scanned_candidates` integer, required
    - `coarse_candidates_scanned` integer, required
    - `refined_candidates_scanned` integer, required
    - `returned_candidates` integer, required
    - `advisories` string[]
    - `search_start_local` string, required
    - `search_end_local` string, required
    - `step_minutes` integer, required
    - `coarse_step_minutes` integer, nullable
  - `results` PhysicalExaminationElectionResult[], required
    - `rank` integer, required
    - `event_time_local` string, required
    - `event_time_utc` string, required
    - `score_total` number, required
    - `confidence_level` 'high' | 'moderate' | 'low', required
    - `quality_band` 'excellent' | 'strong' | 'mixed' | 'fragile' | 'poor', required
    - `status` 'recommended' | 'usable' | 'caution' | 'reject', required
    - `strict_traditional_verdict` 'sound' | 'blemished' | 'unsound', required
    - `strict_traditional_severity` 'none' | 'caution' | 'major' | 'fatal', required
    - `comparative_window_rank` integer, required
    - `comparative_window_percentile` number, required
    - `best_available_in_window` boolean, required
    - `review_flags` string[], required
    - `hard_stops` PhysicalExaminationElectionFactor[], required
      - `code` string, required
      - `title` string, required
      - `score` number, required
      - `detail` string, required
      - `severity` 'fatal' | 'major' | 'caution', nullable
    - `supporting_factors` PhysicalExaminationElectionFactor[], required
      - `code` string, required
      - `title` string, required
      - `score` number, required
      - `detail` string, required
      - `severity` 'fatal' | 'major' | 'caution', nullable
    - `caution_factors` PhysicalExaminationElectionFactor[], required
      - `code` string, required
      - `title` string, required
      - `score` number, required
      - `detail` string, required
      - `severity` 'fatal' | 'major' | 'caution', nullable
    - `natal_resonance` PhysicalExaminationElectionNatalResonance
      - `score` number, required
      - `patients` PhysicalExaminationElectionPatientResonance[], required
        - `patient` 'patient', required
        - `score` number, required
        - `supporting_factors` PhysicalExaminationElectionFactor[], required
          - `code` string, required
          - `title` string, required
          - `score` number, required
          - `detail` string, required
          - `severity` 'fatal' | 'major' | 'caution', nullable
        - `caution_factors` PhysicalExaminationElectionFactor[], required
          - `code` string, required
          - `title` string, required
          - `score` number, required
          - `detail` string, required
          - `severity` 'fatal' | 'major' | 'caution', nullable

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