Skip to content

Vedic interpretations

These endpoints expose LLM-ready Vedic interpretation contracts with auditable deterministic grounding.

Current responses return grounded deterministic prose summaries with the same contract expected from future provider-generated prose. This keeps the client contract stable while preserving clear provenance.

All responses include:

  • content — prose only
  • tier
  • features_used
  • sources
  • fresh
  • request_hash

Natal — POST /v1/interpretations/vedic/natal

{
  "chart_id": "chart_123",
  "language": "en",
  "tier": "standard",
  "fresh": false
}

Grounding:

  • vedic.risk_signals
  • vedic.support_signals

Relationship — POST /v1/interpretations/vedic/relationship

{
  "chart_a_id": "chart_a",
  "chart_b_id": "chart_b",
  "language": "en",
  "tier": "standard",
  "fresh": false
}

Grounding:

  • vedic.relationship.highlights
  • vedic.relationship.overlays

Forecast — POST /v1/interpretations/vedic/forecast

{
  "chart_id": "chart_123",
  "starts_at": "2026-01-01T00:00:00+00:00",
  "ends_at": "2026-02-01T00:00:00+00:00",
  "language": "en",
  "tier": "standard",
  "fresh": false
}

Grounding:

  • vedic.focus_areas
  • vedic.daily_weather

Muhurta — POST /v1/interpretations/vedic/muhurta

{
  "natal_chart_id": "chart_123",
  "activity_type": "business",
  "proposed_at": "2026-05-31T12:00:00+05:30",
  "latitude": 28.6139,
  "longitude": 77.2090,
  "timezone": "Asia/Kolkata",
  "language": "en",
  "tier": "standard",
  "fresh": false
}

Grounding:

  • vedic.muhurta.score

Response example

{
  "content": "The proposed Muhurta is labelled usable with total score 6...",
  "tier": "standard",
  "features_used": ["vedic.muhurta.score"],
  "sources": ["/v1/vedic/muhurta/score"],
  "fresh": false,
  "request_hash": "2e59…64 hex chars…"
}