Documentation

Introduction

The Panchangam API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

The API key you use to authenticate the request determines whether the request is live mode or test mode.

The Panchangam API is currently in Alpha testing mode. We are continously Improving the api experience and the documentation.

We would like to warn developers to excersie caution as frequesnt changes might break your applications. Developers are requested to review all the documentation and changelog frequently to know of the changes as we release new versions and tailor functionality.

We also encourage developers and user to provide feedback so as to improve api experience.

Authentication

Subscribe to Portal's API announce mailing list for updates.

endpoints should always be prepended by https://api.astroapi.dev/kundali/v1

request Type Post

As of now we do not permit unauthenticated requests to our api.

So we request the developers to create an account with us and visit their profile page for the auth token.

Get your token Here it's Free

As an auth token is a secret please do not share your token with others. and use ssl while contacting our api.

All request must contain their auth token in the request header

Use curl or wget to try the url

curl --location --request POST 'https://api.astroapi.dev/vedic/v0/kundali/' \
     --header 'Authorization: Token <YOUR SECRET AUTH TOKEN HERE>'

Use request libries for python 3 and python 2

import requests
                      url = "https://api.astroapi.dev/vedic/v0/kundali/"
                      payload = {}
                      headers = {
                      'Authorization': 'Token <YOUR SECRET AUTH TOKEN HERE>'
                      }
                      response = requests.request("POST", url, headers=headers, data = payload)
                      print(response.text.encode('utf8'))

Use request libraries for PHP

<?php
                      include('vendor/rmccue/requests/library/Requests.php');
                      Requests::register_autoloader();
                      $headers = array(
                      'Authorization' => 'Token <YOUR SECRET AUTH TOKEN HERE>'
                      );
                      $response = Requests::get('https://api.astroapi.dev/vedic/v0/kundali/', $headers);

Use request libraries for JAVA

Unirest.setTimeouts(0, 0);
                      HttpResponse response = Unirest.post("https://api.astroapi.dev/vedic/v0/kundali/")
                        .header("Authorization", "Token <YOUR SECRET AUTH TOKEN HERE>")
                        .asString();

Use request libraries for ruby

require 'net/http'
require 'uri'

uri = URI.parse("https://api.astroapi.dev/vedic/v0/kundali/")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Token <YOUR SECRET AUTH TOKEN HERE>"

req_options = {
  use_ssl: uri.scheme == "https",
}

response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(request)
end

Use request libraries for csharp

var client = new RestClient("https://api.astroapi.dev/vedic/v0/kundali/");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Token <YOUR SECRET AUTH TOKEN HERE>");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

Nodejs - Unirest

var unirest = require('unirest');
var req = unirest('POST', 'https://api.astroapi.dev/vedic/v0/kundali/')
  .headers({
    'Authorization': 'Token <YOUR SECRET AUTH TOKEN HERE>'
  })
  .end(function (res) { 
    if (res.error) throw new Error(res.error); 
    console.log(res.raw_body);
  });

Errors

Our API uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicates that a request failed with the information provided (e.g., a required parameter was omitted, etc.). Codes in the 5xx range indicate an error with our servers.

HTTP STATUS CODE

CODE	STATUS	Description
200	OK	Everything worked as expected
400	Bad Request	The request couldn't be completed
401	Unauthorized	No valid API key was provided
404	Not Found	The requested resource could not be found
422	Unprocessable Entity	Values provided are incorrect (e.g. invalid format) or a required parameter is missing
500, 502, 503, 504	Server Errors	Server Error . Try after some time or contact support

Endpoints

Transit vedic/v0/gochar/

Endpoint	`vedic/v0/gochar/`
method
Auth Required	`True`
Parameters	`None`

Code Example:

curl --location --request GET '{api_url}/vedic/v0/gochar/' \
--header 'Authorization: Token {AUTH_TOKEN}'

import requests

url = "{api_url}/vedic/v0/gochar/"

payload = {}
headers = {
  'Authorization': 'Token {AUTH_TOKEN}'
}

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

print(response.text.encode('utf8'))

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('{api_url}/vedic/v0/gochar/');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
  'Authorization' => 'Token {AUTH_TOKEN}'
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("{api_url}/vedic/v0/gochar/")
  .header("Authorization", "Token {AUTH_TOKEN}")
  .asString();

require "uri"
require "net/http"

url = URI("{api_url}/vedic/v0/gochar/")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Get.new(url)
request["Authorization"] = "Token {AUTH_TOKEN}"

response = http.request(request)
puts response.read_body

var client = new RestClient("{api_url}/vedic/v0/gochar/");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Token {AUTH_TOKEN}");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

var request = require('request');
var options = {
  'method': 'GET',
  'url': '{api_url}/vedic/v0/gochar/',
  'headers': {
    'Authorization': 'Token {AUTH_TOKEN}'
  }
};
request(options, function (error, response) { 
  if (error) throw new Error(error);
  console.log(response.body);
});

EXAMPLE JSON API RESPONSE

{
    "ayanamsha": [24, 8, 28],
    "sun": [11, 17, 9, 13],
    "moon": [ 2, 6, 46, 40],
    "mars": [9, 6, 22, 20],
    "mercury": [10, 20, 34, 36],
    "jupiter": [9, 0, 12, 2],
    "venus": [1, 2, 57, 51],
    "saturn": [9, 6, 30, 21],
    "rahu": [2, 9, 18, 40],
    "ketu": [8, 9, 18, 40],
    "uranus": [0, 10, 59, 55],
    "neptune": [10, 25, 6, 43],
    "pluto": [9, 0, 41, 44]
}

Horary vedic/v0/prashna

Endpoint	`vedic/v0/prashna`
method
Auth Required	`True`
Parameters	`latitude`
	`longitude`
	`Place Name (Optional)`

Code Example:

curl --location --request GET '{api_url}/vedic/v0/prashna/' \
--header 'Authorization: Token {AUTH_TOKEN}' \
--header 'Content-Type: application/json' \
--data-raw '{
"lat":23.259933,
"lon":77.412613,
"place":""
}'

import requests

url = "{api_url}/vedic/v0/prashna/"

payload = "{\n\"lat\":23.259933,\n\"lon\":77.412613,\n\"place\":\"\"\n}"
headers = {
  'Authorization': 'Token {AUTH_TOKEN}',
  'Content-Type': 'application/json'
}

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

print(response.text.encode('utf8'))

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('{api_url}/vedic/v0/prashna/');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
  'Authorization' => 'Token {AUTH_TOKEN}',
  'Content-Type' => 'application/json'
));
$request->setBody('{\n"lat":23.259933,\n"lon":77.412613,\n"place":""\n}');
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("{api_url}/vedic/v0/prashna/")
  .header("Authorization", "Token {AUTH_TOKEN}")
  .header("Content-Type", "application/json")
  .body("{\n\"lat\":23.259933,\n\"lon\":77.412613,\n\"place\":\"\"\n}")
  .asString();

require "uri"
require "net/http"

url = URI("{api_url}/vedic/v0/prashna/")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Get.new(url)
request["Authorization"] = "Token {AUTH_TOKEN}"
request["Content-Type"] = "application/json"
request.body = "{\n\"lat\":23.259933,\n\"lon\":77.412613,\n\"place\":\"\"\n}"

response = http.request(request)
puts response.read_body

var client = new RestClient("{api_url}/vedic/v0/prashna/");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Token {AUTH_TOKEN}");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n\"lat\":23.259933,\n\"lon\":77.412613,\n\"place\":\"\"\n}",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

var request = require('request');
var options = {
  'method': 'GET',
  'url': '{api_url}/vedic/v0/prashna/',
  'headers': {
    'Authorization': 'Token {AUTH_TOKEN}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({"lat":23.259933,"lon":77.412613,"place":""})

};
request(options, function (error, response) { 
  if (error) throw new Error(error);
  console.log(response.body);
});

EXAMPLE JSON API RESPONSE

{
    "ayanamsha": [24, 8, 28],
    "sun": [11, 17, 9, 13],
    "moon": [ 2, 6, 46, 40],
    "mars": [9, 6, 22, 20],
    "mercury": [10, 20, 34, 36],
    "jupiter": [9, 0, 12, 2],
    "venus": [1, 2, 57, 51],
    "saturn": [9, 6, 30, 21],
    "rahu": [2, 9, 18, 40],
    "ketu": [8, 9, 18, 40],
    "uranus": [0, 10, 59, 55],
    "neptune": [10, 25, 6, 43],
    "pluto": [9, 0, 41, 44]
    "house1": [11, 17, 12, 29],
    "house2": [11, 17, 12, 29],
    "house3": [11, 17, 12, 29],
    "house4": [11, 17, 12, 29],
    "house5": [11, 17, 12, 29],
    "house6": [11, 17, 12, 29],
    "house7": [11, 17, 12, 29],
    "house8": [11, 17, 12, 29],
    "house9": [11, 17, 12, 29],
    "house10": [11, 17, 12, 29],
    "house11": [11, 17, 12, 29],
    "house12": [11, 17, 12, 29]
}

Panchang Now vedic/v0/now/

Endpoint	`vedic/v0/now/`
method
Auth Required	`True`
Parameters	`latitude`
	`longitude`
	`Place Name (Optional)`

Code Example:

curl --location --request GET '{api_url}/vedic/v0/now/' \
--header 'Authorization: Token {AUTH_TOKEN}' \
--header 'Content-Type: application/json' \
--data-raw '{
"lat":23.4155,
"lon":77.2324,
"place":""
}'

import requests

url = "{api_url}/vedic/v0/now/"

payload = "{\n\"lat\":23.4155,\n\"lon\":77.2324,\n\"place\":\"\"\n}"
headers = {
  'Authorization': 'Token {AUTH_TOKEN}',
  'Content-Type': 'application/json'
}

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

print(response.text.encode('utf8'))

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('{api_url}/vedic/v0/now/');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
  'Authorization' => 'Token {AUTH_TOKEN}',
  'Content-Type' => 'application/json'
));
$request->setBody('{\n"lat":23.4155,\n"lon":77.2324,\n"place":""\n}');
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("{api_url}/vedic/v0/now/")
  .header("Authorization", "Token {AUTH_TOKEN}")
  .header("Content-Type", "application/json")
  .body("{\n\"lat\":23.4155,\n\"lon\":77.2324,\n\"place\":\"\"\n}")
  .asString();

require "uri"
require "net/http"

url = URI("{api_url}/vedic/v0/now/")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Get.new(url)
request["Authorization"] = "Token {AUTH_TOKEN}"
request["Content-Type"] = "application/json"
request.body = "{\n\"lat\":23.4155,\n\"lon\":77.2324,\n\"place\":\"\"\n}"

response = http.request(request)
puts response.read_body

var client = new RestClient("{api_url}/vedic/v0/now/");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Token {AUTH_TOKEN}");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n\"lat\":23.4155,\n\"lon\":77.2324,\n\"place\":\"\"\n}",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

var request = require('request');
var options = {
  'method': 'GET',
  'url': '{api_url}/vedic/v0/now/',
  'headers': {
    'Authorization': 'Token {AUTH_TOKEN}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({"lat":23.4155,"lon":77.2324,"place":""})

};
request(options, function (error, response) { 
  if (error) throw new Error(error);
  console.log(response.body);
});

EXAMPLE JSON API RESPONSE

{
    "date": "2020-03-31T15:19:31Z",
    "place": "UKN",
    "tithi": 7,
    "paksha": "ShuklaPaksha",
    "varH": "Tuesday",
    "varE": "Tuesday",
    "nakshatraName": "Ardra",
    "nakshatraCharan": 2,
    "yog": "sobhana",
    "karan": "Vanij",
    "sunrise": "2020-03-31T00:44:13Z",
    "sunset": "2020-03-31T13:06:29Z",
    "moonrise": "2020-03-31T10:52:45Z",
    "moonset": "2020-04-01T00:38:41Z",
    "latitude": 23.415499999999998,
    "longitude": 77.23240000000001,
    "maahSolar": "Meen",
    "maahPurnimant": "chaitra",
    "maahAmant": "phalguna",
    "ritu": "Vasant",
    "ayan": "UttarAyan",
    "gol": "DakshinGol"
}

Horoscope vedic/v0/kundali/

Endpoint	`vedic/v0/kundali/`
method
Auth Required	`True`
Parameters	`year (integer)`
	`month (integer)`
	`day (integer)`
	`hour (integer)`
	`minute (integer)`
	`second (integer)`
	`timezone (string Valid Timezone string)`
	`dst ( Day Light Savings boolean)`
	`place name (String)`
	`lat (latitude Floating point number)`
	`lon (longitude floating point Number)`

Code Example:

curl --location --request GET '{api_url}/vedic/v0/kundali/' \
--header 'Authorization: Token {AUTH_TOKEN}' \
--header 'Content-Type: application/json' \
--data-raw '{
	"year":2020,
	"month": 3,
	"day":27,
	"hour":13,
	"minute":45,
	"second":0,
	"timezone":"Asia/Kolkata",
	"dst":false,
	"name":"",
	"lat":23.3301,
	"lon":77.7843
}'

import requests

url = "{api_url}/vedic/v0/kundali/"

payload = "{\n\t\"year\":2020,\n\t\"month\": 3,\n\t\"day\":27,\n\t\"hour\":13,\n\t\"minute\":45,\n\t\"second\":0,\n\t\"timezone\":\"Asia/Kolkata\",\n\t\"dst\":false,\n\t\"name\":\"\",\n\t\"lat\":23.3301,\n\t\"lon\":77.7843\n}"
headers = {
  'Authorization': 'Token {AUTH_TOKEN}',
  'Content-Type': 'application/json'
}

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

print(response.text.encode('utf8'))

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('{api_url}/vedic/v0/kundali/');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
  'Authorization' => 'Token {AUTH_TOKEN}',
  'Content-Type' => 'application/json'
));
$request->setBody('{\n	"year":2020,\n	"month": 3,\n	"day":27,\n	"hour":13,\n	"minute":45,\n	"second":0,\n	"timezone":"Asia/Kolkata",\n	"dst":false,\n	"name":"",\n	"lat":23.3301,\n	"lon":77.7843\n}');
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("{api_url}/vedic/v0/kundali/")
  .header("Authorization", "Token {AUTH_TOKEN}")
  .header("Content-Type", "application/json")
  .body("{\n\t\"year\":2020,\n\t\"month\": 3,\n\t\"day\":27,\n\t\"hour\":13,\n\t\"minute\":45,\n\t\"second\":0,\n\t\"timezone\":\"Asia/Kolkata\",\n\t\"dst\":false,\n\t\"name\":\"\",\n\t\"lat\":23.3301,\n\t\"lon\":77.7843\n}")
  .asString();

require "uri"
require "net/http"

url = URI("{api_url}/vedic/v0/kundali/")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Get.new(url)
request["Authorization"] = "Token {AUTH_TOKEN}"
request["Content-Type"] = "application/json"
request.body = "{\n\t\"year\":2020,\n\t\"month\": 3,\n\t\"day\":27,\n\t\"hour\":13,\n\t\"minute\":45,\n\t\"second\":0,\n\t\"timezone\":\"Asia/Kolkata\",\n\t\"dst\":false,\n\t\"name\":\"\",\n\t\"lat\":23.3301,\n\t\"lon\":77.7843\n}"

response = http.request(request)
puts response.read_body

var client = new RestClient("{api_url}/vedic/v0/kundali/");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Token {AUTH_TOKEN}");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n\t\"year\":2020,\n\t\"month\": 3,\n\t\"day\":27,\n\t\"hour\":13,\n\t\"minute\":45,\n\t\"second\":0,\n\t\"timezone\":\"Asia/Kolkata\",\n\t\"dst\":false,\n\t\"name\":\"\",\n\t\"lat\":23.3301,\n\t\"lon\":77.7843\n}",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

var request = require('request');
var options = {
  'method': 'GET',
  'url': '{api_url}/vedic/v0/kundali/',
  'headers': {
    'Authorization': 'Token {AUTH_TOKEN}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({"year":2020,"month":3,"day":27,"hour":13,"minute":45,"second":0,"timezone":"Asia/Kolkata","dst":false,"name":"","lat":23.3301,"lon":77.7843})

};
request(options, function (error, response) { 
  if (error) throw new Error(error);
  console.log(response.body);
});

EXAMPLE JSON API RESPONSE


{
    "ayanamsha": "24°8'28\"",
    "house1": "03:09:04:16",
    "house2": "04:07:35:48",
    "house3": "05:06:07:20",
    "house4": "06:04:38:53",
    "house5": "07:06:07:21",
    "house6": "08:07:35:49",
    "house7": "09:09:04:16",
    "house8": "10:07:35:48",
    "house9": "11:06:07:20",
    "house10": "00:04:38:53",
    "house11": "01:06:07:21",
    "house12": "02:07:35:49",
    "sun": "11:12°59'06\"",
    "moon": "00:15°06'59\"",
    "mars": "09:03°26'29\"",
    "mercury": "10:15°28'43\"",
    "jupiter": "08:29°39'06\"",
    "venus": "00:28°57'13\"",
    "saturn": "09:06°13'47\"",
    "rahu": "02:09°32'04\" ↺",
    "ketu": "08:09°32'04\" ↺",
    "uranus": "00:10°46'29\"",
    "neptune": "10:24°57'34\"",
    "pluto": "09:00°38'23\"",
    "tithi": 3,
    "nakshatraName": "Bharani",
    "nakshatraCharan": 2,
    "vaarH": "Friday",
    "vaarE": "Friday",
    "yog": "vaidhriti",
    "karan": "Gar",
    "paksha": "ShuklaPaksha",
    "maahSolar": "Meen",
    "maahLunarPurnimant": "chaitra",
    "maahLunarAmant": "phalguna",
    "ritu": "Vasant",
    "ayan": "UttarAyan",
    "gol": "DakshinGol",
    "sunrise": "2020-03-27T00:45:57Z",
    "sunset": "2020-03-27T13:02:44Z",
    "moonrise": "2020-03-27T08:08:04Z",
    "moonset": "2020-03-27T21:00:17Z"
}