Jyotish — Vedic astrology for AI agents

Deterministic Vedic chart facts for birth data: lagna, Moon sign/nakshatra, current dasha, planets in houses, house lords, dignities, combustions, D9/D10 ascendants, Sade Sati standing, yogas with classical-text citations, dasha timeline. Pure computation, no LLM. Same output as POST /api/b2b/chart-facts.

{
  "type": "object",
  "properties": {
    "dob": {
      "type": "string",
      "description": "Birth date, YYYY-MM-DD."
    },
    "tob": {
      "type": "string",
      "description": "Birth time, HH:MM (24h)."
    },
    "lat": {
      "type": "number",
      "description": "Birth latitude, -90 to 90."
    },
    "lng": {
      "type": "number",
      "description": "Birth longitude, -180 to 180."
    },
    "tz": {
      "type": [
        "number",
        "string"
      ],
      "description": "UTC offset (e.g. 5.5) or IANA zone name (e.g. Asia/Kolkata)."
    }
  },
  "required": [
    "dob",
    "tob",
    "lat",
    "lng",
    "tz"
  ]
}

Grounded synthesis answer to a question, computed from the birth chart through the same accuracy-gated path as the retail chat endpoint (chart-anchor check and rewrite retry inside run_reading). The response envelope carries citation_status and accuracy-gate notes. lang: en or hi (default en).

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "The question to answer from the chart."
    },
    "birth_data": {
      "type": "object",
      "properties": {
        "dob": {
          "type": "string",
          "description": "Birth date, YYYY-MM-DD."
        },
        "tob": {
          "type": "string",
          "description": "Birth time, HH:MM (24h)."
        },
        "lat": {
          "type": "number",
          "description": "Birth latitude, -90 to 90."
        },
        "lng": {
          "type": "number",
          "description": "Birth longitude, -180 to 180."
        },
        "tz": {
          "type": [
            "number",
            "string"
          ],
          "description": "UTC offset (e.g. 5.5) or IANA zone name (e.g. Asia/Kolkata)."
        }
      },
      "required": [
        "dob",
        "tob",
        "lat",
        "lng",
        "tz"
      ]
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "hi"
      ]
    }
  },
  "required": [
    "question",
    "birth_data"
  ]
}

Vedic compatibility (Guna Milan / Ashtakoota) between two people, 36 points across eight kootas: varna, vashya, tara, yoni, graha_maitri, gana, bhakoot, nadi. Moon nakshatra and rashi for each native are computed from their birth data through the same chart engine as get_chart_facts — do not pass nakshatra/rashi yourself. Deterministic, no LLM. Each koota carries its score, its maximum, and a plain-language reason, so the result is auditable rather than a bare number.

{
  "type": "object",
  "properties": {
    "person_a": {
      "type": "object",
      "description": "First native's birth data.",
      "properties": {
        "dob": {
          "type": "string",
          "description": "Birth date, YYYY-MM-DD."
        },
        "tob": {
          "type": "string",
          "description": "Birth time, HH:MM (24h)."
        },
        "lat": {
          "type": "number",
          "description": "Birth latitude, -90 to 90."
        },
        "lng": {
          "type": "number",
          "description": "Birth longitude, -180 to 180."
        },
        "tz": {
          "type": [
            "number",
            "string"
          ],
          "description": "UTC offset (e.g. 5.5) or IANA zone name (e.g. Asia/Kolkata)."
        }
      },
      "required": [
        "dob",
        "tob",
        "lat",
        "lng",
        "tz"
      ]
    },
    "person_b": {
      "type": "object",
      "description": "Second native's birth data.",
      "properties": {
        "dob": {
          "type": "string",
          "description": "Birth date, YYYY-MM-DD."
        },
        "tob": {
          "type": "string",
          "description": "Birth time, HH:MM (24h)."
        },
        "lat": {
          "type": "number",
          "description": "Birth latitude, -90 to 90."
        },
        "lng": {
          "type": "number",
          "description": "Birth longitude, -180 to 180."
        },
        "tz": {
          "type": [
            "number",
            "string"
          ],
          "description": "UTC offset (e.g. 5.5) or IANA zone name (e.g. Asia/Kolkata)."
        }
      },
      "required": [
        "dob",
        "tob",
        "lat",
        "lng",
        "tz"
      ]
    }
  },
  "required": [
    "person_a",
    "person_b"
  ]
}

Panchang for a location (and optional date, default: today at that location): tithi, paksha, nakshatra, yoga, karana, vara and its lord, sunrise/sunset. Deterministic, no LLM. Same compute path as GET /api/panchang.

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "description": "Birth latitude, -90 to 90."
    },
    "lng": {
      "type": "number",
      "description": "Birth longitude, -180 to 180."
    },
    "tz": {
      "type": [
        "number",
        "string"
      ],
      "description": "UTC offset (e.g. 5.5) or IANA zone name (e.g. Asia/Kolkata)."
    },
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD (default: local today at the location)."
    }
  },
  "required": [
    "lat",
    "lng",
    "tz"
  ]
}