openephemeris-com · Schema
CatalogBodiesResponse
Response with celestial bodies catalog.
CompanyAstrologyArtificial IntelligenceAstronomyData
Properties
| Name | Type | Description |
|---|---|---|
| bodies | array | Catalog entries |
| calculation_metadata | object | Canonical calculation metadata describing the catalog source |
| calculation_support | object | Calculation availability |
| catalog_version | string | Catalog version |
| categories | object | Count by category |
| filters_applied | object | Applied filters |
| last_updated | string | Last update timestamp |
| total_count | integer | Total number of bodies |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/openephemeris-com/json-schema/openephemeris-com-catalog-bodies-response-schema.json",
"title": "CatalogBodiesResponse",
"description": "Response with celestial bodies catalog.",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/openephemeris-com-catalogs-api-openapi.yml#/components/schemas/CatalogBodiesResponse",
"additionalProperties": false,
"properties": {
"bodies": {
"description": "Catalog entries",
"items": {
"$ref": "#/$defs/CatalogBodyItem"
},
"title": "Bodies",
"type": "array"
},
"calculation_metadata": {
"$ref": "#/$defs/CalculationMetadata",
"description": "Canonical calculation metadata describing the catalog source"
},
"calculation_support": {
"additionalProperties": {
"type": "integer"
},
"description": "Calculation availability",
"title": "Calculation Support",
"type": "object"
},
"catalog_version": {
"description": "Catalog version",
"title": "Catalog Version",
"type": "string"
},
"categories": {
"additionalProperties": {
"type": "integer"
},
"description": "Count by category",
"title": "Categories",
"type": "object"
},
"filters_applied": {
"description": "Applied filters",
"title": "Filters Applied",
"type": "object"
},
"last_updated": {
"description": "Last update timestamp",
"format": "date-time",
"title": "Last Updated",
"type": "string"
},
"total_count": {
"description": "Total number of bodies",
"title": "Total Count",
"type": "integer"
}
},
"required": [
"bodies",
"total_count",
"filters_applied",
"categories",
"calculation_support",
"catalog_version",
"last_updated"
],
"type": "object",
"$defs": {
"AyanamsaEnum": {
"description": "Supported sidereal ayanamsa options (krishnamurti is KP old, krishnamurti_vp291 KP new). All six are computed from the same IAU 2006 general-precession model, so each is epoch-dependent rather than a frozen constant; they differ by up to ~2.3 degrees, which is enough to move a body across a sign boundary. Defaults to lahiri when zodiac_type is sidereal and no system is named.",
"enum": [
"lahiri",
"fagan_bradley",
"krishnamurti",
"krishnamurti_vp291",
"raman",
"yukteshwar"
],
"title": "AyanamsaEnum",
"type": "string"
},
"CalculationMetadata": {
"additionalProperties": true,
"description": "Metadata about chart calculations.\n\nRelaxed to allow minimal fields used by tests while remaining forward-compatible.",
"properties": {
"ascendant_on_left": {
"default": true,
"description": "When true (default), the Ascendant is placed at the 9 o'clock (West/left) position � matching the convention used by Astro.com, Solar Fire, and all major astrology software. Set to false to use the ecliptic-fixed (Aries-pinned) orientation instead.",
"title": "Ascendant on Left",
"type": [
"boolean",
"null"
]
},
"ayanamsa": {
"anyOf": [
{
"$ref": "#/$defs/AyanamsaEnum"
},
{
"type": "string"
}
],
"description": "Sidereal ayanamsa selection",
"title": "Ayanamsa"
},
"calculation_time": {
"anyOf": [
{
"type": "number"
}
],
"description": "Legacy calculation time in seconds",
"title": "Calculation Time"
},
"calculation_time_ms": {
"anyOf": [
{
"type": "number"
}
],
"description": "Processing time at the orchestrator layer in milliseconds",
"title": "Calculation Time Ms"
},
"calculation_time_utc": {
"anyOf": [
{
"format": "date-time",
"type": "string"
}
],
"description": "UTC timestamp when the calculation executed",
"title": "Calculation Time Utc"
},
"coordinate_reference_frame": {
"anyOf": [
{
"type": "string"
}
],
"description": "Coordinate frame the positions are expressed in, always the TRUE ecliptic of date: geocentric_true_ecliptic_of_date (apparent place from the Earth's centre), topocentric_true_ecliptic_of_date (apparent place from the observer, with diurnal parallax and aberration; geometric, no refraction, observer height 0), heliocentric_true_ecliptic_of_date and barycentric_true_ecliptic_of_date (light-time-corrected astrometric place from the Sun's centre / the solar-system barycentre: no aberration, no gravitational deflection; target sampled at t minus light time, origin at t). The label names the frame that was computed; a response never claims one it did not use.",
"title": "Coordinate Reference Frame"
},
"coordinate_system": {
"anyOf": [
{
"$ref": "#/$defs/CoordinateSystemEnum"
},
{
"type": "string"
}
],
"description": "Coordinate system the positions were computed in: geocentric, topocentric, heliocentric or barycentric.",
"title": "Coordinate System"
},
"delta_t_seconds": {
"anyOf": [
{
"type": "number"
}
],
"description": "Delta T (TT - UT1) applied during calculation, in seconds",
"title": "Delta T Seconds"
},
"delta_t_source": {
"anyOf": [
{
"$ref": "#/$defs/DeltaTSourceEnum"
},
{
"type": "string"
}
],
"description": "Source of Delta T values (computation engine, IERS, approximation)",
"title": "Delta T Source"
},
"ephemeris_source": {
"anyOf": [
{
"type": "string"
}
],
"description": "Primary ephemeris source (e.g., SuperNOVAS / Calceph)",
"title": "Ephemeris Source"
},
"ephemeris_version": {
"anyOf": [
{
"type": "string"
}
],
"description": "Version of the ephemeris data files",
"title": "Ephemeris Version"
},
"fixed_star_catalog": {
"anyOf": [
{
"$ref": "#/$defs/FixedStarCatalogEnum"
},
{
"type": "string"
}
],
"description": "Fixed star catalog or subset identifier",
"title": "Fixed Star Catalog"
},
"house_system": {
"anyOf": [
{
"$ref": "#/$defs/HouseSystemEnum"
},
{
"type": "string"
}
],
"description": "House system actually used during calculation",
"title": "House System"
},
"include_fixed_stars": {
"anyOf": [
{
"type": "boolean"
}
],
"description": "Whether fixed stars were included",
"title": "Include Fixed Stars"
},
"julian_day": {
"anyOf": [
{
"format": "double",
"type": "number"
}
],
"description": "Julian Day Number representing the calculation instant",
"title": "Julian Day"
},
"lunar_nodes": {
"additionalProperties": {
"type": "object"
},
"description": "How each lunar node and apogee body in this response was computed, keyed by the body's name in the planets block (e.g. \"North Node (True)\"). Each entry carries `method` (`mean` or `true_osculating`) and `algorithm`; the true node also carries `frame` and `matches` (the Swiss Ephemeris equivalent), and a South Node carries `derived_from` and `offset`. Only bodies actually present in the response appear. Authoritative per body: when both nodes are returned, `node_source` alone cannot say which is which.",
"title": "Lunar Nodes",
"type": "object"
},
"missing_objects": {
"anyOf": [
{
"additionalProperties": {
"items": {
"type": "object"
},
"type": "array"
},
"type": "object"
}
],
"description": "Objects that could not be calculated along with reasons",
"title": "Missing Objects"
},
"node_source": {
"anyOf": [
{
"$ref": "#/$defs/NodeSourceEnum"
},
{
"type": "string"
}
],
"description": "Lunar node/apsides mode in effect. Echoes `configuration.node_source` when the request sent one (it also selects the Lilith variant). Otherwise names the nodes the response carries: `mean`, `true_osculating`, or `mean_and_true_osculating` for the default roster, which returns both North Nodes. Omitted when the response carries no lunar node. See `lunar_nodes` for the per-body method.",
"title": "Node Source"
},
"object_set": {
"anyOf": [
{
"$ref": "#/$defs/ObjectSetEnum"
},
{
"type": "string"
}
],
"description": "Named object set or preset powering the calculation",
"title": "Object Set"
},
"orb_system_used": {
"anyOf": [
{
"type": "string"
}
],
"description": "Aspect orb system applied",
"title": "Orb System Used"
},
"precision_level": {
"anyOf": [
{
"type": "string"
}
],
"description": "Legacy precision descriptor",
"title": "Precision Level"
},
"precision_summary": {
"$ref": "#/$defs/PrecisionSummary",
"description": "Structured precision summary aligned with validation results"
},
"processing_time_ms": {
"anyOf": [
{
"type": "number"
}
],
"description": "End-to-end processing time in milliseconds",
"title": "Processing Time Ms"
},
"server_version": {
"description": "Build identifier of the engine that produced this response. Moves on every deploy, so it is the signal for resolution-LOGIC changes — the class of change that can move a historical offset without touching overlay data (and therefore without moving tz_overlay_version). Poll both.",
"title": "Server Version",
"type": "string"
},
"sidereal_time": {
"anyOf": [
{
"type": "number"
}
],
"description": "Local sidereal time in hours",
"title": "Sidereal Time"
},
"technique_id": {
"anyOf": [
{
"type": "string"
}
],
"description": "High-level technique identifier (e.g., natal, synastry, composite, overlay)",
"title": "Technique Id"
},
"technique_label": {
"anyOf": [
{
"type": "string"
}
],
"description": "Human-readable technique label",
"title": "Technique Label"
},
"technique_method": {
"anyOf": [
{
"type": "string"
}
],
"description": "Method name within a technique (e.g., davidson, midpoint)",
"title": "Technique Method"
},
"technique_version": {
"anyOf": [
{
"type": "string"
}
],
"description": "Technique implementation version (for future-proofing)",
"title": "Technique Version"
},
"time_scale": {
"anyOf": [
{
"$ref": "#/$defs/TimeScaleEnum"
},
{
"type": "string"
}
],
"description": "Time scale used for internal calculations (UTC, TT, TDB)",
"title": "Time Scale"
},
"tz_overlay_hash": {
"description": "Content hash of the historical-correction overlay dataset that produced this answer. Stamped only when an overlay row applied (tz_rule_source starts with 'overlay:').",
"title": "Tz Overlay Hash",
"type": "string"
},
"tz_overlay_version": {
"description": "Monotonic version of the historical-correction overlay dataset that produced this answer. Stamped only when an overlay row applied. Tracks overlay DATA only — pair with server_version to also catch resolution-logic changes.",
"title": "Tz Overlay Version",
"type": "integer"
},
"tz_precision": {
"description": "Sourcing grade of the overlay row that produced the offset: 'statutory' (operative text of a session law or statute verified), 'documented' (contemporary reporting), or 'inferred' (deduced from legal context; verify before relying on it near the row's edges). Stamped only when an overlay row applied.",
"enum": [
"statutory",
"documented",
"inferred"
],
"title": "Tz Precision",
"type": "string"
},
"tz_rule_citation": {
"description": "Primary-source citation for the overlay row that produced the offset — statute reference, ICC/agency order number, or documented press/almanac source. Stamped only when an overlay row applied.",
"title": "Tz Rule Citation",
"type": "string"
},
"zodiac_type": {
"anyOf": [
{
"$ref": "#/$defs/ZodiacTypeEnum"
},
{
"type": "string"
}
],
"description": "Zodiac framework applied (tropical/sidereal)",
"title": "Zodiac Type"
}
},
"title": "CalculationMetadata",
"type": "object"
},
"CatalogBodyItem": {
"additionalProperties": false,
"description": "Individual celestial body catalog entry.",
"properties": {
"aliases": {
"description": "Alternative names",
"items": {
"type": "string"
},
"title": "Aliases",
"type": "array"
},
"average_distance_au": {
"anyOf": [
{
"type": "number"
}
],
"description": "Average distance from Sun",
"title": "Average Distance Au"
},
"calculation_accuracy": {
"anyOf": [
{
"type": "string"
}
],
"description": "Calculation accuracy level",
"title": "Calculation Accuracy"
},
"category": {
"description": "Body category (planet, asteroid, etc.)",
"title": "Category",
"type": "string"
},
"diameter_km": {
"anyOf": [
{
"type": "number"
}
],
"description": "Diameter in kilometers",
"title": "Diameter Km"
},
"discoverer": {
"anyOf": [
{
"type": "string"
}
],
"description": "Discoverer name",
"title": "Discoverer"
},
"discovery_date": {
"anyOf": [
{
"format": "date-time",
"type": "string"
}
],
"description": "Discovery date",
"title": "Discovery Date"
},
"ephemeris_available": {
"description": "Can be calculated",
"title": "Ephemeris Available",
"type": "boolean"
},
"id": {
"description": "Canonical identifier for the body (stable). Typically lowercase/underscore, aligned with interpretation/feature-id conventions (e.g., 'sun', 'north_node_mean').",
"title": "Id",
"type": "string"
},
"keywords": {
"description": "Astrological keywords",
"items": {
"type": "string"
},
"title": "Keywords",
"type": "array"
},
"magnitude": {
"anyOf": [
{
"type": "number"
}
],
"description": "Apparent magnitude",
"title": "Magnitude"
},
"mass_kg": {
"anyOf": [
{
"type": "number"
}
],
"description": "Mass in kilograms",
"title": "Mass Kg"
},
"mythology": {
"anyOf": [
{
"type": "string"
}
],
"description": "Mythological associations",
"title": "Mythology"
},
"name": {
"description": "Body name",
"title": "Name",
"type": "string"
},
"orbital_period_days": {
"anyOf": [
{
"type": "number"
}
],
"description": "Orbital period",
"title": "Orbital Period Days"
},
"subcategory": {
"anyOf": [
{
"type": "string"
}
],
"description": "Subcategory",
"title": "Subcategory"
},
"swiss_ephemeris_id": {
"anyOf": [
{
"type": "integer"
}
],
"description": "Optional SE-compatible numeric id when applicable (e.g., 0=Sun). Use this for endpoints that accept numeric planet ids.",
"title": "SE-compatible Body Id"
},
"symbol": {
"anyOf": [
{
"type": "string"
}
],
"description": "Astrological symbol",
"title": "Symbol"
},
"traditional_rulership": {
"anyOf": [
{
"type": "string"
}
],
"description": "Traditional sign rulership",
"title": "Traditional Rulership"
},
"valid_from": {
"description": "First date this body is computed at full precision (YYYY-MM-DD). The planets, nodes and sb441 main-belt asteroids share DE440's 1550-01-01; bodies with their own JPL kernel (centaurs, trans-Neptunian objects, extended asteroids) start later (1600-01-01). Outside valid_from..valid_to the body is refused, not approximated.",
"title": "Valid From",
"type": [
"string",
"null"
]
},
"valid_to": {
"description": "Last date this body is computed at full precision (YYYY-MM-DD). DE440 bodies end 2650-01-22; per-body-kernel bodies end 2200-01-01.",
"title": "Valid To",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"category",
"ephemeris_available"
],
"title": "CatalogBodyItem",
"type": "object"
},
"CoordinateSystemEnum": {
"description": "Coordinate system used for calculations.",
"enum": [
"geocentric",
"topocentric",
"heliocentric",
"barycentric"
],
"title": "CoordinateSystemEnum",
"type": "string"
},
"DeltaTSourceEnum": {
"description": "Source of ΔT values used in calculations.",
"enum": [
"nasa_jpl",
"iers",
"approximation_model"
],
"title": "DeltaTSourceEnum",
"type": "string"
},
"FixedStarCatalogEnum": {
"description": "Fixed star catalog snapshots.",
"enum": [
"bright_mag3",
"bright_mag5",
"royal_stars",
"parans_key"
],
"title": "FixedStarCatalogEnum",
"type": "string"
},
"HouseSystemEnum": {
"description": "Supported house systems.",
"enum": [
"P",
"K",
"O",
"R",
"C",
"E",
"W"
],
"title": "HouseSystemEnum",
"type": "string"
},
"NodeSourceEnum": {
"description": "Node/apsides calculation modes (SE §2.2).",
"enum": [
"true_osculating",
"mean",
"mean_apsides"
],
"title": "NodeSourceEnum",
"type": "string"
},
"ObjectSetEnum": {
"description": "Standardized celestial object bundles.",
"enum": [
"traditional_7",
"modern_10",
"modern_plus_chiron",
"asteroids_major",
"full",
"custom"
],
"title": "ObjectSetEnum",
"type": "string"
},
"PrecisionSummary": {
"additionalProperties": true,
"description": "Structured precision report for calculation metadata.",
"properties": {
"max_position_error_arcseconds": {
"anyOf": [
{
"type": "number"
}
],
"description": "Maximum validated positional error in arcseconds",
"title": "Max Position Error Arcseconds"
},
"max_timing_error_seconds": {
"anyOf": [
{
"type": "number"
}
],
"description": "Maximum validated timing error in seconds",
"title": "Max Timing Error Seconds"
},
"notes": {
"anyOf": [
{
"type": "string"
}
],
"description": "Additional human-readable context for the precision summary",
"title": "Notes"
},
"reference_profile": {
"anyOf": [
{
"type": "string"
}
],
"description": "Reference dataset or validation profile used for the comparison",
"title": "Reference Profile"
}
},
"title": "PrecisionSummary",
"type": "object"
},
"TimeScaleEnum": {
"description": "Time scale used for reporting results.",
"enum": [
"UTC",
"TT",
"TDB"
],
"title": "TimeScaleEnum",
"type": "string"
},
"ZodiacTypeEnum": {
"description": "Supported zodiac frameworks.",
"enum": [
"tropical",
"sidereal"
],
"title": "ZodiacTypeEnum",
"type": "string"
}
}
}
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/openephemeris-com-catalog-bodies-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. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.