{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/openephemeris-com/json-schema/openephemeris-com-natal-angle-crossings-response-schema.json",
  "title": "NatalAngleCrossingsResponse",
  "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/NatalAngleCrossingsResponse",
  "additionalProperties": false,
  "properties": {
    "search_summary": {
      "description": "Echo of the resolved search plus provenance. calculation_mode is \"Zodiacal (Relocated Natal Angles)\" — the relocated angle is a fixed ecliptic-longitude degree for the whole search, distinct from GET /electional/angle-crossings' in-mundo geometry; the two calculation_mode strings never collide. When truncated is true the window list is NOT a complete chronological slice of the range — truncated_at_body, truncated_at_angle and omitted_bodies name what was left unsearched.",
      "title": "Search Summary",
      "type": "object"
    },
    "windows": {
      "description": "Chronological orb-window passes across all requested bodies and angles.",
      "items": {
        "$ref": "#/$defs/NatalAngleCrossingWindow"
      },
      "title": "Windows",
      "type": "array"
    }
  },
  "required": [
    "windows",
    "search_summary"
  ],
  "type": "object",
  "$defs": {
    "NatalAngleCrossingWindow": {
      "additionalProperties": false,
      "properties": {
        "angle": {
          "description": "The relocated natal angle this pass crosses.",
          "enum": [
            "AC",
            "DC",
            "MC",
            "IC"
          ],
          "title": "Angle",
          "type": "string"
        },
        "body": {
          "description": "Canonical transiting body name, e.g. Mars.",
          "title": "Body",
          "type": "string"
        },
        "enter": {
          "description": "Moment the body enters orb_deg of the angle, UTC RFC 3339. Null when the local boundary search found no entry within its bounded horizon (e.g. a station keeps the body inside orb for an extended stretch) — omitted rather than guessed.",
          "title": "Enter",
          "type": [
            "string",
            "null"
          ]
        },
        "exact": {
          "description": "Exact crossing moment, UTC RFC 3339.",
          "title": "Exact",
          "type": "string"
        },
        "leave": {
          "description": "Moment the body leaves orb_deg of the angle, UTC RFC 3339. Same omission rule as enter.",
          "title": "Leave",
          "type": [
            "string",
            "null"
          ]
        },
        "relocated_angle_deg": {
          "description": "Fixed ecliptic longitude of the relocated natal angle for this search (same value /ephemeris/relocation returns for this natal + point).",
          "format": "double",
          "title": "Relocated Angle Deg",
          "type": "number"
        },
        "retrograde": {
          "description": "True when the body is moving retrograde at the exact moment. A retrograde triple pass over the same angle produces three separate windows, one per pass — never a single window with multiple exacts.",
          "title": "Retrograde",
          "type": "boolean"
        }
      },
      "required": [
        "body",
        "angle",
        "relocated_angle_deg",
        "exact",
        "retrograde"
      ],
      "title": "NatalAngleCrossingWindow",
      "type": "object"
    }
  }
}