Copy page

Copy page as Markdown for LLMs

View as Markdown

View this page as plain text


Open in ChatGPT

Ask ChatGPT about this page

Open in Claude

Ask Claude about this page

Lal Kitab Varshphal Chart API

Access Lal Kitab Varshphal Chart from the DivineAPI Lal Kitab suite. Based on the principles of Lal Kitab (the Red Book of Vedic astrology), this endpoint returns the annual Lal Kitab Varshphal chart as an image and data for the provided birth details and Varshphal year.


API Endpoint

POST https://astroapi-3.divineapi.com/indian-api/v1/lal-kitab/varshphal/chart

Returns the requested Lal Kitab data in the response.


Supported Language Codes

You can localize the API response by passing the lan parameter in the request body.

CodeLanguage
enEnglish
hiHindi
bnBengali
maMarathi
tmTamil
tlTelugu
mlMalayalam
knKannada

Support Article: Translating Vedic APIs into Different Languages


Headers

NameTypeDescription
Authorization *StringYour API Access Token, e.g. Bearer {token}

Request Body

NameTypeDescription
api_key *StringYour API key
full_name *StringFull name, e.g. Rahul Kumar
day *IntegerDate of birth, e.g. 24
month *IntegerMonth of birth, e.g. 05
year *IntegerYear of birth, e.g. 2023
hour *IntegerHour (24-hour format), e.g. 14
min *IntegerMinute, e.g. 40
sec *IntegerSecond, e.g. 43
gender *StringGender, e.g. male
place *StringPlace of birth, e.g. New Delhi
lat *FloatLatitude, e.g. 28.7041
lon *FloatLongitude, e.g. 77.1025
tzone *FloatTimezone, e.g. 5.5 — See Timezone List
lanStringLanguage code as per the table above; default is en
varshphal_year *IntegerThe year for the annual (Varshphal) chart, e.g. 2026.

200: OK Lal Kitab Varshphal Chart Fetched Successfully

{
    "success": 1,
    "data": {
        "varshphal_year": 2026,
        "varsha_pravesh": "2026-05-24 20:10:43",
        "svg": "<svg height=\"360\" width=\"360\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n    \n    \n    <rect x=\"0\" y=\"0\" width=\"360\" height=\"360\" fill=\"transparent\" stroke=\"#000\" stroke-width=\"4\"></rect>\n\t<line x1=\"0\" y1=\"0\" x2=\"360\" y2=\"360\" stroke=\"#000\" stroke-width=\"2\"></line>\n\t<line x1=\"0\" y1=\"360\" x2=\"360\" y2=\"0\" stroke=\"#000\" stroke-width=\"2\"></line>\n\t<line x1=\"0\" y1=\"180\" x2=\"180\" y2=\"0\" stroke=\"#000\" stroke-width=\"2\"></line>\n\t<line x1=\"180\" y1=\"0\" x2=\"360\" y2=\"180\" stroke=\"#000\" stroke-width=\"2\"></line>\n\t<line x1=\"360\" y1=\"180\" x2=\"180\" y2=\"360\" stroke=\"#000\" stroke-width=\"2\"></line>\n\t<line x1=\"0\" y1=\"180\" x2=\"180\" y2=\"360\" stroke=\"#000\" stroke-width=\"2\"></line>\n\n    \n\n    <text x=\"180\" y=\"164\" text-anchor=\"middle\" style=\"fill:#000; font-size:12px;\" font-family=\"Tahoma, sans-serif\">1</text>\n    <text x=\"90\" y=\"76\" text-anchor=\"middle\" style=\"fill:#000; font-size:12px;\" font-family=\"Tahoma, sans-serif\">2</text>\n    <text x=\"68\" y=\"94\" text-anchor=\"middle\" style=\"fill:#000; font-size:12px;\" font-family=\"Tahoma, sans-serif\">3</text>\n    <text x=\"159\" y=\"184\" text-anchor=\"middle\" style=\"fill:#000; font-size:12px;\" font-family=\"Tahoma, sans-serif\">4</text>\n    <text x=\"68\" y=\"275\" text-anchor=\"middle\" style=\"fill:#000; font-size:12px;\" font-family=\"Tahoma, sans-serif\">5</text>\n    <text x=\"90\" y=\"295\" text-anchor=\"middle\" style=\"fill:#000; font-size:12px;\" font-family=\"Tahoma, sans-serif\">6</text>\n    <text x=\"179\" y=\"207\" text-anchor=\"middle\" style=\"fill:#000; font-size:12px;\" font-family=\"Tahoma, sans-serif\">7</text>\n    <text x=\"270\" y=\"295\" text-anchor=\"middle\" style=\"fill:#000; font-size:12px;\" font-family=\"Tahoma, sans-serif\">8</text>\n    <text x=\"288\" y=\"273\" style=\"fill:#000; font-size:12px;\" font-family=\"Tahoma, sans-serif\">9</text>\n    <text x=\"198\" y=\"185\" style=\"fill:#000; font-size:12px;\" font-family=\"Tahoma, sans-serif\">10</text>\n    <text x=\"288\" y=\"94\" style=\"fill:#000; font-size:12px;\" font-family=\"Tahoma, sans-serif\">11</text>\n    <text x=\"270\" y=\"76\" text-anchor=\"middle\" style=\"fill:#000; font-size:12px;\" font-family=\"Tahoma, sans-serif\">12</text>\n\n\n    \n        \n    \n        \n    \n        \n    \n                <text x=\"84\" y=\"174.5\" style=\"fill:#000; font-size:12px;\" font=\"Tahoma\" font-family=\"sans-serif\">Ra</text>\n                            \n    \n                <text x=\"10\" y=\"272\" style=\"fill:#000; font-size:12px;\" font=\"Tahoma\" font-family=\"sans-serif\">Sa</text>\n                            \n    \n                <text x=\"77.5\" y=\"350\" style=\"fill:#000; font-size:12px;\" font=\"Tahoma\" font-family=\"sans-serif\">Ma</text>\n                            \n    \n                <text x=\"154\" y=\"272\" style=\"fill:#000; font-size:12px;\" font=\"Tahoma\" font-family=\"sans-serif\">Su</text>\n                                    <text x=\"179\" y=\"272\" style=\"fill:#000; font-size:12px;\" font=\"Tahoma\" font-family=\"sans-serif\">Me</text>\n                            \n    \n                <text x=\"244\" y=\"350\" style=\"fill:#000; font-size:12px;\" font=\"Tahoma\" font-family=\"sans-serif\">Ve</text>\n                                    <text x=\"269\" y=\"350\" style=\"fill:#000; font-size:12px;\" font=\"Tahoma\" font-family=\"sans-serif\">Ju</text>\n                            \n    \n        \n    \n                <text x=\"270\" y=\"170\" style=\"fill:#000; font-size:12px;\" font=\"Tahoma\" font-family=\"sans-serif\">Mo</text>\n                                    <text x=\"270\" y=\"195\" style=\"fill:#000; font-size:12px;\" font=\"Tahoma\" font-family=\"sans-serif\">Ke</text>\n                            \n    \n        \n    \n        \n</svg>\n\n\n",
        "base64_image": "data:image/svg+xml;base64,PHN2ZyBoZWlnaHQ9IjM2MCIgd2lkdGg9IjM2MCIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB4bWxuczp4bGluaz0iaHR0cDovL3d3dy53My5vcmcvMTk5OS94bGluayI+CiAgICAKICAgIAogICAgPHJlY3QgeD0iMCIgeT0iMCIgd2lkdGg9IjM2MCIgaGVpZ2h0PSIzNjAiIGZpbGw9InRyYW5zcGFyZW50IiBzdHJva2U9IiMwMDAiIHN0cm9rZS13aWR0aD0iNCI+PC9yZWN0PgoJPGxpbmUgeDE9IjAiIHkxPSIwIiB4Mj0iMzYwIiB5Mj0iMzYwIiBzdHJva2U9IiMwMDAiIHN0cm9rZS13aWR0aD0iMiI+PC9saW5lPgoJPGxpbmUgeDE9IjAiIHkxPSIzNjAiIHgyPSIzNjAiIHkyPSIwIiBzdHJva2U9IiMwMDAiIHN0cm9rZS13aWR0aD0iMiI+PC9saW5lPgoJPGxpbmUgeDE9IjAiIHkxPSIxODAiIHgyPSIxODAiIHkyPSIwIiBzdHJva2U9IiMwMDAiIHN0cm9rZS13aWR0aD0iMiI+PC9saW5lPgoJPGxpbmUgeDE9IjE4MCIgeTE9IjAiIHgyPSIzNjAiIHkyPSIxODAiIHN0cm9rZT0iIzAwMCIgc3Ryb2tlLXdpZHRoPSIyIj48L2xpbmU+Cgk8bGluZSB4MT0iMzYwIiB5MT0iMTgwIiB4Mj0iMTgwIiB5Mj0iMzYwIiBzdHJva2U9IiMwMDAiIHN0cm9rZS13aWR0aD0iMiI+PC9saW5lPgoJPGxpbmUgeDE9IjAiIHkxPSIxODAiIHgyPSIxODAiIHkyPSIzNjAiIHN0cm9rZT0iIzAwMCIgc3Ryb2tlLXdpZHRoPSIyIj48L2xpbmU+CgogICAgCgogICAgPHRleHQgeD0iMTgwIiB5PSIxNjQiIHRleHQtYW5jaG9yPSJtaWRkbGUiIHN0eWxlPSJmaWxsOiMwMDA7IGZvbnQtc2l6ZToxMnB4OyIgZm9udC1mYW1pbHk9IlRhaG9tYSwgc2Fucy1zZXJpZiI+MTwvdGV4dD4KICAgIDx0ZXh0IHg9IjkwIiB5PSI3NiIgdGV4dC1hbmNob3I9Im1pZGRsZSIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IiBmb250LWZhbWlseT0iVGFob21hLCBzYW5zLXNlcmlmIj4yPC90ZXh0PgogICAgPHRleHQgeD0iNjgiIHk9Ijk0IiB0ZXh0LWFuY2hvcj0ibWlkZGxlIiBzdHlsZT0iZmlsbDojMDAwOyBmb250LXNpemU6MTJweDsiIGZvbnQtZmFtaWx5PSJUYWhvbWEsIHNhbnMtc2VyaWYiPjM8L3RleHQ+CiAgICA8dGV4dCB4PSIxNTkiIHk9IjE4NCIgdGV4dC1hbmNob3I9Im1pZGRsZSIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IiBmb250LWZhbWlseT0iVGFob21hLCBzYW5zLXNlcmlmIj40PC90ZXh0PgogICAgPHRleHQgeD0iNjgiIHk9IjI3NSIgdGV4dC1hbmNob3I9Im1pZGRsZSIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IiBmb250LWZhbWlseT0iVGFob21hLCBzYW5zLXNlcmlmIj41PC90ZXh0PgogICAgPHRleHQgeD0iOTAiIHk9IjI5NSIgdGV4dC1hbmNob3I9Im1pZGRsZSIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IiBmb250LWZhbWlseT0iVGFob21hLCBzYW5zLXNlcmlmIj42PC90ZXh0PgogICAgPHRleHQgeD0iMTc5IiB5PSIyMDciIHRleHQtYW5jaG9yPSJtaWRkbGUiIHN0eWxlPSJmaWxsOiMwMDA7IGZvbnQtc2l6ZToxMnB4OyIgZm9udC1mYW1pbHk9IlRhaG9tYSwgc2Fucy1zZXJpZiI+NzwvdGV4dD4KICAgIDx0ZXh0IHg9IjI3MCIgeT0iMjk1IiB0ZXh0LWFuY2hvcj0ibWlkZGxlIiBzdHlsZT0iZmlsbDojMDAwOyBmb250LXNpemU6MTJweDsiIGZvbnQtZmFtaWx5PSJUYWhvbWEsIHNhbnMtc2VyaWYiPjg8L3RleHQ+CiAgICA8dGV4dCB4PSIyODgiIHk9IjI3MyIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IiBmb250LWZhbWlseT0iVGFob21hLCBzYW5zLXNlcmlmIj45PC90ZXh0PgogICAgPHRleHQgeD0iMTk4IiB5PSIxODUiIHN0eWxlPSJmaWxsOiMwMDA7IGZvbnQtc2l6ZToxMnB4OyIgZm9udC1mYW1pbHk9IlRhaG9tYSwgc2Fucy1zZXJpZiI+MTA8L3RleHQ+CiAgICA8dGV4dCB4PSIyODgiIHk9Ijk0IiBzdHlsZT0iZmlsbDojMDAwOyBmb250LXNpemU6MTJweDsiIGZvbnQtZmFtaWx5PSJUYWhvbWEsIHNhbnMtc2VyaWYiPjExPC90ZXh0PgogICAgPHRleHQgeD0iMjcwIiB5PSI3NiIgdGV4dC1hbmNob3I9Im1pZGRsZSIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IiBmb250LWZhbWlseT0iVGFob21hLCBzYW5zLXNlcmlmIj4xMjwvdGV4dD4KCgogICAgCiAgICAgICAgCiAgICAKICAgICAgICAKICAgIAogICAgICAgIAogICAgCiAgICAgICAgICAgICAgICA8dGV4dCB4PSI4NCIgeT0iMTc0LjUiIHN0eWxlPSJmaWxsOiMwMDA7IGZvbnQtc2l6ZToxMnB4OyIgZm9udD0iVGFob21hIiBmb250LWZhbWlseT0ic2Fucy1zZXJpZiI+UmE8L3RleHQ+CiAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgIAogICAgICAgICAgICAgICAgPHRleHQgeD0iMTAiIHk9IjI3MiIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IiBmb250PSJUYWhvbWEiIGZvbnQtZmFtaWx5PSJzYW5zLXNlcmlmIj5TYTwvdGV4dD4KICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgCiAgICAgICAgICAgICAgICA8dGV4dCB4PSI3Ny41IiB5PSIzNTAiIHN0eWxlPSJmaWxsOiMwMDA7IGZvbnQtc2l6ZToxMnB4OyIgZm9udD0iVGFob21hIiBmb250LWZhbWlseT0ic2Fucy1zZXJpZiI+TWE8L3RleHQ+CiAgICAgICAgICAgICAgICAgICAgICAgICAgICAKICAgIAogICAgICAgICAgICAgICAgPHRleHQgeD0iMTU0IiB5PSIyNzIiIHN0eWxlPSJmaWxsOiMwMDA7IGZvbnQtc2l6ZToxMnB4OyIgZm9udD0iVGFob21hIiBmb250LWZhbWlseT0ic2Fucy1zZXJpZiI+U3U8L3RleHQ+CiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIDx0ZXh0IHg9IjE3OSIgeT0iMjcyIiBzdHlsZT0iZmlsbDojMDAwOyBmb250LXNpemU6MTJweDsiIGZvbnQ9IlRhaG9tYSIgZm9udC1mYW1pbHk9InNhbnMtc2VyaWYiPk1lPC90ZXh0PgogICAgICAgICAgICAgICAgICAgICAgICAgICAgCiAgICAKICAgICAgICAgICAgICAgIDx0ZXh0IHg9IjI0NCIgeT0iMzUwIiBzdHlsZT0iZmlsbDojMDAwOyBmb250LXNpemU6MTJweDsiIGZvbnQ9IlRhaG9tYSIgZm9udC1mYW1pbHk9InNhbnMtc2VyaWYiPlZlPC90ZXh0PgogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICA8dGV4dCB4PSIyNjkiIHk9IjM1MCIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IiBmb250PSJUYWhvbWEiIGZvbnQtZmFtaWx5PSJzYW5zLXNlcmlmIj5KdTwvdGV4dD4KICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgCiAgICAgICAgCiAgICAKICAgICAgICAgICAgICAgIDx0ZXh0IHg9IjI3MCIgeT0iMTcwIiBzdHlsZT0iZmlsbDojMDAwOyBmb250LXNpemU6MTJweDsiIGZvbnQ9IlRhaG9tYSIgZm9udC1mYW1pbHk9InNhbnMtc2VyaWYiPk1vPC90ZXh0PgogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICA8dGV4dCB4PSIyNzAiIHk9IjE5NSIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IiBmb250PSJUYWhvbWEiIGZvbnQtZmFtaWx5PSJzYW5zLXNlcmlmIj5LZTwvdGV4dD4KICAgICAgICAgICAgICAgICAgICAgICAgICAgIAogICAgCiAgICAgICAgCiAgICAKICAgICAgICAKPC9zdmc+CgoK"
    }
}

Code Integration Examples

Below are examples for using this API in different programming environments.


cURL Example

curl --location 'https://astroapi-3.divineapi.com/indian-api/v1/lal-kitab/varshphal/chart' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'full_name="Test"' \
--form 'day="24"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'hour="14"' \
--form 'min="40"' \
--form 'sec="43"' \
--form 'gender="male"' \
--form 'place="New Delhi"' \
--form 'lat="28.7041"' \
--form 'lon="77.1025"' \
--form 'tzone="5.5"' \
--form 'varshphal_year="2026"' \
--form 'lan="en"' \

NodeJS Example

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-3.divineapi.com/indian-api/v1/lal-kitab/varshphal/chart',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'full_name': 'Test',
    'day': '24',
    'month': '05',
    'year': '2023',
    'hour': '14',
    'min': '40',
    'sec': '43',
    'gender': 'male',
    'place': 'New Delhi',
    'lat': '28.7041',
    'lon': '77.1025',
    'tzone': '5.5',
    'varshphal_year': '2026',
    'lan': 'en'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

JavaScript (jQuery AJAX) Example

var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("full_name", "Test");
form.append("day", "24");
form.append("month", "05");
form.append("year", "2023");
form.append("hour", "14");
form.append("min", "40");
form.append("sec", "43");
form.append("gender", "male");
form.append("place", "New Delhi");
form.append("lat", "28.7041");
form.append("lon", "77.1025");
form.append("tzone", "5.5");
form.append("varshphal_year", "2026");
form.append("lan", "en");

var settings = {
  "url": "https://astroapi-3.divineapi.com/indian-api/v1/lal-kitab/varshphal/chart",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {Your Auth Token}"
  },
  "processData": false,
  "mimeType": "multipart/form-data",
  "contentType": false,
  "data": form
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Python Example

import requests

url = "https://astroapi-3.divineapi.com/indian-api/v1/lal-kitab/varshphal/chart"

payload = {'api_key': '{Your API Key}',
'full_name': 'Test',
'day': '24',
'month': '05',
'year': '2023',
'hour': '14',
'min': '40',
'sec': '43',
'gender': 'male',
'place': 'New Delhi',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5',
'varshphal_year': '2026',
    'lan': 'en'}

headers = {
  'Authorization': 'Bearer {Your Auth Token}'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)


This API serves as a foundation for further astrological computations, including Kundli generation, planetary charts, yogas, and personalized reports. It provides all key birth-time astrological parameters such as tithi, nakshatra, rashi, yoga, karana, varna, gana, and planetary influences, essential for deeper Vedic analysis.