# Vedic API

AstroWay API ships **354+ Vedic astrology endpoints** — the deepest Jyotish coverage among commercial APIs. Classical BPHS-Parashara, full Lal Kitab, KP methodology, Jaimini Sutras — all cross-checked against PyJHora.

## What's computed

| Category | Coverage |
|---|---|
| **Dashas** | 10 systems (Vimshottari + 9 alternatives) × 5 levels = **50 endpoints** |
| **Vargas** | Shodasha varga D1–D60 in one call |
| **Panchang** | Tithi, Karana, day-Yoga, day-Nakshatra, Choghadia, Hora, Rahu-kaal, full |
| **Shadbala** | 6-fold strength: Sthana + Dig + Kala + Cheshta + Naisargika + Drik + full |
| **Yogas** | Parashara (Raja, Dhana, Dharma-Karmadhipati, Pancha-Mahapurusha, Gajakesari, Adhi) + Jaimini (karaka-yoga, karakamsa, shubha-graha) |
| **Doshas** | Parashara (Mangal, Kaal-Sarp, Pitru, Shrapit, Grahan, Guru-Chandal) + Lal Kitab Manglik + KP |
| **Compatibility** | Ashtakoot (8-fold Guna Milan), Dashakoota, Manglik-check, Mangal-match, Bhrigu-match |
| **Muhurat** | Electional — marriage, vehicle, business, travel, naming, surgery, education, investment, property, griha-pravesh, engagement, court case |
| **Lal Kitab** | Full pack: chart, grahas, rishis, tattvas, vargas, upayas |
| **KP** | Krishnamurti Paddhati with ruling planets, sub-lord theory, KP yogas/doshas |
| **Jaimini** | Karakas, Chara-karakas, Padas, Upapada, Aspects, Drishti, Atmakaraka-Navamsha, Dasha-summary, Yogas + extras: karaka-yoga, karakamsa, atmakaraka-rotation, argala-analysis |

## Example: Vimshottari dasha

<Tabs>
  <TabItem label="cURL">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/vedic/dashas/vimshottari/maha \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{
        "date": "1990-07-14",
        "time": "14:30:00",
        "tzOffset": "+03:00",
        "latitude": 50.4501,
        "longitude": 30.5234
      }'
    ```
  </TabItem>
  <TabItem label="Node.js">
    ```ts
    const r = await fetch('https://api.astroway.info/v1/vedic/dashas/vimshottari/maha', {
      method: 'POST',
      headers: {
        'X-Api-Key': process.env.ASTROWAY_API_KEY!,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        date: '1990-07-14',
        time: '14:30:00',
        tzOffset: '+03:00',
        latitude: 50.4501,
        longitude: 30.5234,
      }),
    });
    const { data } = await r.json();
    console.log(`Current MD: ${data.current.lord} until ${data.current.endDate}`);
    ```
  </TabItem>
  <TabItem label="Python">
    ```python

    r = requests.post(
        'https://api.astroway.info/v1/vedic/dashas/vimshottari/maha',
        headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
        json={
            'date': '1990-07-14',
            'time': '14:30:00',
            'tzOffset': '+03:00',
            'latitude': 50.4501,
            'longitude': 30.5234,
        },
    )
    data = r.json()['data']
    print(f"Current MD: {data['current']['lord']} until {data['current']['endDate']}")
    ```
  </TabItem>
  <TabItem label="PHP">
    ```php
    <?php
    use GuzzleHttp\Client;

    $aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
    $r = $aw->post('vedic/dashas/vimshottari/maha', [
        'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
        'json' => [
            'date' => '1990-07-14',
            'time' => '14:30:00',
            'tzOffset' => '+03:00',
            'latitude' => 50.4501,
            'longitude' => 30.5234,
        ],
    ]);
    $data = json_decode($r->getBody(), true)['data'];
    echo "Current MD: {$data['current']['lord']} until {$data['current']['endDate']}\n";
    ```
  </TabItem>
</Tabs>

## Unique capabilities

Endpoints no competitor ships:

- **10 dasha systems** including rare Tribhagi, Shatabdika, Shodashottari, Sthira, Shoola (most APIs ship only Vimshottari)
- **Karakamsa as 12-house chart** — full projection with ishta-devata + moksha significations
- **Argala-analysis** — full Argala + Virodhargala scan across 12 houses with netInfluence metric
- **Atmakaraka-rotation** — progressive AK across lifetime with life-event triggers
- **Cross-school doshas** — Parashara + Lal Kitab + KP in one API (most ship a single school)

## Who uses it

- **Indian astrology apps** (Pratyangira, Drik Panchang, AstroSage analogues) — full backend without rolling your own ephemeris
- **Marriage matchmaking** — Ashtakoot + Dashakoota + Manglik in one call
- **Mobile horoscope apps** — daily Panchang via `/v1/vedic/panchang/full` (8 elements in 1 request)
- **Electional services** (child naming, marriage muhurta) — `/v1/vedic/muhurat/*` 12 event types
- **Vedic compatibility services** — full report via `/v1/vedic/compatibility/full`

## Accuracy

All calculations run on **Swiss Ephemeris** (sub-arcsecond precision) + cross-checked against **PyJHora** (de-facto reference Python implementation). Divergences, where they exist, are documented in `docs/AUDIT-TRAIL.md`.

Schools with diverging traditions (Lal Kitab, KP, Jaimini) carry separate YELLOW markers on endpoints where the method is single-author (Lal Kitab — Pt. Roop Chand Joshi only) — integrators see the lineage status.

## Localization

Vedic reports are available in **20 languages** (T0 manual, T1 AI Beta — see [`/en/languages/`](/en/languages/)). Pass `lang=<code>` to any `/v1/reports/*` endpoint.

## Pricing

Most Vedic endpoints — **Tier 2 (20 credits)**. Large reports (full compatibility, muhurat scanner) — Tier 3 (50 cr). PDF reports Lal Kitab / Vedic Kundli — Tier 7 (5000 cr).

On the Free tier — **500 Vedic calls per month free**.

<CardGrid>
  <LinkCard title="Endpoint categories →" href="/en/vedic/" description="Dashas, Vargas, Panchang, Shadbala, Yogas, Doshas, Compatibility, Muhurat" />
  <LinkCard title="Quick start" href="/en/getting-started/" description="First request in 5 minutes" />
  <LinkCard title="Pricing" href="/en/pricing/" description="From free to Enterprise" />
  <LinkCard title="Language support" href="/en/languages/" description="20 languages — Vedic reports" />
</CardGrid>