Kundli API Documentation for BASIC PLAN

 

Lagn Chart | Planetary Degrees & other Details | Planet Chart APIs (moon chart) | D9 Navamsha Chart | Vinshottari Mahadasha | Vinshottari Antardasha

Get Kundli Parameters

Kundli.Click REST Web Service Interface

Since the Kundli.Click Kundli API is based on REST principles, its very easy to write and test applications. You can use your browser to access URLs, and you can use pretty much any HTTP client in any programming language to interact with our Kundli API.

API Endpoint

All API URLs listed in this documentation are relative to https://api.kundli.click/v0.4/
For example - the /chart-asc API call is reachable at-
https://api.kundli.click/v0.4/chart-asc

RESTful

All Kundli.Click Kundli APIs are RESTful APIs. Following are the known caveats -

  1. All API calls should be made with HTTPS POST unless mentioned otherwise.
  2. Response status other than HTTP 200 can be considered as an error.
  3. BOTH userid & authcode parameters are Must for every API call.

Passing Requested Data RESTfully

Request data is passed to the API by POST parameters OR by CURL POST method to the API endpoints with the appropriate parameters. The documentation for each API call will contain more detail on the parameters accepted by the call. As an alternative, you can also use HTTP POST parameters, just like submitting an HTML FORM.

Output Format

Response data for each and every Kundli.Click Kundli API will be encoded in JSON format.

Authentication

This version of Kundli.Click doesnt Require Authentication by header authentication Call, But userid & authcode BOTH parameters are Compulsarily required in all Requests for successfull Response.
AuthCode and UserId has been mailed to you and your Plan has already been Activate. Please Check your Registered mail for details.

1. Ascendant / Lagn Chart APIs

Provides data points for Kundli elements ascendant chart at provided date, time, latitude, longitude & timezone combination. (see response section for compete list)

API Endpoint

					
	https://api.kundli.click/v0.4/chart-asc

Method & URL

MethodFull URL
POST https://api.kundli.click/v0.4/chart-asc

Input Variables

Ascendant Lagn Chart at specified date, time, lat, lon & timezone
All the Input Variable Listed here are Compulsary for the API to work.

  1. Date
    Variable Name : d
    FORMAT : DD/MM/YYYY
    Example : 31/03/2025

  2. Time
    Variable Name : t
    FORMAT : HH:MM:SS
    Example : 21:27:21

  3. Latitude
    Variable Name : lat
    FORMAT : decimal
    Default Value : +25.15
    Example : +28.70 {For Delhi}

  4. Longitude
    Variable Name : lon
    FORMAT : decimal
    Default Value : +82.50
    Example : +77.10 {For Delhi}

  5. TimeZone (OPTIONAL for IST/India Timezone)
    Variable Name : tz
    FORMAT : decimal
    Example : +5.5 {For INDIA}

  6. UserID
    Variable Name : userid
    FORMAT : Text String
    Example : myXYZUserid
    {UserId has been provided to you via Email on Activation of your API Account. If not Please Contact us via Email/Call.}

  7. Authorization Code
    Variable Name : authcode
    FORMAT : Alpha Numeric Text String
    Example : AuthCodeString00110011ABCXYZdefuvw
    {AuthCode has been provided to you via Email on Activation of your API Account. If not Please Contact us via Email/Call.}

Request String

					
	POST URL : https://api.kundli.click/v0.4/chart-asc
	POST DATA: d={DateOfBirth}&t={TimeOfBirth}&lat={LatitudeOfBirth}&lon={LongitudeOfBirth}&tz={TimeZoneOfBirth}&userid={userid}&authcode={authcode}
Example
					
	POST URL : https://api.kundli.click/v0.4/chart-asc
	POST DATA: d=31/03/2025&t=21:27:21&lat=+28.70&lon=+77.10&tz=+5.5&userid=youruserid&authcode=AuthCodeString00110011ABCXYZdefuvw

Response Data

					
{
    "url": "https://api.kundli.click/v0.4/graphics/getchart?w=400&h=300&chart=1,8,5,11,8,8,7,9,4,10",
    "datastring": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZAAAAEsCAIAAABi1XKVAAAV9klEQVR4nO2dPZIjx7VGEy9mAzRoUyugSxPUHuQiniWbS9BwCWPTegGZ2sMIplytYGjTmCXgGTnMrs76QVVW/tyfc2JCQqObQ3T34XfvzUpkXb4EAAAd/M/oFwAAsJcP8f++/Pvf8cH1e..........b5bTTAAAAAElFTkSuQmCC"
}

Response Explained

What the Response is this!! Ok Let us Explain. Here are all the Output Responses Explained.

  1. Image Access URL
    Variable Name : url
    FORMAT : url string
    Example Value : https://api.kundli.click/v0.4/graphics/getchart?w=400&h=300&chart=1,8,5,11,8,8,7,9,4,10

  2. Image as base64 Data String
    Variable Name : datastring
    FORMAT : Image encoded as a base64 Data String
    Example Value : data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZAAAAEsCAIAAABi1XKVA.......




2. Planetary Degrees

Provides saayan planetary degrees as per the astrological needs ranging from 0 - 359.99 . (see response section for compete list)

API Endpoint

					
	https://api.kundli.click/v0.4/planets

Method & URL

MethodFull URL
POST https://api.kundli.click/v0.4/planets

Input Variables

Planetary degrees based upon birth details at specified date, time, lat, lon & timezone
All the Input Variable Listed here are Compulsary for the API to work.

  1. Date
    Variable Name : d
    FORMAT : DD/MM/YYYY
    Example : 31/03/2025

  2. Time
    Variable Name : t
    FORMAT : HH:MM:SS
    Example : 21:27:21

  3. Latitude
    Variable Name : lat
    FORMAT : decimal
    Default Value : +25.15
    Example : +28.70 {For Delhi}

  4. Longitude
    Variable Name : lon
    FORMAT : decimal
    Default Value : +82.50
    Example : +77.10 {For Delhi}

  5. TimeZone (OPTIONAL for IST/India Timezone)
    Variable Name : tz
    FORMAT : decimal
    Example : +5.5 {For INDIA}

  6. UserID
    Variable Name : userid
    FORMAT : Text String
    Example : myXYZUserid
    {UserId has been provided to you via Email on Activation of your API Account. If not Please Contact us via Email/Call.}

  7. Authorization Code
    Variable Name : authcode
    FORMAT : Alpha Numeric Text String
    Example : AuthCodeString00110011ABCXYZdefuvw
    {AuthCode has been provided to you via Email on Activation of your API Account. If not Please Contact us via Email/Call.}

Request String

					
	POST URL : https://api.kundli.click/v0.4/planets
	POST DATA: d={DateOfBirth}&t={TimeOfBirth}&lat={LatitudeOfBirth}&lon={LongitudeOfBirth}&tz={TimeZoneOfBirth}&userid={userid}&authcode={authcode}
Example
					
	POST URL : https://api.kundli.click/v0.4/planets
	POST DATA: d=31/03/2025&t=21:27:21&lat=+28.70&lon=+77.10&tz=+5.5&userid=youruserid&authcode=AuthCodeString00110011ABCXYZdefuvw

Response Data

					
{
    "planets_assoc": {
        "ASCENDENT": 250.99910012003,
        "SUN": 28.532502655904,
        "MOON": 140.32594702442,
        "MARS": 64.447234542535,
        "MERCURY": 19.722763675942,
        "JUPITER": 238.57837860854,
        "VENUS": 3.8132816295344,
        "SATURN": 266.29754661369,
        "RAHU": 86.41247921848,
        "KETU": 266.41247921848
    }
}

Response Explained

What the Response is this!! Ok Let us Explain. Here are all the Output Responses Explained.

  1. Planetary Degrees
    Variable Name : "planets_assoc"
    FORMAT : JSON Key-Value Set
    Example Value : 

        "planets_assoc": {
        "ASCENDENT": 250.99910012003,
        "SUN": 28.532502655904,
        "MOON": 140.32594702442,
        "MARS": 64.447234542535,
        "MERCURY": 19.722763675942,
        "JUPITER": 238.57837860854,
        "VENUS": 3.8132816295344,
        "SATURN": 266.29754661369,
        "RAHU": 86.41247921848,
        "KETU": 266.41247921848
    }







4. Planet Chart APIs (moon chart)

Provides data points for Kundli element of Planetary charts at provided date, time, latitude, longitude & timezone combination. (see response section for complete list)

API Endpoint

					
	https://api.kundli.click/v0.4/chart-planet

Method & URL

MethodFull URL
POST https://api.kundli.click/v0.4/chart-planet

Input Variables

Planet Chart at specified date, time, lat, lon & timezone
All the Input Variable Listed here are Compulsary for the API to work.

  1. Date
    Variable Name : d
    FORMAT : DD/MM/YYYY
    Example : 31/03/2025

  2. Time
    Variable Name : t
    FORMAT : HH:MM:SS
    Example : 21:27:21

  3. Latitude
    Variable Name : lat
    FORMAT : decimal
    Default Value : +25.15
    Example : +28.70 {For Delhi}

  4. Longitude
    Variable Name : lon
    FORMAT : decimal
    Default Value : +82.50
    Example : +77.10 {For Delhi}

  5. TimeZone (OPTIONAL for IST/India Timezone)
    Variable Name : tz
    FORMAT : decimal
    Example : +5.5 {For INDIA}

  6. Planet Number
    Variable Name : plnt_no
    FORMAT : Text String
    Default Value : 2 (for moon chart)
    Example : 2 (for moon chart)1=sun, 2=moon, 3=mars, 4=mercury, 5=jupiter, 6=venus, 7=saturn, 8=rahu, 9=ketu

  7. UserID
    Variable Name : userid
    FORMAT : Text String
    Example : myXYZUserid
    {UserId has been provided to you via Email on Activation of your API Account. If not Please Contact us via Email/fb/twitter.}

  8. Authorization Code
    Variable Name : authcode
    FORMAT : Alpha Numeric Text String
    Example : AuthCodeString00110011ABCXYZdefuvw
    {AuthCode has been provided to you via Email on Activation of your API Account. If not Please Contact us via Email/fb/twitter.}

  9. Language
    Variable Name : lang
    FORMAT : Alphabet
    Example : en | hi
    {en for English Language. hi for Hindi Language.}

  10. Planet Name; MOON Chart for your case
    Variable Name : plnt_no
    FORMAT : Number
    Example : 2
    {2 is the only value it will take}

Request String

					
	POST URL : https://api.kundli.click/v0.4/chart-planet
	POST DATA: d={DateOfBirth}&t={TimeOfBirth}&lat={LatitudeOfBirth}&lon={LongitudeOfBirth}&tz={TimeZoneOfBirth}&plnt_no={PlanetNumber}&userid={userid}&authcode={authcode}&lang={Language}&plnt_no={2}
Example
					
	POST URL : https://api.kundli.click/v0.4/chart-planet
	POST DATA: d=31/03/2025&t=21:27:21&lat=+28.70&lon=+77.10&tz=+5.5&plnt_no=2&userid=youruserid&authcode=AuthCodeString00110011ABCXYZdefuvw&lang=hi&plnt_no=2

Response Data

					
{
    "url": "https://api.kundli.click/v0.4/graphics/getchart?w=400&h=300&chart=5,4,2,7,2,3,4,1,1,7,8,8,8",
    "datastring": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZAAAAEsCAIAAABi1XKVAAAV9klEQVR4nO2dPZIjx7VGEy9mAzRoUyugSxPUHuQiniWbS9BwCWPTegGZ2sMIplytYGjTmCXgGTnMrs76QVVW/tyfc2JCQqObQ3T34XfvzUpkXb4EAAAd/M/oFwAAsJcP8f++/Pvf8cH1e..........b5bTTAAAAAElFTkSuQmCC"
}

Response Explained

What the Response is this!! Ok Let us Explain. Here are all the Output Responses Explained.

  1. Image Access URL
    Variable Name : url
    FORMAT : url string
    Example Value : https://api.kundli.click/v0.4/graphics/getchart?w=400&h=300&chart=5,4,2,7,2,3,4,1,1,7,8,8,8

  2. Image as base64 Data String
    Variable Name : datastring
    FORMAT : Image encoded as a base64 Data String
    Example Value : data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZAAAAEsCAIAAABi1XKVA.......




5. Vinshottari Mahadasha

Provides Vinshottari Mahadasha as per the Chart of the input given. (see response section for compete list)

API Endpoint

					
	https://api.kundli.click/v0.4/vinshottari-mahadasha

Method & URL

MethodFull URL
POST https://api.kundli.click/v0.4/vinshottari-mahadasha

Input Variables

Vinshottari Mahadasha based upon birth details at specified date, time, lat, lon & timezone
All the Input Variable Listed here are Compulsary for the API to work.

  1. Date
    Variable Name : d
    FORMAT : DD/MM/YYYY
    Example : 31/03/2025

  2. Time
    Variable Name : t
    FORMAT : HH:MM:SS
    Example : 21:27:21

  3. Latitude
    Variable Name : lat
    FORMAT : decimal
    Default Value : +25.15
    Example : +28.70 {For Delhi}

  4. Longitude
    Variable Name : lon
    FORMAT : decimal
    Default Value : +82.50
    Example : +77.10 {For Delhi}

  5. TimeZone (OPTIONAL for IST/India Timezone)
    Variable Name : tz
    FORMAT : decimal
    Example : +5.5 {For INDIA}

  6. UserID
    Variable Name : userid
    FORMAT : Text String
    Example : myXYZUserid
    {UserId has been provided to you via Email on Activation of your API Account. If not Please Contact us via Email/Call.}

  7. Authorization Code
    Variable Name : authcode
    FORMAT : Alpha Numeric Text String
    Example : AuthCodeString00110011ABCXYZdefuvw
    {AuthCode has been provided to you via Email on Activation of your API Account. If not Please Contact us via Email/Call.}

Request String

					
	POST URL : https://api.kundli.click/v0.4/vinshottari-mahadasha
	POST DATA: d={DateOfBirth}&t={TimeOfBirth}&lat={LatitudeOfBirth}&lon={LongitudeOfBirth}&tz={TimeZoneOfBirth}&userid={userid}&authcode={authcode}
Example
					
	POST URL : https://api.kundli.click/v0.4/vinshottari-mahadasha
	POST DATA: d=31/03/2025&t=21:27:21&lat=+28.70&lon=+77.10&tz=+5.5&userid=youruserid&authcode=AuthCodeString00110011ABCXYZdefuvw

Response Data

					
[
    {
        "planet": "Moon",
        "from": "08-03-1994 19:20",
        "to": "06-03-2003 09:40"
    },
    {
        "planet": "Mars",
        "from": "06-03-2003 09:40",
        "to": "05-03-2010 09:40"
    },
    {
        "planet": "Rahu",
        "from": "05-03-2010 09:40",
        "to": "04-03-2028 09:40"
    },
    .
    .
    .
    
]

Response Explained

What the Response is this!! Ok Let us Explain. Here are all the Output Responses Explained.

  1. Vinshottari Mahadasha Data
    Variable Name : NONE self explainatory
    FORMAT : Array of JSON Objects of 10 objects complete of 8 planets, 2 partial of 1 planets
    Example Value : 

    
[
    {
        "planet": "Moon",               //this is name of planet whose Vinshottari Mahadasha is
        "from": "08-03-1994 19:20",     //this is From Date of Start of Vinshottari Mahadasha of Planet
        "to": "06-03-2003 09:40"        //this is To Date of End of Vinshottari Mahadasha of Planet
    },
    .
    .
    .
]




6. Vinshottari Antardasha

Provides Vinshottari Antardasha as per the Chart of the input given. (see response section for complete list)

API Endpoint

					
	https://api.kundli.click/v0.4/vinshottari-antardasha

Method & URL

MethodFull URL
POST https://api.kundli.click/v0.4/vinshottari-antardasha

Input Variables

Vinshottari antardasha based upon birth details at specified date, time, lat, lon, timezone & mahadasha
All the Input Variable Listed here are Compulsary for the API to work.

  1. Date
    Variable Name : d
    FORMAT : DD/MM/YYYY
    Example : 31/03/2025

  2. Time
    Variable Name : t
    FORMAT : HH:MM:SS
    Example : 21:27:21

  3. Latitude
    Variable Name : lat
    FORMAT : decimal
    Default Value : +25.15
    Example : +28.70 {For Delhi}

  4. Longitude
    Variable Name : lon
    FORMAT : decimal
    Default Value : +82.50
    Example : +77.10 {For Delhi}

  5. TimeZone (OPTIONAL for IST/India Timezone)
    Variable Name : tz
    FORMAT : decimal
    Example : +5.5 {For INDIA}

  6. UserID
    Variable Name : userid
    FORMAT : Text String
    Example : myXYZUserid
    {UserId has been provided to you via Email on Activation of your API Account. If not Please Contact us via Email/Call.}

  7. Authorization Code
    Variable Name : authcode
    FORMAT : Alpha Numeric Text String
    Example : AuthCodeString00110011ABCXYZdefuvw
    {AuthCode has been provided to you via Email on Activation of your API Account. If not Please Contact us via Email/Call.}

  8. Language
    Variable Name : lang
    FORMAT : Alphabet
    Example : en | hi
    {en for English Language. hi for Hindi Language.}

  9. Mahadasha
    Variable Name : mahadasha
    FORMAT : Numeric
    Example : 0-8
    {Mahadasha serial number to which antardasha is required to be fetched.}

Request String

					
	POST URL : https://api.kundli.click/v0.4/vinshottari-antardasha
	POST DATA: d={DateOfBirth}&t={TimeOfBirth}&lat={LatitudeOfBirth}&lon={LongitudeOfBirth}&tz={TimeZoneOfBirth}&userid={userid}&authcode={authcode}&lang={Language}&mahadasha={SNoMahadasha}
Example
					
	POST URL : https://api.kundli.click/v0.4/vinshottari-antardasha
	POST DATA: d=31/03/2025&t=21:27:21&lat=+28.70&lon=+77.10&tz=+5.5&userid=youruserid&authcode=AuthCodeString00110011ABCXYZdefuvw&lang=hi&mahadasha=2

Response Data

					
[
    {
        "planet": "Moon",
        "from": "08-03-1994 19:20",
        "to": "06-03-2003 09:40"
    },
    {
        "planet": "Mars",
        "from": "06-03-2003 09:40",
        "to": "05-03-2010 09:40"
    },
    {
        "planet": "Rahu",
        "from": "05-03-2010 09:40",
        "to": "04-03-2028 09:40"
    },
    .
    .
    .
    
]

Response Explained

What the Response is this!! Ok Let us Explain. Here are all the Output Responses Explained.

  1. Vinshottari antardasha Data
    Variable Name : NONE self explainatory
    FORMAT : Array of JSON Objects of 9 objects complete of 8 planets
    Example Value : 

    
[
    {
        "planet": "Moon",               //this is name of planet whose Vinshottari antardasha is
        "from": "08-03-1994 19:20",     //this is From Date of Start of Vinshottari antardasha of Planet
        "to": "06-03-2003 09:40"        //this is To Date of End of Vinshottari antardasha of Planet
    },
    .
    .
    .
]