/v1/varshaphal/lord

Varsha lord (year lord).

What this tells you

The Varsha Lord is one of 5 candidate planets (Muntha lord, Varshaphal lagna lord, Sun-sign lord, Moon-sign lord, day lord at solar return). The Varsha Lord governs the year's main theme — benefic = smooth year, malefic = challenging year.

Request

All requests require an Authorization header with your dv_live_* API key.

example request

curl "https://api.divyastroapi.com/v1/varshaphal/lord?date=2026-04-19&time=06%3A30&tz=%2B05%3A30&lat=28.61&lon=77.21" \
  -H "Authorization: Bearer dv_live_0123456789abcdef0123456789abcdef"

Response (200 OK)

Successful requests return a JSON body. Field names are stable across versions.

200 response

{
  "varshaphal_year": 2027,
  "varsha_lord": "Venus",
  "lord_house_in_varshaphal": 3,
  "lord_sign_in_varshaphal": "Sagittarius",
  "lord_strength": "strong",
  "interpretation": "Venus rules this year — expect emphasis on relationships, arts, comforts. Placement in 3rd brings courage and communication themes."
}

Field reference

Every field in the response, with its type, a real example, and what it means.

Field	Type	Meaning
varsha_lord	string	Year lord — the planet governing the full year. example: `"Venus"`
lord_house_in_varshaphal	integer	House placement in the varshaphal chart. example: `3`
lord_strength	string	Qualitative strength. strong / moderate / weak. example: `"strong"`
interpretation	string	Plain-language year theme. example: `…`

Usage tips

How to use it

Pair with Muntha
Varsha Lord + Muntha house together are the two-sentence elevator pitch for a yearly reading.

Errors

Every error follows the same envelope. Use the error.code field (not the message) for conditional logic in your integration.

401 Unauthorized

{
  "error": {
    "code": "unauthorized",
    "message": "missing or invalid API key",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

402 Payment Required

{
  "error": {
    "code": "trial_exhausted",
    "message": "your free trial credits are exhausted — pick a plan to continue",
    "top_up_url": "https://divyastroapi.com/pricing",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

429 Too Many Requests

{
  "error": {
    "code": "rate_limited",
    "message": "rate limit exceeded; retry after 12 seconds",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

Try it

Get a dv_live_* key from your dashboard and paste into the cURL snippet above. New accounts get 500 free credits. Sign up.