---
title: "Electional Moment Analysis"
method: GET
path: "/electional/moment-analysis"
tags: ["electional"]
---

# Electional Moment Analysis

`GET /electional/moment-analysis`

## Request

- Base URL: `https://api.openephemeris.com`
- URL: `https://api.openephemeris.com/electional/moment-analysis`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-OpenEphemeris-API-Key`
  - API key in header `X-API-Key`
  - API key in header `X-Service-Key`

Score and analyse the astrological quality of a specific moment. Returns a 0-100 composite viability score derived from essential dignities, aspect quality, sect alignment, and void-of-course status.

## Query parameters

- `date` string
- `jd` number, double
- `latitude` number
- `longitude` number
- `format` string

## Response `200`

Moment analysis

- ElectionalMomentResponse
  - `aspects` ElectionalAspect[], nullable
    - `aspect_type` string
    - `orb` number
    - `planet1` string
    - `planet2` string
    - `quality_label` string
    - `quality_score` integer
  - `day_ruler` string, nullable
  - `dignity_breakdown` ElectionalPlanetDignity[], nullable
    - `dignity_label` string
    - `dignity_total` integer
    - `is_retrograde` boolean
    - `longitude` number
    - `motion_status` string
    - `planet_id` integer
    - `planet_name` string
    - `speed` number
  - `is_void` boolean, nullable
  - `iso_time` string, required
  - `jd` number, double, required
  - `lunar_phase` string, nullable
  - `rating` string, required: excellent/good/moderate/poor/avoid
  - `score` integer, required: Composite viability score 0-100
  - `score_detail` object, nullable: Component breakdown behind the composite score: dignity_score, aspect_score, sect_score and voc_penalty on their 0-100 sub-scales, plus sect_basis — how sect was determined (sun_house, or one of the default_diurnal_* fallbacks).
  - `sect` string, nullable: Chart sect the score was computed under: diurnal (Sun above the horizon) or nocturnal. Sect selects which triplicity rulers the dignity component rewards, so this is part of the score's basis, not decoration. Always populated — when latitude/longitude were absent or unusable it names the diurnal fallback, and score_detail.sect_basis says so.
  - `void_ends_at` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/openephemeris/apis/open-ephemeris-api.md) · [All operations](https://skmtc.dev/openephemeris/apis/open-ephemeris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openephemeris/apis/open-ephemeris-api/revisions/d195a769cb89?raw)