{"openapi":"3.1.0","info":{"title":"Orbitex","description":"Deterministic astronomical and Vedic calculation engine powered by NASA/JPL DE440.","version":"1.0.1"},"paths":{"/v1/health":{"get":{"summary":"Health","description":"Verify the service and its calculation layer are operational (plan §5.12).\n\nChecks: DE440 kernel loads and is verified; a calculation succeeds; leap-second and\nEOP data load. No filesystem paths are exposed; failure causes are logged server-side.","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Health Get"}}}}}},"head":{"summary":"Health","description":"Verify the service and its calculation layer are operational (plan §5.12).\n\nChecks: DE440 kernel loads and is verified; a calculation succeeds; leap-second and\nEOP data load. No filesystem paths are exposed; failure causes are logged server-side.","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Health Get"}}}}}}},"/v1/version":{"get":{"summary":"Version","description":"Identify the engine, ephemeris, fingerprint and supported range (plan §5.13).","operationId":"version_v1_version_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Version V1 Version Get"}}}}}}},"/v1/metrics":{"get":{"summary":"Metrics","description":"Operational metrics (plan §5.11). Authenticated; contains no request content.","operationId":"metrics_v1_metrics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Metrics V1 Metrics Get"}}}}}}},"/v1/astronomy/positions":{"post":{"summary":"Positions","operationId":"positions_v1_astronomy_positions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PositionsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chart":{"post":{"summary":"Chart","operationId":"chart_v1_chart_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChartRequestIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/panchanga":{"post":{"summary":"Panchanga Endpoint","operationId":"panchanga_endpoint_v1_panchanga_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PanchangaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vargas":{"post":{"summary":"Vargas Endpoint","operationId":"vargas_endpoint_v1_vargas_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VargasRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dasha":{"post":{"summary":"Dasha Endpoint","operationId":"dasha_endpoint_v1_dasha_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DashaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ChartRequestIn":{"properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","title":"Date"},"time":{"type":"string","pattern":"^\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?$","title":"Time"},"timezone":{"type":"string","maxLength":64,"minLength":1,"title":"Timezone"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":360.0,"minimum":-180.0,"title":"Longitude"},"elevation_m":{"type":"number","maximum":9000.0,"minimum":-500.0,"title":"Elevation M","default":0.0},"ayanamsha":{"type":"string","maxLength":32,"title":"Ayanamsha","default":"LAHIRI"},"node_type":{"type":"string","maxLength":16,"title":"Node Type","default":"TRUE"},"house_system":{"type":"string","maxLength":32,"title":"House System","default":"WHOLE_SIGN"},"vargas":{"items":{"type":"string"},"type":"array","maxItems":16,"minItems":1,"title":"Vargas","default":["D1","D2","D3","D4","D7","D9","D10","D12","D16","D20","D24","D27","D30","D40","D45","D60"]},"dasha_levels":{"type":"integer","maximum":3.0,"minimum":1.0,"title":"Dasha Levels","default":3},"include_outer_planets":{"type":"boolean","title":"Include Outer Planets","default":true},"topocentric_planets":{"type":"boolean","title":"Topocentric Planets","default":false},"sunrise_convention":{"type":"string","maxLength":32,"title":"Sunrise Convention","default":"UPPER_LIMB_REFRACTED"},"with_panchanga_transitions":{"type":"boolean","title":"With Panchanga Transitions","default":true}},"additionalProperties":false,"type":"object","required":["date","time","timezone","latitude","longitude"],"title":"ChartRequestIn"},"DashaRequest":{"properties":{"birth":{"$ref":"#/components/schemas/TimeIn"},"ayanamsha":{"type":"string","maxLength":32,"title":"Ayanamsha","default":"LAHIRI"},"levels":{"type":"integer","maximum":3.0,"minimum":1.0,"title":"Levels","default":3},"at":{"anyOf":[{"$ref":"#/components/schemas/TimeIn"},{"type":"null"}],"description":"if given, the active periods at this instant are returned"}},"additionalProperties":false,"type":"object","required":["birth"],"title":"DashaRequest"},"Envelope":{"properties":{"result":{"additionalProperties":true,"type":"object","title":"Result"},"provenance":{"additionalProperties":true,"type":"object","title":"Provenance"},"request_id":{"type":"string","title":"Request Id"},"cached":{"type":"boolean","title":"Cached"}},"type":"object","required":["result","provenance","request_id","cached"],"title":"Envelope"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ObserverIn":{"properties":{"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"geodetic degrees, north positive"},"longitude":{"type":"number","maximum":360.0,"minimum":-180.0,"title":"Longitude","description":"degrees, EAST positive"},"elevation_m":{"type":"number","maximum":9000.0,"minimum":-500.0,"title":"Elevation M","default":0.0}},"additionalProperties":false,"type":"object","required":["latitude","longitude"],"title":"ObserverIn"},"PanchangaRequest":{"properties":{"time":{"$ref":"#/components/schemas/TimeIn"},"observer":{"$ref":"#/components/schemas/ObserverIn"},"timezone":{"type":"string","maxLength":64,"minLength":1,"title":"Timezone","description":"IANA zone defining the local day"},"ayanamsha":{"type":"string","maxLength":32,"title":"Ayanamsha","default":"LAHIRI"},"sunrise_convention":{"type":"string","maxLength":32,"title":"Sunrise Convention","default":"UPPER_LIMB_REFRACTED"},"with_transitions":{"type":"boolean","title":"With Transitions","default":true}},"additionalProperties":false,"type":"object","required":["time","observer","timezone"],"title":"PanchangaRequest"},"PositionsRequest":{"properties":{"time":{"$ref":"#/components/schemas/TimeIn"},"bodies":{"items":{"type":"string","enum":["SUN","MOON","MERCURY","VENUS","EARTH","MARS","JUPITER","SATURN","URANUS","NEPTUNE","PLUTO"]},"type":"array","maxItems":11,"minItems":1,"title":"Bodies","default":["SUN","MOON","MERCURY","VENUS","MARS","JUPITER","SATURN","URANUS","NEPTUNE","PLUTO"]},"coordinate_mode":{"type":"string","maxLength":32,"title":"Coordinate Mode","default":"GEOCENTRIC_APPARENT"},"frame":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Frame"},"observer":{"anyOf":[{"$ref":"#/components/schemas/ObserverIn"},{"type":"null"}]},"model":{"type":"string","maxLength":32,"title":"Model","default":"IAU2006_2000A"},"with_speed":{"type":"boolean","title":"With Speed","default":true}},"additionalProperties":false,"type":"object","required":["time"],"title":"PositionsRequest"},"TimeIn":{"properties":{"date":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"title":"Date"},"time":{"anyOf":[{"type":"string","pattern":"^\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?$"},{"type":"null"}],"title":"Time"},"timezone":{"anyOf":[{"type":"string","maxLength":64,"minLength":1},{"type":"null"}],"title":"Timezone"},"datetime":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?(Z|[+-]\\d{2}:?\\d{2})$"},{"type":"null"}],"title":"Datetime"}},"additionalProperties":false,"type":"object","title":"TimeIn","description":"Either civil (date + time + IANA timezone) or a UTC/offset ISO 8601 `datetime`."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VargasRequest":{"properties":{"time":{"$ref":"#/components/schemas/TimeIn"},"observer":{"anyOf":[{"$ref":"#/components/schemas/ObserverIn"},{"type":"null"}],"description":"if given, the Lagna's vargas are included"},"ayanamsha":{"type":"string","maxLength":32,"title":"Ayanamsha","default":"LAHIRI"},"node_type":{"type":"string","maxLength":16,"title":"Node Type","default":"TRUE"},"bodies":{"items":{"type":"string","enum":["SUN","MOON","MERCURY","VENUS","MARS","JUPITER","SATURN","RAHU","KETU","URANUS","NEPTUNE","PLUTO"]},"type":"array","maxItems":12,"minItems":1,"title":"Bodies","default":["SUN","MOON","MERCURY","VENUS","MARS","JUPITER","SATURN","RAHU","KETU"]},"vargas":{"items":{"type":"string"},"type":"array","maxItems":16,"minItems":1,"title":"Vargas","default":["D1","D9"]}},"additionalProperties":false,"type":"object","required":["time"],"title":"VargasRequest"}}}}