API Reference / Vedic Astrology / Panchang
/v1/panchang/lagna-table
All 12 lagna (ascendant sign) rise-times for the day — shows when each zodiac sign rises on the eastern horizon.
What this tells you
The lagna table shows when each of the 12 sidereal signs rises on the eastern horizon, from local sunrise to the next sunrise. At Indian latitudes a sign takes roughly 1.5 to 2.5 hours to rise; signs of short ascension rise faster than signs of long ascension, and the spread grows with latitude. Muhurta practitioners use lagna tables to choose the exact time for an auspicious ascendant — for example, scheduling a business launch when Taurus or Cancer is rising.
Request
All requests require an Authorization header with your dv_live_* API key.
curl "https://api.lifeastroapi.com/v1/panchang/lagna-table?date=2027-01-15&tz=Asia%2FKolkata&lat=28.6139&lon=77.209" \
-H "Authorization: Bearer YOUR_API_KEY"Query parameters
Checked against the API: a parameter is marked required when the request fails without it.
| Name | Required | Example | Description |
|---|---|---|---|
date | yes | 2027-01-15 | Date (YYYY-MM-DD). |
tz | yes | Asia/Kolkata | Timezone: IANA name (Asia/Kolkata) or UTC offset (+05:30). |
lat | yes | 28.6139 | Latitude in decimal degrees. |
lon | yes | 77.209 | Longitude in decimal degrees. |
Response (200 OK)
The real response to the example request above, generated from the API itself. Long arrays are trimmed to their first two items. Field names are stable across versions.
{
"date": "2027-01-15",
"location": {
"lat": 28.6139,
"lon": 77.209,
"alt": 0
},
"tz": "Asia/Kolkata",
"slots": [
{
"index": 8,
"sign": "Sagittarius",
"start_jd": 2461420.572762,
"end_jd": 2461420.574681,
"start_local": "2027-01-15 07:14:47",
"end_local": "2027-01-15 07:17:32"
},
{
"index": 9,
"sign": "Capricorn",
"start_jd": 2461420.574693,
"end_jd": 2461420.645711,
"start_local": "2027-01-15 07:17:33",
"end_local": "2027-01-15 08:59:49"
}
]
}Field reference
Every field in the response, with its type, a real example, and what it means.
| Field | Type | Meaning |
|---|---|---|
| date | string (YYYY-MM-DD) | The requested date. The table runs from local sunrise of this date to the next sunrise. example: "2027-01-15" |
| location | object | Echo of lat, lon and alt (metres). example: { "lat": 28.6139, "lon": 77.209, "alt": 0 } |
| tz | string | Echo of the tz you sent. All *_local times are in this zone. example: "Asia/Kolkata" |
| slots | array | One entry per rising sign, in order. The first entry starts at sunrise and the last ends at the next sunrise, so both are usually partial (the first one here lasts under 3 minutes). example: […] |
| slots[].index | integer (0–11) | Sidereal sign on the eastern horizon: 0 = Aries … 8 = Sagittarius … 11 = Pisces. example: 8 |
| slots[].sign | string | Sign name. Translated when you pass `locale` (hi, mr, ta, kn, bn, gu, pa, te, ml). example: "Sagittarius" |
| slots[].start_jd / end_jd | number | Start and end of the slot as Julian Day in UT. example: 2461420.572762 |
| slots[].start_local / end_local | string (YYYY-MM-DD HH:MM:SS) | When this lagna starts and ends in local time. Each sign change is found to within 1 second, and the next slot starts 1 second after the previous one ends. example: "2027-01-15 07:14:47" |
Usage tips
How to use it
- Muhurta appsDisplay a timeline of lagna changes. Highlight trinal lagnas (1st, 5th, 9th from the janma lagna) as especially auspicious windows.
- Visualize as an hourly chartEach slot maps to a time window — render it as a colour band on a 24-hour timeline.
- Localize sign namesThe `sign` field is locale-resolved — pass ?locale=hi to receive sign names in Hindi (e.g. धनु), ?locale=ta for Tamil, ?locale=mr for Marathi, etc. Use `index` for logic, not the name.
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://lifeastroapi.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 1,500 free credits. Sign up.