/v1/muhurta/graha-pravesh

Housewarming muhurta.

What this tells you

Graha Pravesh (housewarming) muhurta is computed from different factor weights than vivah — with direction (which cardinal direction the house faces) as a special input. Auspicious months: Magha, Phalguna, Vaishakha, Jyeshtha.

Request

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

example request

curl "https://api.divyastroapi.com/v1/muhurta/graha-pravesh?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

{
  "candidate": "2027-03-10T07:30:00+05:30",
  "score": 78,
  "verdict": "good",
  "factors": {
    "tithi":     { "value": "Panchami", "score": 85, "weight": 15 },
    "nakshatra": { "value": "Uttara Phalguni", "score": 90, "weight": 20 },
    "vara":      { "value": "Wednesday",   "score": 80, "weight": 10 },
    "direction": { "value": "East-facing", "score": 95, "weight": 15 },
    "lagna":     { "value": "Pisces rising","score": 70, "weight": 15 }
  }
}

Field reference

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

Field	Type	Meaning
score	number (0–100)	Composite housewarming muhurta score. example: `78`
factors.direction	object	House entry direction — East/North/West/South favorability. example: `…`
factors.lagna	object	Rising sign at the proposed entry moment. example: `…`

Usage tips

How to use it

Ask for entry direction
Add a dropdown: East / North / West / South. Without it, direction score defaults to neutral.

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.