Rashifal (horoscope)

POST /v1/rashifal

Returns a Vedic horoscope for the given period. Planet positions are calculated using the profile's birth location as the reference. Scores and labels are locale-aware.

Cost: 2 credits

Request body

Field	Type	Required	Description
profileId	string	Yes	Profile ID
period	string	Yes	daily · weekly · monthly · yearly
calendar	string	No	ad (default) · bs

The calendar parameter determines which period window is used for planet calculations — not just the date label:

• ad — calculates for the current Gregorian period (e.g., May 2026)
• bs — calculates for the current Bikram Sambat period (e.g., Baisakh 2083 ≈ Apr 14–May 14, 2026)

For daily and weekly, both calendars produce identical results since the day/week is the same.

Example

curl -X POST https://api.askvedicguru.com/api/v1/rashifal \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "profileId": "683abc123def456",
    "period": "monthly",
    "calendar": "bs"
  }'

Response

{
  "success": true,
  "data": {
    "moonSign": "Scorpio",
    "period": "monthly",
    "periodLabel": "Baisakh 2083",
    "periodDate": {
      "adYear": 2026,
      "adMonth": "April",
      "adMonthNum": 4,
      "bsYear": 2083,
      "bsMonth": "Baisakh",
      "bsMonthNum": 1
    },
    "overallScore": 3.8,
    "overallScoreLabel": "Good",
    "highlights": [
      "Jupiter in House 2 (Sagittarius): Wealth Enhancer — Financial opportunities emerge through networking."
    ],
    "cautions": [
      "Saturn in House 12 (Libra): Hidden Obstacles — Guard against unseen delays in long-term plans."
    ],
    "areas": {
      "career": { "score": 4.2, "scoreLabel": "Excellent", "summary": "..." },
      "health": { "score": 3.5, "scoreLabel": "Good", "summary": "..." },
      "relationships": { "score": 3.8, "scoreLabel": "Good", "summary": "..." },
      "finance": { "score": 4.0, "scoreLabel": "Excellent", "summary": "..." }
    },
    "luckyFactors": {
      "color": "Red",
      "number": 9,
      "day": "Tuesday",
      "gemstone": "Coral"
    },
    "transits": [
      {
        "planet": "Jupiter",
        "currentSign": "Taurus",
        "houseFromMoon": 7,
        "isRetrograde": false,
        "title": "Partnership Activator",
        "score": 4,
        "scoreLabel": "Good"
      }
    ],
    "summary": "This month favors financial growth and career advancement..."
  }
}

periodDate fields

The periodDate object always contains both AD and BS components separately, so you can display them independently:

Field	Description
adYear	AD year number
adMonth	AD month name (e.g. "May")
adMonthNum	AD month number (1–12)
adDay	Day number (daily only)
adDayEnd	End day number (weekly only)
adMonthEnd	End month name (weekly, if different)
bsYear	BS year number
bsMonth	BS month name (e.g. "Baisakh")
bsMonthNum	BS month number (1–12)
bsDay	BS day number (daily only)
bsDayEnd	BS end day (weekly only)
bsMonthEnd	BS end month name (weekly, if different)
bsYearEnd	BS end year (weekly, if week crosses a BS year)

---

For fetching all 12 signs in one shot without a profile, see Horoscope (All Signs).

---

Public horoscope (no auth)

GET /rashifal/general?sign=Scorpio&period=daily&locale=ne

Returns a cached general horoscope by zodiac sign — no profile, no API key required. Results are pre-calculated for all 12 signs and cached with a TTL.

Query parameters

Parameter	Required	Values
sign	Yes	Aries · Taurus · Gemini · Cancer · Leo · Virgo · Libra · Scorpio · Sagittarius · Capricorn · Aquarius · Pisces
period	No	daily (default) · weekly · monthly · yearly
locale	No	en · hi · ne