Astrology API Reference Documentation

Vedic Rishi REST Web Service Interface

Since the Vedic Rishi Astro API is based on REST principles, it's 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 the API.

API Endpoint

All API URLs listed in this documentation are relative to https://api.vedicrishiastro.com/v1
For example - the /horo_chart/D1/ API call is reachable at-
https://api.vedicrishiastro.com/v1/horo_chart/D1/

RESTful

All Vedic Rishi Astro APIs are RESTful APIs. Following are the known caveats -

  1. All API calls should be made with HTTP POST unless mentioned otherwise
  2. Response status other than HTTP 200 can be considered as an error
  3. Basic HTTP header authorization data is must for every API call
Passing Requested Data RESTfully

Request data is passed to the API by POSTing JSON objects 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, but JSON objects are recommended.

Output Format

Response data for each and every Vedic Rishi Astro API will be encoded in JSON format.

Authentication

Vedic Rishi authenticates the API access using header authentication, therefore every API call to Vedic Rishi must have authorisation header set as- Authorization: Basic ("userId:APIKey")
API key and userId will be mailed to you once you subscribe and activate your plan.

How to get latitude ,longitude and timezone ?

For all the astrological calculcations and other reports generation (Except Numerology), Vedic Rishi APIs expect birth details which contain date of birth, time of birth, longitude of birth place, latitude of birth place and timezone of birth country. We know that getting latitude, longitude and timezone of all the places are difficult to get and therefore Vedic Rishi solves this problem by providing FREE APIs for getting the geo-details given city. These APIs are included in each and every plan you subscribe from VedicRishi. Know More..

Official API Clients

We have an official github account which maintains the official API clients written in various languages.

Vedic Rishi Astro API PHP Client