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.
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.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.
Birth data and time confidence
The VedIntel™ AstroAPI requires:
| Parameter | Format | Notes |
|---|---|---|
| dob | DD/MM/YYYY | Date of birth. Required for all natal chart endpoints. |
| tob | HH:MM (24-hour) | Time of birth. Accuracy directly affects Lagna (Ascendant) and dasha balance. |
| lat | decimal degrees | Birth latitude. Used for Ascendant and muhurta computations. |
| lon | decimal degrees | Birth longitude. |
| tz | number | UTC offset at birth time (e.g. 5.5 for IST). Not the current timezone — the timezone at the time and place of birth. |
| ayanamsa | string | Default: lahiri. Options: raman, kp, pushya_paksha, yukteshwar, fagan_bradley, de_luce, suryasiddhanta, aryabhata, true_citra, true_revati, jn_bhasin. |
Chart computation
The core natal chart endpoints:
| Endpoint | What it returns |
|---|---|
| /api/v1/horoscope/planet-details | All 9 planets + Rahu/Ketu: sign, degree, nakshatra, pada, retrograde, dignity, combustion |
| /api/v1/extended-horoscope/find-ascendant | Ascendant sign, degree, nakshatra, pada |
| /api/v1/extended-horoscope/extended-kundli-details | Full kundli: ascendant, planets, house cusps, all major factors in one call |
| /api/v1/horoscope/divisional-charts | D1–D60 divisional charts — specify div_num parameter (e.g. 9 for Navamsa, 10 for Dashamsha) |
| /api/v1/horoscope/chart-image | SVG chart image (North Indian or South Indian style) |
| /api/v1/extended-horoscope/yoga-list | 75+ yoga detection — which yogas are present and their strength |
| /api/v1/extended-horoscope/shad-bala | Shadbala — 6-strength computation for all 7 classical planets |
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"
Timing analysis — Dasha systems
Dasha timing is typically the most practically useful part of a Vedic consultation. The API supports three dasha systems:
| Endpoint | System |
|---|---|
| /api/v1/dashas/current-mahadasha-full | Vimshottari — current Mahadasha/Antardasha/Pratyantardasha with start/end dates |
| /api/v1/dashas/mahadasha | Vimshottari — full Mahadasha table for the lifetime |
| /api/v1/dashas/antardasha | Vimshottari — Antardasha sub-periods for a specified Mahadasha lord |
| /api/v1/dashas/mahadasha-predictions | Vimshottari — traditional predictions for each Mahadasha |
| /api/v1/dashas/char-dasha-current | Jaimini Chara Dasha — current period |
| /api/v1/dashas/char-dasha-main | Jaimini Chara Dasha — main period table |
| /api/v1/dashas/char-dasha-sub | Jaimini Chara Dasha — sub-periods |
| /api/v1/dashas/yogini-dasha-main | Yogini Dasha — main period table |
| /api/v1/dashas/yogini-dasha-sub | Yogini Dasha — sub-periods |
Interpretation
Supporting endpoints for interpretation:
| Endpoint | Use |
|---|---|
| /api/v1/horoscope/ascendant-report | Ascendant-sign personality overview |
| /api/v1/horoscope/planet-report | Per-planet interpretive text |
| /api/v1/horoscope/planets-in-houses | Planets in houses with traditional significations |
| /api/v1/horoscope/planetary-aspects | Graha drishti aspects |
| /api/v1/horoscope/personal-characteristics | Character and life themes from chart factors |
| /api/v1/extended-horoscope/yoga-calculator | Yoga strength and relevance scores |
| /api/v1/extended-horoscope/jaimini-karakas | Jaimini Chara karakas — Atmakaraka, Amatyakaraka, etc. |
| /api/v1/extended-horoscope/arutha-padas | Arudha padas for all 12 houses |
| /api/v1/extended-horoscope/kp-houses | KP house cusps with sub-lords |
| /api/v1/extended-horoscope/kp-planets | KP planet cuspal sub-lord positions |
| /api/v1/panchang/transit | Current planetary transits over natal positions |
| /api/v1/extended-horoscope/varshapal-details | Varshaphal annual chart for a given year |
Doshas and special factors
| Endpoint | What it checks |
|---|---|
| /api/v1/dosha/mangal-dosh | Mangal Dosh — Mars in houses 1,2,4,7,8,12 from Lagna, Moon and Venus |
| /api/v1/dosha/kaalsarp-dosh | Kaal Sarp — all 7 classical planets between Rahu and Ketu |
| /api/v1/dosha/pitra-dosh | Pitra Dosh — affliction indicators from Sun/Moon/Saturn positioning |
| /api/v1/dosha/papasamaya | Papasamaya — malefic strength in the chart |
| /api/v1/extended-horoscope/current-sade-sati | Sade Sati — current status and phase |
| /api/v1/extended-horoscope/sade-sati-table | Sade Sati — historical and future periods |
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.
curl "https://vedintelastroapi.com/api/v1/utilities/nakshatra-vastu-details?api_key=YOUR_API_KEY&nakshatra_id=3"
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™.
| Endpoint | What it generates |
|---|---|
| /api/v1/ai/interpret/chart | Full natal chart reading in human-quality language |
| /api/v1/ai/dasha/narrative | Current dasha period story and implications |
| /api/v1/ai/transit/forecast | Transit forecast narrative for a date range |
| /api/v1/ai/compatibility | Synastry compatibility narrative for two charts |
| /api/v1/horoscope/ai-12-month-prediction | 12-month prediction narrative from natal chart data |
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-listoryoga-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.