{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/openephemeris-com/json-schema/openephemeris-com-electional-angle-crossings-response-schema.json",
  "title": "ElectionalAngleCrossingsResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/openephemeris-com-electional-api-openapi.yml#/components/schemas/ElectionalAngleCrossingsResponse",
  "additionalProperties": false,
  "properties": {
    "crossings": {
      "description": "Chronological crossing events across all requested bodies and angles.",
      "items": {
        "$ref": "#/$defs/ElectionalAngleCrossing"
      },
      "title": "Crossings",
      "type": "array"
    },
    "search_summary": {
      "description": "Echo of the resolved search plus provenance. calculation_mode reports the geometry convention and matches /acg/power-lines exactly. When truncated is true the event list is NOT a complete chronological slice of the range — the sweep stopped part-way, so truncated_at_body, truncated_at_angle and omitted_bodies name what was left unsearched.",
      "title": "Search Summary",
      "type": "object"
    }
  },
  "required": [
    "crossings",
    "search_summary"
  ],
  "type": "object",
  "$defs": {
    "ElectionalAngleCrossing": {
      "additionalProperties": false,
      "properties": {
        "angle": {
          "description": "The angle the body reaches at this moment.",
          "enum": [
            "AC",
            "DC",
            "MC",
            "IC"
          ],
          "title": "Angle",
          "type": "string"
        },
        "body": {
          "description": "Canonical body name, e.g. Mercury.",
          "title": "Body",
          "type": "string"
        },
        "body_dec": {
          "description": "Declination in degrees at the crossing.",
          "format": "double",
          "title": "Body Dec",
          "type": "number"
        },
        "body_longitude": {
          "description": "Ecliptic longitude at the crossing.",
          "format": "double",
          "title": "Body Longitude",
          "type": "number"
        },
        "body_ra": {
          "description": "Right ascension in hours at the crossing.",
          "format": "double",
          "title": "Body Ra",
          "type": "number"
        },
        "daylight": {
          "description": "True when the Sun is above the horizon.",
          "title": "Daylight",
          "type": "boolean"
        },
        "iso_time": {
          "description": "Crossing moment, UTC, RFC 3339.",
          "title": "Iso Time",
          "type": "string"
        },
        "jd": {
          "description": "Crossing moment as a Julian Day.",
          "format": "double",
          "title": "Jd",
          "type": "number"
        },
        "progressed": {
          "description": "True when the body's position was secondary-progressed from natal_datetime (the ccg_hybrid set) rather than taken as a transit. Absent on a pure transit search.",
          "title": "Progressed",
          "type": "boolean"
        },
        "sun_altitude_deg": {
          "description": "Sun's altitude at the query point at the crossing moment. Negative is night. Returned in place of a bare visibility flag so callers can apply their own twilight threshold.",
          "format": "double",
          "title": "Sun Altitude Deg",
          "type": "number"
        }
      },
      "required": [
        "body",
        "angle",
        "iso_time",
        "jd",
        "body_longitude"
      ],
      "title": "ElectionalAngleCrossing",
      "type": "object"
    }
  }
}