Cosmic Ephemeris · Schema

ConnectedTimelineRequest

AstrologyDevelopersDataU.S.-based
View JSON Schema on GitHub

JSON Schema

cosmic-ephemeris-connected-timeline-request-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/cosmic-ephemeris/json-schema/cosmic-ephemeris-connected-timeline-request-schema.json",
  "title": "ConnectedTimelineRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/cosmic-ephemeris-pro-timeline-api-openapi.yml#/components/schemas/ConnectedTimelineRequest",
  "oneOf": [
    {
      "$ref": "#/$defs/TimelineRequest"
    },
    {
      "$ref": "#/$defs/HistoricalTimelineRequest"
    }
  ],
  "$defs": {
    "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."
    },
    "HistoricalTimelineRequest": {
      "type": "object",
      "properties": {
        "planet": {
          "type": "string",
          "description": "One of sun, moon, mercury, venus, mars, jupiter, saturn, rahu, ketu. Case/whitespace are normalized. Rahu/Ketu are mean lunar nodes.",
          "x-canonical-values": [
            "sun",
            "moon",
            "mercury",
            "venus",
            "mars",
            "jupiter",
            "saturn",
            "rahu",
            "ketu"
          ],
          "pattern": "^\\s*(?:[Ss][Uu][Nn]|[Mm][Oo][Oo][Nn]|[Mm][Ee][Rr][Cc][Uu][Rr][Yy]|[Vv][Ee][Nn][Uu][Ss]|[Mm][Aa][Rr][Ss]|[Jj][Uu][Pp][Ii][Tt][Ee][Rr]|[Ss][Aa][Tt][Uu][Rr][Nn]|[Rr][Aa][Hh][Uu]|[Kk][Ee][Tt][Uu])\\s*$"
        },
        "ayanamsa": {
          "type": "string",
          "description": "Required even though chart endpoints default it. One of lahiri, raman, krishnamurti, fagan_bradley, yukteshwar, sassanian, true_chitra, true_revati, true_pushya, galactic_center_0_sagittarius, galactic_alignment_mardyks; case/whitespace are normalized.",
          "x-canonical-values": [
            "lahiri",
            "raman",
            "krishnamurti",
            "fagan_bradley",
            "yukteshwar",
            "sassanian",
            "true_chitra",
            "true_revati",
            "true_pushya",
            "galactic_center_0_sagittarius",
            "galactic_alignment_mardyks"
          ],
          "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]|[Ff][Aa][Gg][Aa][Nn]_[Bb][Rr][Aa][Dd][Ll][Ee][Yy]|[Yy][Uu][Kk][Tt][Ee][Ss][Hh][Ww][Aa][Rr]|[Ss][Aa][Ss][Ss][Aa][Nn][Ii][Aa][Nn]|[Tt][Rr][Uu][Ee]_[Cc][Hh][Ii][Tt][Rr][Aa]|[Tt][Rr][Uu][Ee]_[Rr][Ee][Vv][Aa][Tt][Ii]|[Tt][Rr][Uu][Ee]_[Pp][Uu][Ss][Hh][Yy][Aa]|[Gg][Aa][Ll][Aa][Cc][Tt][Ii][Cc]_[Cc][Ee][Nn][Tt][Ee][Rr]_0_[Ss][Aa][Gg][Ii][Tt][Tt][Aa][Rr][Ii][Uu][Ss]|[Gg][Aa][Ll][Aa][Cc][Tt][Ii][Cc]_[Aa][Ll][Ii][Gg][Nn][Mm][Ee][Nn][Tt]_[Mm][Aa][Rr][Dd][Yy][Kk][Ss])\\s*$"
        },
        "start": {
          "$ref": "#/$defs/HistoricalDateTime"
        },
        "end": {
          "$ref": "#/$defs/HistoricalDateTime"
        },
        "step_seconds": {
          "const": 3600
        }
      },
      "required": [
        "planet",
        "start",
        "end"
      ],
      "additionalProperties": false,
      "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."
    },
    "OffsetTimestamp": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp with Z or an explicit numeric UTC offset. Prefer RFC 3339, e.g. 2026-01-01T00:00:00Z. Naive local timestamps are rejected. The server normalizes offsets to UTC before comparing ordering, duration and the inclusive 1800-01-01 through 2200-12-31 UTC-date bounds."
    },
    "TimelineRequest": {
      "type": "object",
      "properties": {
        "planet": {
          "type": "string",
          "description": "One of sun, moon, mercury, venus, mars, jupiter, saturn, rahu, ketu. Case/whitespace are normalized. Rahu/Ketu are mean lunar nodes.",
          "x-canonical-values": [
            "sun",
            "moon",
            "mercury",
            "venus",
            "mars",
            "jupiter",
            "saturn",
            "rahu",
            "ketu"
          ],
          "pattern": "^\\s*(?:[Ss][Uu][Nn]|[Mm][Oo][Oo][Nn]|[Mm][Ee][Rr][Cc][Uu][Rr][Yy]|[Vv][Ee][Nn][Uu][Ss]|[Mm][Aa][Rr][Ss]|[Jj][Uu][Pp][Ii][Tt][Ee][Rr]|[Ss][Aa][Tt][Uu][Rr][Nn]|[Rr][Aa][Hh][Uu]|[Kk][Ee][Tt][Uu])\\s*$"
        },
        "start_utc": {
          "$ref": "#/$defs/OffsetTimestamp"
        },
        "end_utc": {
          "$ref": "#/$defs/OffsetTimestamp",
          "description": "Must be strictly later than start_utc and at most 180 days later. Both UTC dates must be inside the public date window."
        },
        "ayanamsa": {
          "type": "string",
          "description": "Required even though chart endpoints default it. One of lahiri, raman, krishnamurti, fagan_bradley, yukteshwar, sassanian, true_chitra, true_revati, true_pushya, galactic_center_0_sagittarius, galactic_alignment_mardyks; case/whitespace are normalized.",
          "x-canonical-values": [
            "lahiri",
            "raman",
            "krishnamurti",
            "fagan_bradley",
            "yukteshwar",
            "sassanian",
            "true_chitra",
            "true_revati",
            "true_pushya",
            "galactic_center_0_sagittarius",
            "galactic_alignment_mardyks"
          ],
          "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]|[Ff][Aa][Gg][Aa][Nn]_[Bb][Rr][Aa][Dd][Ll][Ee][Yy]|[Yy][Uu][Kk][Tt][Ee][Ss][Hh][Ww][Aa][Rr]|[Ss][Aa][Ss][Ss][Aa][Nn][Ii][Aa][Nn]|[Tt][Rr][Uu][Ee]_[Cc][Hh][Ii][Tt][Rr][Aa]|[Tt][Rr][Uu][Ee]_[Rr][Ee][Vv][Aa][Tt][Ii]|[Tt][Rr][Uu][Ee]_[Pp][Uu][Ss][Hh][Yy][Aa]|[Gg][Aa][Ll][Aa][Cc][Tt][Ii][Cc]_[Cc][Ee][Nn][Tt][Ee][Rr]_0_[Ss][Aa][Gg][Ii][Tt][Tt][Aa][Rr][Ii][Uu][Ss]|[Gg][Aa][Ll][Aa][Cc][Tt][Ii][Cc]_[Aa][Ll][Ii][Gg][Nn][Mm][Ee][Nn][Tt]_[Mm][Aa][Rr][Dd][Yy][Kk][Ss])\\s*$"
        }
      },
      "required": [
        "planet",
        "start_utc",
        "end_utc",
        "ayanamsa"
      ],
      "additionalProperties": true,
      "description": "Pro only. Unknown fields are ignored; step_seconds is not a public control and is not passed to the engine. Each admitted request reserves one timeline unit, independent of range."
    }
  }
}

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-timeline-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.