Developer Reference

Vedic Astrology API Documentation

A complete REST API reference for building celestial experiences.

REST API Bearer Auth JSON Response

Quick Start

Base URL

https://www.vedajyotish.com/api
  1. Register for an account to get your API token
  2. Subscribe to a paid API plan — the calculation/data endpoints require an active subscription
  3. Include the token in the Authorization header: Bearer YOUR_TOKEN
  4. Make requests to the endpoints below
  5. All responses are in JSON format
API access is a paid feature (the API Developer plan). Without an active plan, the data endpoints return 403 with subscription_required: true. Once subscribed, generate and manage your key from your dashboard. Get API Access

API Endpoints

Authentication Astrology Horoscope Panchang Muhurta Compatibility Remedies

Authentication

Register

POST
/api/auth/register

Create a new user account

Request Body:

{
  "name": "John Doe",
  "email": "john@example.com",
  "password": "secret123",
  "password_confirmation": "secret123"
}

Response:

{
  "success": true,
  "user": {...},
  "token": "1|aBcDeFgHiJkLmNoPqRsTuVwXyZ"
}

Login

POST
/api/auth/login

Authenticate and get access token

Request Body:

{
  "email": "john@example.com",
  "password": "secret123"
}

Logout

POST
/api/auth/logout

Revoke access token (requires authentication)

Header Required: Authorization: Bearer YOUR_TOKEN

Astrology / Birth Chart

Generate Birth Chart

POST
/api/astrology/chart/generate

Request Body:

{
  "name": "John Doe",
  "date_of_birth": "1990-05-15",
  "time_of_birth": "14:30:00",
  "place_of_birth": "Mumbai, India",
  "latitude": 19.0760,
  "longitude": 72.8777,
  "timezone": "Asia/Kolkata"
}

Response:

{
  "success": true,
  "chart": {
    "id": 1,
    "planets": [...],
    "houses": [...],
    "ascendant": "Leo",
    "moon_sign": "Taurus"
  }
}

Get Dasha Periods

GET
/api/astrology/dasha

Get Vimshottari Dasha periods for user's birth chart

Horoscope

Get Horoscope

GET
/api/horoscope/{sign}/{period}

Parameters:

  • sign: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces
  • period: daily, weekly, monthly, yearly

Example:

/api/horoscope/leo/daily

Personalized Horoscope

POST
/api/horoscope/personalized

Get personalized horoscope based on user's birth chart (requires authentication)

Panchang

Get Panchang

GET
/api/panchang/{date}/{location}

Example:

/api/panchang/2024-01-15/Mumbai

Today's Panchang

GET
/api/panchang/today

Get today's Panchang for default location

Muhurta (Auspicious Timing)

List Activities

GET
/api/v1/muhurta/activities

The activity profiles available for the finder (key + label).

Response:

{
  "success": true,
  "data": { "activities": [
    { "key": "general", "label": "General" },
    { "key": "marriage", "label": "Marriage (Vivah)" },
    { "key": "griha_pravesh", "label": "Griha Pravesh" },
    { "key": "vehicle_purchase", "label": "Vehicle Purchase" },
    { "key": "property_purchase", "label": "Property Purchase" }
  ] }
}

Find Auspicious Times

GET
/api/v1/muhurta/find

Ranks each day in a range (max 60 days) for the chosen activity and returns the best / avoid time-windows, sorted best-first.

Query parameters:

  • activity — one of the keys above (required)
  • from, to — date range YYYY-MM-DD (required, range ≤ 60 days)
  • latitude, longitude — location (required)
  • timezone — IANA name, e.g. Asia/Kolkata (optional)

Optional personalization (Premium):

Supply the native's birth details to add tara-bala + chandra-bala to the scoring. When these are present the request requires an authenticated Premium account — 401 if unauthenticated, 403 if not premium. Omit them for the free, generic finder.

  • natal_date (YYYY-MM-DD), natal_time (HH:MM)
  • natal_latitude, natal_longitude, natal_timezone

Example:

/api/v1/muhurta/find?activity=marriage&from=2026-07-01&to=2026-07-31&latitude=28.6139&longitude=77.2090&timezone=Asia/Kolkata

Response (abridged):

{
  "success": true,
  "data": {
    "activity": "marriage",
    "activity_label": "Marriage (Vivah)",
    "from": "2026-07-01", "to": "2026-07-31",
    "personalized": false,
    "natal": null,
    "days": [
      {
        "date": "2026-07-12", "day_of_week": "Sunday",
        "score": 86, "verdict": "Excellent",
        "factors": [
          { "name": "Nakshatra", "value": "Rohini", "good": true, "note": "Favourable nakshatra." }
        ],
        "best_windows":  [ { "name": "Abhijit Muhurta", "start": "11:51", "end": "12:39" } ],
        "avoid_windows": [ { "name": "Rahu Kala", "start": "17:00", "end": "18:30" } ]
      }
    ]
  }
}

Kundali Matching

Analyze Compatibility

POST
/api/compatibility/analyze

Request Body:

{
  "male": {
    "name": "John",
    "date_of_birth": "1990-05-15",
    "time_of_birth": "14:30:00",
    "place_of_birth": "Mumbai"
  },
  "female": {
    "name": "Jane",
    "date_of_birth": "1992-08-20",
    "time_of_birth": "10:15:00",
    "place_of_birth": "Delhi"
  }
}

Response:

{
  "success": true,
  "compatibility_score": 28,
  "total_points": 36,
  "analysis": {...},
  "recommendation": "Good match"
}

Remedies

Generate Remedies

POST
/api/remedies/generate

Generate personalized remedies based on birth chart (requires authentication)

Get User Remedies

GET
/api/remedies

Get all remedies for authenticated user

Error Codes

Code Status Description
200 Success Request successful
401 Unauthorized Invalid or missing authentication token
403 Forbidden Insufficient permissions (e.g., premium feature)
404 Not Found Resource not found
422 Validation Error Invalid request data
500 Server Error Internal server error

Rate Limits

Free Tier

100 requests/day

Limited access to basic features

Premium Tier

Unlimited requests

Full access to all features