/v1/chart/houses

Whole-sign house cusps.

What this tells you

Vedic astrology uses whole-sign houses: each zodiac sign is one house, starting from the ascendant's sign. No cusp math needed. The bhava lord of each house is simply the sign lord — knowing where each house's lord is placed in the chart (another house) reveals significant yogas.

Request

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

example request

curl "https://api.divyastroapi.com/v1/chart/houses?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

{
  "system": "whole-sign",
  "ascendant_sign": "Cancer",
  "houses": [
    { "number":  1, "sign": "Cancer",       "sign_index":  4, "lord": "Moon"    },
    { "number":  2, "sign": "Leo",          "sign_index":  5, "lord": "Sun"     },
    { "number":  3, "sign": "Virgo",        "sign_index":  6, "lord": "Mercury" },
    { "number":  4, "sign": "Libra",        "sign_index":  7, "lord": "Venus"   },
    { "number":  5, "sign": "Scorpio",      "sign_index":  8, "lord": "Mars"    },
    { "number":  6, "sign": "Sagittarius",  "sign_index":  9, "lord": "Jupiter" },
    { "number":  7, "sign": "Capricorn",    "sign_index": 10, "lord": "Saturn"  },
    { "number":  8, "sign": "Aquarius",     "sign_index": 11, "lord": "Saturn"  },
    { "number":  9, "sign": "Pisces",       "sign_index": 12, "lord": "Jupiter" },
    { "number": 10, "sign": "Aries",        "sign_index":  1, "lord": "Mars"    },
    { "number": 11, "sign": "Taurus",       "sign_index":  2, "lord": "Venus"   },
    { "number": 12, "sign": "Gemini",       "sign_index":  3, "lord": "Mercury" }
  ]
}

Field reference

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

Field	Type	Meaning
system	string	House system. Default and only Vedic-standard system: whole-sign. example: `"whole-sign"`
ascendant_sign	string	Sign that starts the 1st house. example: `"Cancer"`
houses[]	array of 12	12 houses, always in order 1 → 12. example: `[…]`
houses[].number	integer (1–12)	House number. example: `1`
houses[].sign	string	Sign occupying this house. example: `"Cancer"`
houses[].lord	string	Planetary lord of the sign — the "bhava lord" for this house. example: `"Moon"`

Usage tips

How to use it

For Porphyry/KP cusps, use /v1/chart/kp-sublord
This endpoint returns whole-sign only. If you need precise cusps (KP system), call /v1/chart/kp-sublord.
Bhava lord placement analysis
Cross-reference each bhava lord with /v1/chart/planets — "Where is my 10th lord?" → 10th = Aries → Mars → check house where Mars sits.

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.