/v1/varshaphal/muntha

Muntha position for varshaphal.

What this tells you

Muntha is a mathematically-derived point that moves one sign per year — starting from the natal Moon sign. Its position in the varshaphal chart reveals the dominant life area for the year. Muntha in benefic houses (5, 9, 11) = good year; in 6, 8, 12 = challenging year.

Request

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

example request

curl "https://api.divyastroapi.com/v1/varshaphal/muntha?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,
  "age": 37,
  "muntha_sign": "Aquarius",
  "muntha_sign_index": 11,
  "muntha_house": 5,
  "interpretation": "Muntha in the 5th house: focus on children, creativity, speculation, and education this year."
}

Field reference

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

Field	Type	Meaning
age	integer	Native's age during this varshaphal year. example: `37`
muntha_sign	string	Sign Muntha occupies this year. example: `"Aquarius"`
muntha_house	integer (1–12)	House (from varshaphal ascendant) Muntha falls in. example: `5`
interpretation	string	Brief reading of what Muntha-in-this-house indicates. example: `…`

Usage tips

How to use it

Headline metric
Muntha house is the single most quotable data point in a yearly reading. "Your Muntha is in the 5th this year" — users love this.

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.