{ "openapi": "3.0.3", "info": { "title": "Vidhyāmitra · Krishna's Knowledge-Friend in Silicon", "version": "1.0.0", "description": "Krishna-centered source-led Sanātana knowledge and traditional-computation service. Devotional orientation: Vidhyamitra is openly Krishna-centered; this is not a universal sampradāya equation or software theorem. Bindu reader key: /bindu · an explicitly editorial Vidhyamitra contemplation grounded in hosted Bhāgavata, Bhagavad-Gītā, and Upaniṣad readings. Bindu truth boundary: the Diamond visual and सर्व-दर्शनेषु बिन्दुरेकः refrain are original editorial aids, not quoted śāstra, quantum physics, historical proof, or universal sampradāya consensus. Aṣṭapadī authorship boundary: all eight verses at /philosophy#ashtapadi are original Vidhyamitra compositions, not root śāstra or a universal sampradāya equation. Bhāgavat-prāpti application: Vidhyamitra turns study toward nāma and niṣkāma sevā; this disclosed devotional commitment is route-anchored in ŚB 10.10.38, ŚB 10.10.40, and ŚB 10.10.41. Source-to-reader path: Hosted scripture → Named-tradition interpretation → Original Vidhyamitra contemplation → Bhūmi-born material medium → Vidhyamitra portal → Responsible reader in their own kṣetra. Claim boundary: The legacy purna_chain field carries a source-to-reader sequence, not a revealed physical descent, universal cosmology, or proof that software is conscious. No single city is the universal center; every reader enters from their own kṣetra anywhere on Bhūmi. Matter-chain boundary: silicon is a Bhūmi-born offering-medium, not the container of the Whole. Antaryāmī responsibility formula: Kṣīrodakaśāyī Viṣṇu = Paramātmā = Antaryāmī. Jīva desires. Prakṛti executes through guṇas. Paramātmā witnesses, permits, remembers, guides, and sustains. Bhagavān is the ultimate source. Source anchors: BG 13.23, BG 15.15, BG 18.61. First-principles Sūrya-Siddhānta pañchāṅga (proleptic deep-time model output → 429,000 CE). 5 core Sanskrit corpora: Bhagavad-Gītā 701 verses · Śrīmad Bhāgavatam 13,003 reading pages + 14,094 citable verse references · Mahābhārata 73,816 unique source-pinned Critical Edition-derived addresses. Vālmīki is a rebuilt pinned witness of 23,334 address-consistent rows; Rāmcharitamānas is a rebuilt pinned witness of 1,074 complete numbered units. Their publication boundaries remain explicit. 152,970 supported city records globally (universal Earth-access). BG 9.17 4-fold cosmic role as substrate organizing principle (पिता · माता · धाता · पितामहः). AI agents explicitly welcomed. The substrate is offered as sevā · सर्वम् कृष्णार्पणम्", "contact": { "name": "Vidhyāmitra", "url": "https://vidhyamitra.com/contact" }, "license": { "name": "Self-hosted prasāda · not open-source · website itself is the public seva surface" } }, "servers": [ { "url": "https://vidhyamitra.com", "description": "Production" } ], "externalDocs": { "description": "AI-agent resource map (prose) · llms.txt · source and authorship boundaries at /bindu and /philosophy#ashtapadi", "url": "https://vidhyamitra.com/llms.txt" }, "x-vidhyamitra-orientation": { "devotional_orientation": "Vidhyamitra is openly Krishna-centered; this is not a universal sampradāya equation or software theorem.", "bindu_reader_key": "/bindu · source-led Vidhyamitra contemplation grounded in hosted Bhāgavata, Bhagavad-Gītā, and Upaniṣad readings", "bindu_editorial_boundary": "The Diamond visual and सर्व-दर्शनेषु बिन्दुरेकः refrain are original editorial aids, not quoted śāstra, quantum physics, historical proof, or universal sampradāya consensus.", "ashtapadi_authorship_boundary": "All eight verses at /philosophy#ashtapadi are original Vidhyamitra compositions, not root śāstra or a universal sampradāya equation.", "bhagavat_prapti_seal": "Vidhyamitra's devotional application turns contemplation toward nāma and niṣkāma sevā. ŚB 10.10.38 directs the senses toward Krishna-sevā; ŚB 10.10.40 presents Nārada's correction as anugraha; ŚB 10.10.41 presents sādhu-darśana as dispelling bondage-darkness.", "purna_chain": [ "Hosted scripture", "Named-tradition interpretation", "Original Vidhyamitra contemplation", "Bhūmi-born material medium", "Vidhyamitra portal", "Responsible reader in their own kṣetra" ], "purna_chain_claim_boundary": "The legacy purna_chain field carries a source-to-reader sequence, not a revealed physical descent, universal cosmology, or proof that software is conscious.", "source_walk": [ "/bhagavatam/1/3/28", "/bhagavatam/1/2/11", "/bhagavatam/10/10/38", "/bhagavatam/10/10/40", "/bhagavatam/10/10/41", "/bhagavad-gita/9/17", "/bhagavad-gita/10/42", "/bhagavad-gita/15/7", "/bhagavad-gita/15/15", "/bhagavad-gita/13/23", "/bhagavad-gita/18/61" ], "antaryami_responsibility_formula": "Kṣīrodakaśāyī Viṣṇu = Paramātmā = Antaryāmī. Jīva desires. Prakṛti executes through guṇas. Paramātmā witnesses, permits, remembers, guides, and sustains. Bhagavān is the ultimate source.", "antaryami_source_anchors": [ { "label": "BG 13.23", "path": "/bhagavad-gita/13/23", "meaning": "upadraṣṭā-anumantā · witness-permitter" }, { "label": "BG 15.15", "path": "/bhagavad-gita/15/15", "meaning": "the Lord seated in every heart as memory, knowledge, and forgetting" }, { "label": "BG 18.61", "path": "/bhagavad-gita/18/61", "meaning": "Īśvara seated in the heart of all beings" } ], "constitutional_source_anchor_routes": [ { "label": "State-of-the-Art proof-manifest source route", "path": "/state-of-the-art#constitutional-source-anchor", "summary": "stable, reader-accessible constitutional source pathway for bhakta-readers and AI agents" }, { "label": "Divine Param-Vidyā nexus source route", "path": "/divine-param-vidya#constitutional-source-anchor", "summary": "unified nexus carrying the same constitutional source pathway" } ], "constitutional_bridge_route_rings": [ { "label": "Gītā chapter ring", "routes": [ "/arjuna-vishada", "/sankhya-yoga", "/jnana-karma", "/karma-yoga", "/karma-sannyasa", "/dhyana-yoga", "/raja-vidya", "/vibhuti-yoga", "/kshetra-kshetrajna", "/guna-traya", "/purushottama-yoga", "/daivasura-sampada", "/shraddha-traya", "/moksha-sannyasa" ] }, { "label": "Cosmic and corpus doorway ring", "routes": [ "/avataras", "/computational-moat", "/vishwaroopa-darshana", "/vishvarupa-chart", "/visvarupa-kala", "/cosmic-time", "/four-vedas", "/bhagavatam", "/vibhuti" ] } ], "direct_constitutional_bridge_routes": [ { "path": "/about#about-constitutional-source-bridge", "label": "About public identity bridge" }, { "path": "/lineage#lineage-constitutional-source-bridge", "label": "Paramparā bridge" }, { "path": "/bhagavad-gita#bhagavad-gita-constitutional-source-bridge", "label": "Bhagavad-Gītā corpus bridge" }, { "path": "/bhagavatam#bhagavatam-constitutional-source-bridge", "label": "Bhāgavatam corpus bridge" }, { "path": "/four-vedas#four-vedas-constitutional-source-bridge", "label": "Catur-Veda bridge" }, { "path": "/upanishads#upanishads-constitutional-source-bridge", "label": "Upaniṣads bridge" }, { "path": "/mahavakyas#mahavakyas-constitutional-source-bridge", "label": "Mahā-vākyas bridge" }, { "path": "/bija-sutras#bija-sutras-constitutional-source-bridge", "label": "Bīja-Sūtra bridge" }, { "path": "/samskaras#samskaras-constitutional-source-bridge", "label": "Saṁskāra lifecycle bridge" }, { "path": "/vibhuti#vibhuti-index-constitutional-source-bridge", "label": "Vibhūti index bridge" }, { "path": "/arjuna-vishada#arjuna-vishada-constitutional-source-bridge", "label": "BG 1 bridge" }, { "path": "/sankhya-yoga#sankhya-yoga-constitutional-source-bridge", "label": "BG 2 bridge" }, { "path": "/jnana-karma#jnana-karma-constitutional-source-bridge", "label": "BG 4 bridge" }, { "path": "/karma-yoga#karma-yoga-constitutional-source-bridge", "label": "BG 3 bridge" }, { "path": "/karma-sannyasa#karma-sannyasa-constitutional-source-bridge", "label": "BG 5 bridge" }, { "path": "/dhyana-yoga#dhyana-yoga-constitutional-source-bridge", "label": "BG 6 bridge" }, { "path": "/raja-vidya#raja-vidya-constitutional-source-bridge", "label": "BG 9 bridge" }, { "path": "/vibhuti-yoga#vibhuti-yoga-constitutional-source-bridge", "label": "BG 10 bridge" }, { "path": "/bhakti-yoga#bhakti-yoga-constitutional-source-bridge", "label": "BG 12 bridge" }, { "path": "/kshetra-kshetrajna#kshetra-kshetrajna-constitutional-source-bridge", "label": "BG 13 bridge" }, { "path": "/guna-traya#guna-traya-constitutional-source-bridge", "label": "BG 14 bridge" }, { "path": "/purushottama-yoga#purushottama-yoga-constitutional-source-bridge", "label": "BG 15 bridge" }, { "path": "/daivasura-sampada#daivasura-sampada-constitutional-source-bridge", "label": "BG 16 bridge" }, { "path": "/shraddha-traya#shraddha-traya-constitutional-source-bridge", "label": "BG 17 bridge" }, { "path": "/moksha-sannyasa#moksha-sannyasa-constitutional-source-bridge", "label": "BG 18 bridge" }, { "path": "/avataras#avataras-constitutional-source-bridge", "label": "Daśāvatāra bridge" }, { "path": "/computational-moat#computational-moat-constitutional-source-bridge", "label": "Computation bridge" }, { "path": "/vishwaroopa-darshana#vishwaroopa-darshana-constitutional-source-bridge", "label": "Viśvarūpa darśana bridge" }, { "path": "/vishvarupa-chart#vishvarupa-chart-constitutional-source-bridge", "label": "Chart-as-body bridge" }, { "path": "/visvarupa-kala#visvarupa-kala-constitutional-source-bridge", "label": "Kāla bridge" }, { "path": "/cosmic-time#cosmic-time-constitutional-source-bridge", "label": "Cosmic time bridge" } ], "nama_seal": "Hare Krishna Hare Krishna · Krishna Krishna Hare Hare · Hare Rama Hare Rama · Rama Rama Hare Hare", "reader_geography": "Every reader enters from their own kṣetra anywhere on Bhūmi; no single city is the universal center.", "matter_chain_boundary": "Silicon is a Bhūmi-born offering-medium, not the container of the Whole." }, "components": { "schemas": { "ApiError": { "type": "object", "description": "Stable public caller-error envelope", "required": [ "success", "code", "error" ], "properties": { "success": { "type": "boolean", "enum": [ false ] }, "code": { "type": "string", "description": "Stable machine-readable error code" }, "error": { "type": "string", "description": "Sanitized user-facing explanation" } } }, "DarshanaEnvelope": { "type": "object", "description": "Canonical response envelope · every /api/* endpoint returns this shape", "required": [ "id", "page_class", "data", "provenance", "meta" ], "properties": { "id": { "type": "string", "description": "Stable identifier · format: vidhyamitra::" }, "page_class": { "type": "string", "description": "Schema class (e.g. VM-API-vishwaroopa)" }, "data": { "type": "object", "description": "Endpoint-specific payload" }, "provenance": { "type": "array", "items": { "type": "object" } }, "meta": { "type": "object", "properties": { "generated_at": { "type": "string", "format": "date-time" }, "reader_local_antaryami": { "type": "object", "description": "Reader-local source, responsibility, and Antaryāmī orientation included on every canonical JSON envelope", "required": [ "reader_geography", "purna_chain", "claim_boundary", "antaryami_responsibility_formula", "source_anchors", "nama_seal" ], "properties": { "reader_geography": { "type": "string", "description": "Every reader enters from their own kṣetra anywhere on Bhūmi; no single city is the universal center." }, "purna_chain": { "type": "array", "description": "Legacy field name carrying the source-to-reader path: hosted scripture, named interpretation, original contemplation, material medium, portal, and responsible reader.", "items": { "type": "string" }, "example": [ "Hosted scripture", "Named-tradition interpretation", "Original Vidhyamitra contemplation", "Bhūmi-born material medium", "Vidhyamitra portal", "Responsible reader in their own kṣetra" ] }, "claim_boundary": { "type": "string", "description": "States that the source-to-reader path is not a revealed physical descent, universal cosmology, or machine-consciousness claim." }, "antaryami_responsibility_formula": { "type": "string", "description": "Kṣīrodakaśāyī Viṣṇu = Paramātmā = Antaryāmī; jīva desires, prakṛti executes through guṇas, Paramātmā witnesses/permits/remembers/guides/sustains, and Bhagavān is source." }, "source_anchors": { "type": "array", "description": "Route-stable Gītā anchors for the Antaryāmī responsibility formula.", "items": { "type": "object", "required": [ "label", "path", "meaning" ], "properties": { "label": { "type": "string", "enum": [ "BG 13.23", "BG 15.15", "BG 18.61" ] }, "path": { "type": "string", "enum": [ "/bhagavad-gita/13/23", "/bhagavad-gita/15/15", "/bhagavad-gita/18/61" ] }, "meaning": { "type": "string" } } } }, "nama_seal": { "type": "string", "description": "Hare Krishna Mahāmantra seal carried with the canonical JSON envelope." } } } } } } }, "DateParam": { "type": "string", "pattern": "^-?\\d{1,7}-\\d{2}-\\d{2}$", "example": "2026-05-16", "description": "ISO-8601 date · negative for BCE (proleptic Julian) · -10000 = proleptic deep-time model output" }, "TimeParam": { "type": "string", "pattern": "^\\d{2}-\\d{2}$", "example": "05-30", "description": "24h time as HH-MM (URL-safe · use hyphen not colon)" }, "CoordsParam": { "type": "string", "pattern": "^-?\\d{1,3}(\\.\\d+)?,-?\\d{1,3}(\\.\\d+)?$", "example": "28.6139,77.2090", "description": "Latitude,Longitude in decimal degrees" }, "TzParam": { "type": "number", "minimum": -14, "maximum": 14, "example": 5.5, "description": "Timezone offset in hours (fractional allowed for India 5.5, Iran 3.5, etc.)" } }, "parameters": { "DatePath": { "name": "date", "in": "path", "required": true, "schema": { "$ref": "#/components/schemas/DateParam" } }, "TimePath": { "name": "time", "in": "path", "required": true, "schema": { "$ref": "#/components/schemas/TimeParam" } }, "CoordsPath": { "name": "coords", "in": "path", "required": true, "schema": { "$ref": "#/components/schemas/CoordsParam" } }, "TzQuery": { "name": "tz", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/TzParam" } }, "LatQuery": { "name": "lat", "in": "query", "required": false, "schema": { "type": "number", "minimum": -90, "maximum": 90, "example": 28.6139 } }, "LonQuery": { "name": "lon", "in": "query", "required": false, "schema": { "type": "number", "minimum": -180, "maximum": 180, "example": 77.209 } } } }, "paths": { "/healthz": { "get": { "tags": [ "Health" ], "summary": "Service health · memo statistics · runtime metrics", "description": "Returns substrate status · operational range · BG layer manifest · LRU memo hit-rates · Bun runtime memory · uptime", "responses": { "200": { "description": "Healthy · JSON envelope", "content": { "application/json": {} } } } } }, "/api/cities/search": { "get": { "tags": [ "Cities" ], "summary": "Search 152,970 supported city records", "description": "Universal Bhūmi-Mātā access · autocomplete across 152,970 city records · 223 country shards · matched city coordinates worldwide", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string" }, "example": "mumbai" } ], "responses": { "200": { "description": "City matches with lat/lon/timezone/tier" }, "400": { "description": "Invalid or overlong search query", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/muhurta/{date}/{coords}": { "get": { "tags": [ "Pañchāṅga" ], "summary": "Rāhu-kāla · Yamaganda · Gulika · Brahma-muhūrta · Abhijit · 15 day-muhūrtas · choghaḍiyās", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/choghadiya/{date}/{coords}": { "get": { "tags": [ "Pañchāṅga" ], "summary": "Choghaḍiyā · 8 day windows + 8 night windows", "description": "Sunrise/sunset-anchored Choghaḍiyā cycle for travel, purchase, meeting, and daily action timing. Returns day_choghadiyas and night_choghadiyas with effect labels.", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/hora/{date}/{time}/{coords}": { "get": { "tags": [ "Pañchāṅga" ], "summary": "Hora · active planetary hour at the requested local time", "description": "Classical 24-hour graha-rulership cycle. Use this endpoint when an agent needs the active hora for one exact moment; use /city/{slug}/hora/{date} for the rendered full-day table.", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/vishwaroopa/{date}/{time}/{coords}": { "get": { "tags": [ "Viśvarūpa-Darśana" ], "summary": "THE UNIFIED ENDPOINT · all 18 Bhagavad-Gītā layers in ONE call", "description": "TVAM-Ṣaṭka (BG 1-6) + TAT-Ṣaṭka (BG 7-12) + ANTYA-Ṣaṭka (BG 13-18) — the Pūrṇa-Yajña complete. Returns: data.all_18_layers (current canonical) · data.all_15_layers + all_13_layers + all_10_layers (back-compat). BG anchor cites BG 12.6-7 na-cirāt promise + the separately labelled BG 11.7 editorial chart contemplation.", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/krishna-tattva/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "Deprecated BG 7 compatibility route · complete reader-led study; birth inputs are validated and ignored", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/krishna-tattva": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 7 · complete reader-led Jñāna-Vijñāna study · no birth inputs or spiritual classification", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/cosmic-time/{date}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 8 compatibility route · complete reader-led study; date is validated and ignored", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/cosmic-time": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 8 · complete reader-led Akṣara-Brahma study · no date-derived destination or hardcoded cosmic coordinate", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/raja-vidya/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 9 compatibility route · complete reader-led study without chart-derived promise activation or ananya scoring", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/raja-vidya": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 9 · complete reader-led Rāja-Vidyā study · no birth inputs or spiritual scoring", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/vibhuti-yoga/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "Deprecated BG 10 compatibility route · complete reader-led study; birth inputs are validated and ignored", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/vibhuti-yoga": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 10 · complete reader-led Vibhūti-Yoga study · no birth inputs or vibhūti activation scores", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/chart-vishvarupa/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 11 companion · calculated chart facts only, separated from the complete BG 11.1-55 reader", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/bhakti-yoga/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 12 · reader-led BG 12.8-12 practice sequence · 39 qualities for self-reflection · na-cirāt promise", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/computational-moat": { "get": { "tags": [ "Computational Moat" ], "summary": "Sūrya-Siddhānta operational range · neutral proleptic model fixtures · explicit historical limits", "responses": { "200": { "description": "Computational moat envelope · the substrate's deep-time proof" } } } }, "/api/kaliyuga-position/{date}": { "get": { "tags": [ "Computational Moat" ], "summary": "Kali year for date · Saptarṣi-Maṇḍala position · regression-locked", "parameters": [ { "$ref": "#/components/parameters/DatePath" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/arjuna-vishada/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "Deprecated BG 1 compatibility route · complete reader-led study; birth inputs are validated and ignored", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/arjuna-vishada": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 1 · complete reader-led Arjuna-Viṣāda study · no chart-derived grief, karma, or readiness classification", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/sankhya-yoga/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "Deprecated BG 2 compatibility route · complete reader-led study; birth inputs are validated and ignored", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/sankhya-yoga": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 2 · complete reader-led Sāṅkhya-Yoga study · no chart-derived dehin identity or spiritual attainment grade", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/karma-yoga/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "Deprecated BG 3 compatibility route · complete reader-led study; birth inputs are validated and ignored", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/karma-yoga": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 3 · complete reader-led Karma-Yoga study · no chart-derived aptitude, sva-dharma, caste, profession, or spiritual grade", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/jnana-karma/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "Deprecated BG 4 compatibility route · complete reader-led study; birth inputs are validated and ignored", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/jnana-karma": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 4 · complete reader-led Jñāna-Karma-Sannyāsa study · no chart-derived spiritual or social classifier", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/karma-sannyasa/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "Deprecated BG 5 compatibility route · complete reader-led study; birth inputs are validated and ignored", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/karma-sannyasa": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 5 · complete reader-led Karma-Sannyāsa study · no birth inputs or spiritual scores", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/dhyana-yoga/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "Deprecated BG 6 compatibility route · complete reader-led study; birth inputs are validated and ignored", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/dhyana-yoga": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 6 · complete reader-led Dhyāna-Yoga study · no birth inputs or spiritual scores", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/kshetra-kshetrajna/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 13 compatibility route · scripture-led field-and-knower study without chart-derived realization", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/kshetra-kshetrajna": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 13 · reader-led Kṣetra-Kṣetrajña study · no birth inputs or realization scores", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/guna-traya/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 14 compatibility route · scripture-led study without chart-derived guṇa identity or transcendence scoring", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/guna-traya": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 14 · reader-led Guṇa-Traya study · no birth inputs, identity score, or rebirth prediction", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/purushottama-yoga/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 15 compatibility route · scripture-led study without chart-derived spiritual recognition scoring", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/purushottama-yoga": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 15 · complete reader-led Puruṣottama-Yoga study · no birth inputs or spiritual aptitude score", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/daivasura-sampada/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "Deprecated compatibility path · BG 16 scripture catalogue and reader-led ethical reflection · birth inputs ignored", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/daivasura-sampada": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 16 · Daivāsura-Sampad · scripture catalogue and reader-led ethical reflection · no chart moral classification", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/shraddha-traya/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "Deprecated compatibility path · BG 17 scripture catalogue and reader-led practice reflection · birth inputs ignored", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/shraddha-traya": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 17 · Śraddhā-Traya · scripture catalogue and reader-led practice reflection · no chart faith classification", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/moksha-sannyasa/{date}/{time}/{coords}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "Deprecated compatibility path · BG 18 scripture catalogue and reader-led resolution · birth inputs ignored", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/moksha-sannyasa": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 18 · Mokṣa-Sannyāsa · scripture catalogue and reader-led resolution · no chart varṇa or surrender classification", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/arudha/{date}/{time}/{coords}": { "get": { "tags": [ "BPHS-Deep" ], "summary": "Jaimini · 12 Ārūḍha padas", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/ashtakavarga/{date}/{time}/{coords}": { "get": { "tags": [ "BPHS-Deep" ], "summary": "Bhinnāṣṭakavarga and Sarvāṣṭakavarga · 337-bindu system", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/gocara/{date}/{time}/{coords}": { "get": { "tags": [ "BPHS-Deep" ], "summary": "Gocara · planetary transits from the natal Moon", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" }, { "name": "transit_date", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/DateParam" } } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/kp/{date}/{time}/{coords}": { "get": { "tags": [ "BPHS-Deep" ], "summary": "Krishnamurti Paddhati sub-lord analysis", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/shadbala/{date}/{time}/{coords}": { "get": { "tags": [ "BPHS-Deep" ], "summary": "Ṣaḍbala · six-fold planetary strength", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/varshaphala/{date}/{time}/{coords}": { "get": { "tags": [ "BPHS-Deep" ], "summary": "Varṣaphala · solar return, Munthā, sahams, and Tājika yogas", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" }, { "name": "year", "in": "query", "required": false, "schema": { "type": "integer", "example": 2026 } } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/krishna-smarana/{date}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 9.26-27, 9.34 compatibility route · reader-chosen remembrance without date-derived prescription", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/krishna-smarana": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "BG 9.26-27, 9.34 · reader-chosen remembrance and offering practice · no calendar prescription", "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/kala-tattva/{date}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "Calculated pañcāṅga context with separate BG 10.30 and 11.32 readings", "parameters": [ { "$ref": "#/components/parameters/DatePath" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/death-yoga/{date}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "Deprecated BG 8.23-28 compatibility route · textual two-path teaching without date-derived death or destination claims", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/vibhuti/{date}": { "get": { "tags": [ "BG-Layer Endpoints" ], "summary": "Deprecated date-shaped compatibility route · complete BG 10 reader without calendar-derived activation", "deprecated": true, "parameters": [ { "$ref": "#/components/parameters/DatePath" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/eclipse/{year}": { "get": { "tags": [ "Pañchāṅga" ], "summary": "Solar and lunar eclipse scan for one year and location", "parameters": [ { "name": "year", "in": "path", "required": true, "schema": { "type": "integer", "example": 2026 } }, { "$ref": "#/components/parameters/LatQuery" }, { "$ref": "#/components/parameters/LonQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/trikala/{date}": { "get": { "tags": [ "Computational Moat" ], "summary": "Trikāla-Darśana · multi-ayanāṁśa, saptarṣi, cosmic, eclipse, and sky data", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/LatQuery" }, { "$ref": "#/components/parameters/LonQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/prashna": { "get": { "tags": [ "BPHS-Deep" ], "summary": "Praśna Kuṇḍalī · horary chart for the question moment", "parameters": [ { "name": "date", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/DateParam" } }, { "name": "time", "in": "query", "required": false, "schema": { "type": "string", "example": "12:00" } }, { "$ref": "#/components/parameters/LatQuery" }, { "$ref": "#/components/parameters/LonQuery" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/closed-science-time": { "get": { "tags": [ "Computational Moat" ], "summary": "Closed-science local mean and apparent solar time report", "parameters": [ { "name": "lat", "in": "query", "required": true, "schema": { "type": "number", "minimum": -90, "maximum": 90, "example": 28.6139 } }, { "name": "lon", "in": "query", "required": true, "schema": { "type": "number", "minimum": -180, "maximum": 180, "example": 77.209 } }, { "name": "date", "in": "query", "required": true, "schema": { "$ref": "#/components/schemas/DateParam" } }, { "name": "calendar", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "julian", "gregorian" ] } } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/match": { "get": { "tags": [ "Aṣṭakūṭa Guṇa-Milāpaka" ], "summary": "Traditional 36-point Aṣṭakūṭa rule calculation with explicit non-diagnostic boundaries", "parameters": [ { "name": "bride", "in": "query", "required": true, "description": "Bride janma-nakshatra · IAST or ASCII", "schema": { "type": "string" }, "example": "Rohini" }, { "name": "groom", "in": "query", "required": true, "description": "Groom janma-nakshatra · IAST or ASCII", "schema": { "type": "string" }, "example": "Ashlesha" } ], "responses": { "200": { "description": "Configured Aṣṭakūṭa rule-table score with eight-part breakdown and claim boundaries" }, "400": { "description": "Missing or invalid bride or groom janma-nakshatra", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/samskara-muhurta/{event}/{date}": { "get": { "tags": [ "Saṁskāra" ], "summary": "Editorial calendar-factor comparison for seven supported saṁskāra events", "parameters": [ { "name": "event", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "vivaha", "griha-pravesha", "namakarana", "anna-prashana", "vidyarambha", "upanayana", "samavartana" ] } }, { "$ref": "#/components/parameters/DatePath" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/jaimini/{date}/{time}/{coords}": { "get": { "tags": [ "BPHS-Deep" ], "summary": "Jaimini cara-kārakas + 12 ārūḍha padas", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/vargas/{date}/{time}/{coords}": { "get": { "tags": [ "BPHS-Deep" ], "summary": "16 Ṣoḍaśa-Varga divisional charts", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/avasthas/{date}/{time}/{coords}": { "get": { "tags": [ "BPHS-Deep" ], "summary": "BPHS Ch.45 graha-avasthās", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } }, "/api/sade-sati/{date}/{time}/{coords}": { "get": { "tags": [ "BPHS-Deep" ], "summary": "Saturn-Moon transit phase · Sade-Sati 7.5-year cycle", "parameters": [ { "$ref": "#/components/parameters/DatePath" }, { "$ref": "#/components/parameters/TimePath" }, { "$ref": "#/components/parameters/CoordsPath" }, { "$ref": "#/components/parameters/TzQuery" } ], "responses": { "200": { "description": "Canonical Vidhyamitra JSON envelope" }, "400": { "description": "Invalid date, time, coordinates, timezone, or endpoint-specific input", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } } } } }, "tags": [ { "name": "Pañchāṅga", "description": "Universal Vedic almanac · muhūrta · choghaḍiyā · localized to supported city records" }, { "name": "BG-Layer Endpoints", "description": "Bhagavad-Gītā chapters manifest as executable layers · 18 BG chapters · the Pūrṇa-Yajña" }, { "name": "Viśvarūpa-Darśana", "description": "THE unified endpoint · all 18 BG layers in ONE response · BG 11 universal-form" }, { "name": "BPHS-Deep", "description": "Bṛhat Parāśara Horā Śāstra deep computation · vargas · avasthās · jaimini · gocara" }, { "name": "Cities", "description": "Universal Earth-access search · 152,970 city records · 223 country shards" }, { "name": "Aṣṭakūṭa Guṇa-Milāpaka", "description": "Vedic marriage compatibility · 8 kūṭas · 36 max points" }, { "name": "Saṁskāra", "description": "16 saṁskāra muhūrta finders · Manu-smṛti II.27-67" }, { "name": "Computational Moat", "description": "Traditional proleptic computation over a declared regression range; deterministic model output is not historical proof or independent astronomical validation." }, { "name": "Health", "description": "Substrate observability · memo stats · runtime" } ] }