Vedic Consultation Guide

Vedic Astrology Consultation Workflow

A practitioner-focused workflow covering client intake, birth data quality, chart computation, dasha timing analysis, interpretation and follow-up — linked to the real VedIntel™ AstroAPI endpoints that support each step.

Overview

This is a Vedic astrology consultation guide — not an Astro-Vastu or natal Vastu guide. It covers the standard Jyotish consultation sequence: intake, birth data collection and quality assessment, chart and divisional chart computation, dasha timing, interpretation and follow-up.

Every endpoint referenced here is real, documented and in production. No endpoints are invented for this guide. Where a feature is not yet available, that is explicitly noted.

Natal Vastu overlay (Astro-Vastu) is not yet available. Linking birth chart planetary positions to spatial zones is a planned Phase 2 feature (astro_vastu_rules_version: "0.0.0"). Do not combine a natal chart with the Vastu geometry endpoints expecting an integrated result — these are independent analysis paths in Phase 1.
1

Client intake

Before computing any chart, establish:

  • Primary questions: career, relationships, health, finance, timing of an event. These determine which divisional charts, dasha periods and techniques are most relevant.
  • Birth data: date, time and place of birth (see section 2 for quality considerations).
  • Consultation type: natal reading, annual forecast (Varshaphal), prashna (horary), transit analysis, or matching (for matrimonial consultations).
  • Consent: explain that the API computes planetary positions from Swiss Ephemeris (a commercially licensed astronomical computation library) and that interpretations are traditional Vedic astrological analysis, not scientific predictions.
2

Birth data and time confidence

The VedIntel™ AstroAPI requires:

ParameterFormatNotes
dobDD/MM/YYYYDate of birth. Required for all natal chart endpoints.
tobHH:MM (24-hour)Time of birth. Accuracy directly affects Lagna (Ascendant) and dasha balance.
latdecimal degreesBirth latitude. Used for Ascendant and muhurta computations.
londecimal degreesBirth longitude.
tznumberUTC offset at birth time (e.g. 5.5 for IST). Not the current timezone — the timezone at the time and place of birth.
ayanamsastringDefault: lahiri. Options: raman, kp, pushya_paksha, yukteshwar, fagan_bradley, de_luce, suryasiddhanta, aryabhata, true_citra, true_revati, jn_bhasin.
Birth time confidence: Lagna (Ascendant) changes approximately every 2 hours. A 15-minute error in birth time can place the Ascendant in a different nakshatra pada. If birth time is uncertain, the chart should be presented with that caveat clearly stated. The API does not perform rectification — that is a practitioner judgement.
3

Chart computation

The core natal chart endpoints:

EndpointWhat it returns
/api/v1/horoscope/planet-detailsAll 9 planets + Rahu/Ketu: sign, degree, nakshatra, pada, retrograde, dignity, combustion
/api/v1/extended-horoscope/find-ascendantAscendant sign, degree, nakshatra, pada
/api/v1/extended-horoscope/extended-kundli-detailsFull kundli: ascendant, planets, house cusps, all major factors in one call
/api/v1/horoscope/divisional-chartsD1–D60 divisional charts — specify div_num parameter (e.g. 9 for Navamsa, 10 for Dashamsha)
/api/v1/horoscope/chart-imageSVG chart image (North Indian or South Indian style)
/api/v1/extended-horoscope/yoga-list75+ yoga detection — which yogas are present and their strength
/api/v1/extended-horoscope/shad-balaShadbala — 6-strength computation for all 7 classical planets
Example — extended kundli details
curl "https://vedintelastroapi.com/api/v1/extended-horoscope/extended-kundli-details?api_key=YOUR_API_KEY&dob=15/06/1990&tob=10:30&lat=12.9716&lon=77.5946&tz=5.5"
All natal chart computations use Swiss Ephemeris running locally on the VedIntel™ servers. Results are cached permanently in Supabase — the same birth data always returns the cached result without recomputation, preserving your API quota.
4

Timing analysis — Dasha systems

Dasha timing is typically the most practically useful part of a Vedic consultation. The API supports three dasha systems:

EndpointSystem
/api/v1/dashas/current-mahadasha-fullVimshottari — current Mahadasha/Antardasha/Pratyantardasha with start/end dates
/api/v1/dashas/mahadashaVimshottari — full Mahadasha table for the lifetime
/api/v1/dashas/antardashaVimshottari — Antardasha sub-periods for a specified Mahadasha lord
/api/v1/dashas/mahadasha-predictionsVimshottari — traditional predictions for each Mahadasha
/api/v1/dashas/char-dasha-currentJaimini Chara Dasha — current period
/api/v1/dashas/char-dasha-mainJaimini Chara Dasha — main period table
/api/v1/dashas/char-dasha-subJaimini Chara Dasha — sub-periods
/api/v1/dashas/yogini-dasha-mainYogini Dasha — main period table
/api/v1/dashas/yogini-dasha-subYogini Dasha — sub-periods
Dasha accuracy depends on birth time accuracy. Vimshottari dasha balance at birth is computed from the Moon's exact longitude in the nakshatra at the moment of birth. A birth time error of 15–30 minutes may shift early dasha boundaries by 1–3 days.
5

Interpretation

Supporting endpoints for interpretation:

EndpointUse
/api/v1/horoscope/ascendant-reportAscendant-sign personality overview
/api/v1/horoscope/planet-reportPer-planet interpretive text
/api/v1/horoscope/planets-in-housesPlanets in houses with traditional significations
/api/v1/horoscope/planetary-aspectsGraha drishti aspects
/api/v1/horoscope/personal-characteristicsCharacter and life themes from chart factors
/api/v1/extended-horoscope/yoga-calculatorYoga strength and relevance scores
/api/v1/extended-horoscope/jaimini-karakasJaimini Chara karakas — Atmakaraka, Amatyakaraka, etc.
/api/v1/extended-horoscope/arutha-padasArudha padas for all 12 houses
/api/v1/extended-horoscope/kp-housesKP house cusps with sub-lords
/api/v1/extended-horoscope/kp-planetsKP planet cuspal sub-lord positions
/api/v1/panchang/transitCurrent planetary transits over natal positions
/api/v1/extended-horoscope/varshapal-detailsVarshaphal annual chart for a given year
6

Doshas and special factors

EndpointWhat it checks
/api/v1/dosha/mangal-doshMangal Dosh — Mars in houses 1,2,4,7,8,12 from Lagna, Moon and Venus
/api/v1/dosha/kaalsarp-doshKaal Sarp — all 7 classical planets between Rahu and Ketu
/api/v1/dosha/pitra-doshPitra Dosh — affliction indicators from Sun/Moon/Saturn positioning
/api/v1/dosha/papasamayaPapasamaya — malefic strength in the chart
/api/v1/extended-horoscope/current-sade-satiSade Sati — current status and phase
/api/v1/extended-horoscope/sade-sati-tableSade Sati — historical and future periods
7

Nakshatra Vastu connection

The existing /api/v1/utilities/nakshatra-vastu-details endpoint returns the traditionally favourable Vastu direction for a client's birth nakshatra — a simple, non-geometric connection between the natal chart and spatial preference.

Nakshatra Vastu details request
curl "https://vedintelastroapi.com/api/v1/utilities/nakshatra-vastu-details?api_key=YOUR_API_KEY&nakshatra_id=3"
This is a nakshatra-to-direction lookup. It is not a full Astro-Vastu overlay (linking natal planetary positions to spatial zones) — that is a Phase 2 feature not yet available.
8

AI narrative endpoints (Developer plan and above)

For practitioners who want AI-generated narrative text from chart data, the following endpoints are available. These require a Developer plan or above and a connected AI provider key (OpenAI or Anthropic) — the BYOLLM model means inference is billed to your own provider account, not to VedIntel™.

EndpointWhat it generates
/api/v1/ai/interpret/chartFull natal chart reading in human-quality language
/api/v1/ai/dasha/narrativeCurrent dasha period story and implications
/api/v1/ai/transit/forecastTransit forecast narrative for a date range
/api/v1/ai/compatibilitySynastry compatibility narrative for two charts
/api/v1/horoscope/ai-12-month-prediction12-month prediction narrative from natal chart data
AI narratives stream as NDJSON (Server-Sent Events). They are grounded in real Swiss Ephemeris computed data — the model receives the chart facts, not a bare birth date. See the full API documentation for streaming format and AI Chat (custom assistant) capabilities.
9

Report and follow-up

A complete Vedic consultation report typically covers:

  • Lagna, Moon sign and Sun sign with the nakshatra for each
  • Key planet placements in house and sign, with dignity and notable aspects
  • Yogas present and their strength (from yoga-list or yoga-calculator)
  • Dosha status where relevant to the client's questions
  • Current and upcoming Mahadasha/Antardasha periods with start and end dates
  • Practical guidance for the client's primary questions, referenced to chart factors
  • Disclosure: traditional Vedic analysis; not a prediction guaranteed to occur

The VedIntel™ PDF Reports feature can generate AI-written narrative reports from natal chart data via /api/v1/reports/generate. Report types include Full Analysis, Career, Marriage, Health, Finance, Compatibility and Annual Forecast. PDF credits are charged per report from your account balance. See the documentation.

Limitations

The API computes planetary positions and applies traditional Vedic techniques. It does not perform birth time rectification. If the birth time is uncertain, present findings accordingly.
Interpretive text from API endpoints represents traditional Vedic significations. These are not predictions of specific events. Practitioner judgement is required to synthesise chart factors and contextualise them for a client's specific situation and questions.
Natal Vastu overlay (linking birth planets to spatial zones) is not yet available. See the Vastu consultation guide for the separate Vastu analysis workflow.

Related resources