Cosmic Ephemeris · Schema

ConnectedHoroscopeHoroscopeResponse

AstrologyDevelopersDataU.S.-based
View JSON Schema on GitHub

JSON Schema

cosmic-ephemeris-connected-horoscope-horoscope-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/cosmic-ephemeris/json-schema/cosmic-ephemeris-connected-horoscope-horoscope-response-schema.json",
  "title": "ConnectedHoroscopeHoroscopeResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/cosmic-ephemeris-interpretation-api-openapi.yml#/components/schemas/ConnectedHoroscopeHoroscopeResponse",
  "oneOf": [
    {
      "$ref": "#/$defs/HoroscopeResponse"
    },
    {
      "$ref": "#/$defs/HistoricalHoroscopeHoroscopeResponse"
    }
  ],
  "$defs": {
    "AyanamsaInput": {
      "type": [
        "string",
        "null"
      ],
      "pattern": "\\S",
      "default": "lahiri",
      "description": "Sidereal supports lahiri, raman, krishnamurti, fagan_bradley, yukteshwar, sassanian, true_chitra, true_revati, true_pushya, galactic_center_0_sagittarius, galactic_alignment_mardyks, with case/whitespace normalization; other names return 400 in sidereal mode. Omitted/null selects lahiri. Tropical mode ignores a nonempty string and outputs null. This schema describes that compatibility behavior rather than claiming every string is a supported sidereal model.",
      "x-canonical-values": [
        "lahiri",
        "raman",
        "krishnamurti",
        "fagan_bradley",
        "yukteshwar",
        "sassanian",
        "true_chitra",
        "true_revati",
        "true_pushya",
        "galactic_center_0_sagittarius",
        "galactic_alignment_mardyks"
      ]
    },
    "BirthInput": {
      "type": "object",
      "properties": {
        "date": {
          "$ref": "#/$defs/Date"
        },
        "time": {
          "$ref": "#/$defs/Time"
        },
        "timezone": {
          "$ref": "#/$defs/Timezone"
        },
        "lat": {
          "$ref": "#/$defs/Latitude"
        },
        "lon": {
          "$ref": "#/$defs/Longitude"
        }
      },
      "required": [
        "date",
        "time",
        "lat",
        "lon"
      ],
      "additionalProperties": true
    },
    "Date": {
      "type": "string",
      "format": "date",
      "pattern": "^(?:18[0-9]{2}|19[0-9]{2}|2[01][0-9]{2}|2200)-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$",
      "description": "Valid Gregorian YYYY-MM-DD local civil date, inclusive 1800-01-01 through 2200-12-31. Calendar validity and timezone conversion are checked by the server."
    },
    "HistoricalBirthInput": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "date",
        "time",
        "timezone",
        "lat",
        "lon"
      ],
      "properties": {
        "date": {
          "$ref": "#/$defs/HistoricalDate"
        },
        "time": {
          "$ref": "#/$defs/HistoricalClock"
        },
        "timezone": {
          "$ref": "#/$defs/HistoricalTimezone"
        },
        "lat": {
          "type": "number",
          "exclusiveMinimum": -90,
          "exclusiveMaximum": 90
        },
        "lon": {
          "type": "number",
          "minimum": -180,
          "exclusiveMaximum": 180
        }
      }
    },
    "HistoricalClock": {
      "type": "string",
      "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9](?::[0-5][0-9])?(?![\\s\\S])",
      "description": "Explicit HH:MM[:SS]; whole seconds only, no leap seconds. Normalized helper output includes seconds."
    },
    "HistoricalDate": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "year",
        "era",
        "month",
        "day",
        "calendar"
      ],
      "properties": {
        "year": {
          "type": "integer",
          "minimum": 1,
          "maximum": 2500
        },
        "era": {
          "enum": [
            "BCE",
            "CE"
          ],
          "description": "Display BCE (BC) / CE (AD); API values remain BCE / CE. No year zero."
        },
        "month": {
          "type": "integer",
          "minimum": 1,
          "maximum": 12
        },
        "day": {
          "type": "integer",
          "minimum": 1,
          "maximum": 31
        },
        "calendar": {
          "enum": [
            "proleptic_gregorian",
            "proleptic_julian"
          ],
          "description": "Explicit choice; applies the selected calendar rules throughout history without a regional adoption switch."
        }
      },
      "allOf": [
        {
          "if": {
            "type": "object",
            "properties": {
              "era": {
                "const": "BCE"
              }
            }
          },
          "then": {
            "type": "object",
            "properties": {
              "year": {
                "maximum": 1000
              }
            }
          }
        }
      ],
      "description": "Explicit civil date, 1000 BCE (BC)–2500 CE (AD); no year zero. Calendar validity is checked by the server. Available only on documented connected historical operations, with explicit UT1/fixed-offset conventions."
    },
    "HistoricalDateTime": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "date",
        "time",
        "timezone"
      ],
      "properties": {
        "date": {
          "$ref": "#/$defs/HistoricalDate"
        },
        "time": {
          "$ref": "#/$defs/HistoricalClock"
        },
        "timezone": {
          "$ref": "#/$defs/HistoricalTimezone"
        }
      },
      "description": "Shared historical input contract; parsing alone does not enable a calculation route. Derived calculation records can include fractional seconds and are not this input type."
    },
    "HistoricalHoroscopeHoroscopeResponse": {
      "type": "object",
      "additionalProperties": true,
      "required": [
        "schema",
        "status",
        "type",
        "input",
        "result",
        "metadata"
      ],
      "properties": {
        "schema": {
          "const": "cosmicephemeris-historical-calculation-v1"
        },
        "status": {
          "const": "historical"
        },
        "type": {
          "const": "horoscope"
        },
        "input": {
          "$ref": "#/$defs/HistoricalHoroscopeRequest"
        },
        "result": {
          "type": "object",
          "additionalProperties": true,
          "description": "Complete historical calculation adapter result. Times are explicit UT1 date records, never UTC strings; derived times may include fractional seconds and years outside the input range."
        },
        "metadata": {
          "type": "object",
          "additionalProperties": true,
          "required": [
            "time_standard",
            "historical_accuracy_certified",
            "warnings"
          ],
          "properties": {
            "time_standard": {
              "const": "UT1"
            },
            "historical_accuracy_certified": {
              "const": false
            },
            "warnings": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "HistoricalHoroscopeRequest": {
      "type": "object",
      "properties": {
        "birth": {
          "$ref": "#/$defs/HistoricalBirthInput"
        },
        "zodiac": {
          "type": [
            "string",
            "null"
          ],
          "pattern": "^\\s*(?:[Tt][Rr][Oo][Pp][Ii][Cc][Aa][Ll]|[Ss][Ii][Dd][Ee][Rr][Ee][Aa][Ll])\\s*$",
          "default": "tropical",
          "description": "tropical or sidereal; server trims whitespace and ignores case. Omitted/null selects tropical.",
          "x-canonical-values": [
            "tropical",
            "sidereal"
          ]
        },
        "ayanamsa": {
          "type": [
            "string",
            "null"
          ],
          "pattern": "\\S",
          "default": "lahiri",
          "description": "Sidereal supports lahiri, raman, krishnamurti, fagan_bradley, yukteshwar, sassanian, true_chitra, true_revati, true_pushya, galactic_center_0_sagittarius, galactic_alignment_mardyks, with case/whitespace normalization; other names return 400 in sidereal mode. Omitted/null selects lahiri. Tropical mode ignores a nonempty string and outputs null. This schema describes that compatibility behavior rather than claiming every string is a supported sidereal model.",
          "x-canonical-values": [
            "lahiri",
            "raman",
            "krishnamurti",
            "fagan_bradley",
            "yukteshwar",
            "sassanian",
            "true_chitra",
            "true_revati",
            "true_pushya",
            "galactic_center_0_sagittarius",
            "galactic_alignment_mardyks"
          ]
        },
        "at": {
          "$ref": "#/$defs/HistoricalDateTime"
        }
      },
      "required": [
        "birth",
        "at"
      ],
      "additionalProperties": false,
      "allOf": [
        {
          "description": "Only supported ayanamsa names are valid when zodiac is sidereal; tropical retains its legacy ignore behavior.",
          "if": {
            "type": "object",
            "properties": {
              "zodiac": {
                "type": "string",
                "pattern": "^\\s*(?:[Ss][Ii][Dd][Ee][Rr][Ee][Aa][Ll])\\s*$"
              }
            },
            "required": [
              "zodiac"
            ]
          },
          "then": {
            "type": "object",
            "properties": {
              "ayanamsa": {
                "type": [
                  "string",
                  "null"
                ],
                "pattern": "^\\s*(?:[Ll][Aa][Hh][Ii][Rr][Ii]|[Rr][Aa][Mm][Aa][Nn]|[Kk][Rr][Ii][Ss][Hh][Nn][Aa][Mm][Uu][Rr][Tt][Ii])\\s*$"
              }
            }
          }
        }
      ],
      "description": "Explicit historical mode, 1000 BCE (BC)–2500 CE (AD). No year zero, implicit calendar, UTC or IANA zone. Preserve tool-specific mathematical, geographic and search limits; calendar/time conventions and estimated Delta-T are not certified historical accuracy."
    },
    "HistoricalTimezone": {
      "type": "string",
      "pattern": "^UT1(?:[+-](?:0[0-9]|1[0-3]):[0-5][0-9](?::[0-5][0-9])?|[+-]14:00(?::00)?)?(?![\\s\\S])",
      "description": "Explicit UT1 or fixed offset UT1+/-HH:MM[:SS], within 14 hours. Local clock minus offset yields UT1, not UTC. No IANA timezone inference. Original offset spelling is preserved."
    },
    "HoroscopeResponse": {
      "type": "object",
      "properties": {
        "type": {
          "const": "horoscope"
        },
        "input": {
          "type": "object",
          "properties": {
            "birth": {
              "$ref": "#/$defs/BirthInput"
            },
            "transitDate": {
              "$ref": "#/$defs/Date"
            },
            "zodiac": {
              "$ref": "#/$defs/ZodiacInput"
            },
            "ayanamsa": {
              "$ref": "#/$defs/AyanamsaInput"
            }
          },
          "required": [
            "birth",
            "transitDate",
            "zodiac",
            "ayanamsa"
          ],
          "additionalProperties": true
        },
        "interpretation": {
          "$ref": "#/$defs/Interpretation"
        }
      },
      "required": [
        "type",
        "input",
        "interpretation"
      ],
      "additionalProperties": true,
      "description": "Supported deterministic structured major-aspect signals. No language model, prose, compatibility score, medical/financial prediction, or house topics. The input echo currently omits transitTime/timezone; retain your request for reproducibility."
    },
    "Interpretation": {
      "type": "object",
      "properties": {
        "summary": {
          "type": "object",
          "properties": {
            "overall_tone": {
              "type": "string",
              "enum": [
                "supportive",
                "challenging",
                "mixed"
              ]
            },
            "intensity": {
              "type": "number",
              "minimum": 0,
              "maximum": 1
            }
          },
          "required": [
            "overall_tone",
            "intensity"
          ],
          "additionalProperties": true
        },
        "transits": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/InterpretationAtom"
          }
        }
      },
      "required": [
        "summary",
        "transits"
      ],
      "additionalProperties": true
    },
    "InterpretationAtom": {
      "type": "object",
      "properties": {
        "planet": {
          "$ref": "#/$defs/PlanetName"
        },
        "planet_nature": {
          "type": "string",
          "enum": [
            "luminary",
            "neutral",
            "benefic",
            "malefic"
          ]
        },
        "planet_sect": {
          "type": "string",
          "enum": [
            "day",
            "night",
            "neutral"
          ]
        },
        "chart_sect": {
          "type": "string",
          "enum": [
            "day",
            "night"
          ],
          "description": "Natal apparent topocentric Sun center geometric altitude >0 degrees means day; WGS84 elevation zero, no atmospheric refraction."
        },
        "aspect": {
          "type": "string",
          "enum": [
            "Conjunction",
            "Opposition",
            "Square",
            "Trine",
            "Sextile"
          ]
        },
        "natal_point": {
          "$ref": "#/$defs/PlanetName"
        },
        "house": {
          "type": "null",
          "description": "No house assignment is implemented for this endpoint."
        },
        "house_topics": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 0
        },
        "tone": {
          "type": "string",
          "enum": [
            "intensifying",
            "polarizing",
            "challenging",
            "supportive",
            "opportunity"
          ]
        },
        "intensity": {
          "type": "number",
          "minimum": 0.1,
          "maximum": 1,
          "description": "Deterministic traditional-rule heuristic, not a probability or scientifically validated prediction."
        },
        "tradition": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "hellenistic",
              "western"
            ]
          },
          "minItems": 2,
          "maxItems": 2
        },
        "summary_key": {
          "type": "string",
          "description": "Machine key such as saturn_square_sun, not authored/generated prose."
        }
      },
      "required": [
        "planet",
        "planet_nature",
        "planet_sect",
        "chart_sect",
        "aspect",
        "natal_point",
        "house",
        "house_topics",
        "tone",
        "intensity",
        "tradition",
        "summary_key"
      ],
      "additionalProperties": true
    },
    "Latitude": {
      "anyOf": [
        {
          "type": "number",
          "exclusiveMinimum": -90,
          "exclusiveMaximum": 90
        },
        {
          "type": "string",
          "pattern": "^\\s*[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?\\s*$"
        }
      ],
      "description": "WGS84 decimal latitude. JSON numbers are recommended; numeric strings are accepted by the current engine, then checked for finiteness/range. Exact poles and undefined Ascendant geometry return 400; supported successful latitude is strictly between -90 and 90. Boolean/null/object/array coordinates are invalid."
    },
    "Longitude": {
      "anyOf": [
        {
          "type": "number",
          "minimum": -180,
          "maximum": 180
        },
        {
          "type": "string",
          "pattern": "^\\s*[+-]?(?:[0-9]+(?:\\.[0-9]*)?|\\.[0-9]+)(?:[eE][+-]?[0-9]+)?\\s*$"
        }
      ],
      "description": "WGS84 decimal longitude, east positive, within [-180,180]. JSON numbers are recommended; numeric strings are accepted then checked for finiteness/range."
    },
    "PlanetName": {
      "type": "string",
      "enum": [
        "Sun",
        "Moon",
        "Mercury",
        "Venus",
        "Mars",
        "Jupiter",
        "Saturn",
        "Uranus",
        "Neptune",
        "Pluto"
      ]
    },
    "Time": {
      "type": "string",
      "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9](?::[0-5][0-9])?$",
      "description": "HH:MM or HH:MM:SS; no offset in this field. Use timezone to select the civil-time zone."
    },
    "Timezone": {
      "type": [
        "string",
        "null"
      ],
      "description": "IANA timezone name (for example America/New_York). Omission, null, or empty string means UTC for a birth input. Nonexistent or ambiguous local clock-change times return 400; provide the known UTC date/time with timezone UTC instead."
    },
    "ZodiacInput": {
      "type": [
        "string",
        "null"
      ],
      "pattern": "^\\s*(?:[Tt][Rr][Oo][Pp][Ii][Cc][Aa][Ll]|[Ss][Ii][Dd][Ee][Rr][Ee][Aa][Ll])\\s*$",
      "default": "tropical",
      "description": "tropical or sidereal; server trims whitespace and ignores case. Omitted/null selects tropical.",
      "x-canonical-values": [
        "tropical",
        "sidereal"
      ]
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/cosmic-ephemeris-connected-horoscope-horoscope-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.