JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/cosmic-ephemeris/json-schema/cosmic-ephemeris-connected-horoscope-request-schema.json",
"title": "ConnectedHoroscopeRequest",
"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/ConnectedHoroscopeRequest",
"oneOf": [
{
"$ref": "#/$defs/HoroscopeRequest"
},
{
"$ref": "#/$defs/HistoricalHoroscopeRequest"
}
],
"$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."
},
"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."
},
"HoroscopeRequest": {
"type": "object",
"properties": {
"birth": {
"$ref": "#/$defs/BirthInput"
},
"transitDate": {
"anyOf": [
{
"$ref": "#/$defs/Date"
},
{
"type": "null"
}
],
"description": "Omitted/null selects the engine host current UTC date. Supply an explicit date for reproducible results."
},
"transitTime": {
"$ref": "#/$defs/OptionalTransitTime"
},
"timezone": {
"$ref": "#/$defs/Timezone",
"description": "Transit timezone only. Omitted/null/empty string means UTC, NOT the birth timezone. Birth timezone is not overridden."
},
"zodiac": {
"$ref": "#/$defs/ZodiacInput"
},
"ayanamsa": {
"$ref": "#/$defs/AyanamsaInput"
}
},
"required": [
"birth"
],
"additionalProperties": true,
"allOf": [
{
"$ref": "#/$defs/SiderealFlagsConstraint"
}
]
},
"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."
},
"OptionalTransitTime": {
"anyOf": [
{
"$ref": "#/$defs/Time"
},
{
"type": "null"
}
],
"default": "12:00",
"description": "Omitted/null means 12:00; false/empty string and malformed values are rejected."
},
"SiderealFlagsConstraint": {
"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*$"
}
}
}
},
"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.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/cosmic-ephemeris-connected-horoscope-request"
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.