Shodasamsa chart (D16 Chart) SVG Image URL

Overview

The Shodasamsa Chart (D16) is a divisional chart in Vedic astrology, created by dividing each zodiac sign into sixteen equal parts, resulting in 192 divisions across the zodiac.

Traditionally, the D16 chart is studied to understand vehicles, comforts, luxuries, material pleasures, and overall happiness and contentment. Astrologers examine planetary placements and combinations in this chart as part of a broader horoscope analysis.

This API generates a D16 Shodasamsa chart as an SVG image using the native's birth date, time, latitude, longitude, and timezone. The generated image is stored on Amazon S3, and the API returns a URL to access the SVG image.

Unlike the D16 SVG Code endpoint, which returns SVG markup directly, this endpoint provides a hosted SVG image URL. Developers can use this URL as an image source in websites, mobile applications, dashboards, and dynamically generated PDF reports.

The API supports both North Indian and South Indian chart layouts. Developers can customize chart appearance through options for fonts, background colors, borders, planetary labels, chart headings, and native details. You can also configure the ayanamsha, observation point, and preferred language.

The endpoint supports 14 languages, including English, Telugu, Hindi, Tamil, Kannada, Malayalam, Odia, Gujarati, Punjabi, Bengali, Marathi, Assamese, Urdu, and Nepali.

The API response contains a status code and the generated SVG image URL in the output field. Use this URL directly to display the D16 chart in your application.

Request Parameters

Supported Languages

This API endpoint supports the following languages. Use the corresponding 2-letter language code in the language parameter when making your request.

{
    "language": "te"
}

Request Example

{
    "year": 2024,
    "month": 1,
    "date": 1,
    "hours": 10,
    "minutes": 30,
    "seconds": 31,
    "latitude": 17.38333,
    "longitude": 78.4666,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric", /* geocentric / topocentric */
        "ayanamsha": "lahiri", /* lahiri / sayana */
        "language":"te" /* en / te / hi / ta / kn / ml / or / gu / pa / bn / mr / as / ur / ne   */
    },
    "chart_config" :  {
            "font_family":"Mallanna", /* Mallanna / Roboto */
            "hide_time_location":"False", /* True / False */
            "hide_outer_planets":"False", /* True / False */
            "chart_style":"south_india",  /* south_india / north_india */
            "sign_number_font_color":"#A5243D",/* works for north_india chart only */
            "native_name":"Mr. Ram Charan",
            "native_name_font_size": "20px",
            "native_details_font_size":"15px",
            "chart_border_width":1,
            "planet_name_font_size": "20px",
            "chart_heading_font_size":"25px",            
            "chart_background_color":"#FEE1C7",            
            "chart_border_color":"#B5A886",            
            "native_details_font_color":"#000",            
            "native_name_font_color": "#231F20",            
            "planet_name_font_color": "#BC412B",            
            "chart_heading_font_color":"#2D3319"
        }
}

Response Examples

Example responses returned by this API.

{
    "statusCode": 200,
    "output": "https://jyotish-software.s3.ap-south-1.amazonaws.com/Chart_1787660389187.svg"
}

Code Examples

Use the following examples to integrate this API into your application.

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://json.freeastrologyapi.com/d16-chart-url',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "year": 2020,
    "month": 2,
    "date": 8,
    "hours": 14,
    "minutes": 45,
    "seconds": 0,
    "latitude": 17.38333,
    "longitude": 78.4666,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric", 
        "ayanamsha": "lahiri", 
        "language":"en" 
    },
    "chart_config" :  {
            "font_family":"Roboto", 
            "hide_time_location":"False", 
            "hide_outer_planets":"False", 
            "chart_style":"north_india",  
            "sign_number_font_color":"#A5243D", 
            "native_name":"Mr. Ram Charan",
            "native_name_font_size": "20px",
            "native_details_font_size":"15px",
            "chart_border_width":1,
            "planet_name_font_size": "20px",
            "chart_heading_font_size":"25px",            
            "chart_background_color":"#FEE1C7",            
            "chart_border_color":"#B5A886",            
            "native_details_font_color":"#000",            
            "native_name_font_color": "#231F20",            
            "planet_name_font_color": "#BC412B",            
            "chart_heading_font_color":"#2D3319"
        }

}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'x-api-key: YOUR_API_KEY_HERE'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

import requests
import json

url = "https://json.freeastrologyapi.com/d16-chart-url"

payload = json.dumps({
  "year": 2020,
  "month": 2,
  "date": 8,
  "hours": 14,
  "minutes": 45,
  "seconds": 0,
  "latitude": 17.38333,
  "longitude": 78.4666,
  "timezone": 5.5,
  "config": {
    "observation_point": "topocentric",
    "ayanamsha": "lahiri",
    "language": "en"
  },
  "chart_config": {
    "font_family": "Roboto",
    "hide_time_location": "False",
    "hide_outer_planets": "False",
    "chart_style": "north_india",
    "sign_number_font_color": "#A5243D",
    "native_name": "Mr. Ram Charan",
    "native_name_font_size": "20px",
    "native_details_font_size": "15px",
    "chart_border_width": 1,
    "planet_name_font_size": "20px",
    "chart_heading_font_size": "25px",
    "chart_background_color": "#FEE1C7",
    "chart_border_color": "#B5A886",
    "native_details_font_color": "#000",
    "native_name_font_color": "#231F20",
    "planet_name_font_color": "#BC412B",
    "chart_heading_font_color": "#2D3319"
  }
})
headers = {
  'Content-Type': 'application/json',
  'x-api-key': 'YOUR_API_KEY_HERE'
}

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

print(response.text)

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://json.freeastrologyapi.com/d16-chart-url',
  'headers': {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY_HERE'
  },
  body: JSON.stringify({
    "year": 2020,
    "month": 2,
    "date": 8,
    "hours": 14,
    "minutes": 45,
    "seconds": 0,
    "latitude": 17.38333,
    "longitude": 78.4666,
    "timezone": 5.5,
    "config": {
      "observation_point": "topocentric",
      "ayanamsha": "lahiri",
      "language": "en"
    },
    "chart_config": {
      "font_family": "Roboto",
      "hide_time_location": "False",
      "hide_outer_planets": "False",
      "chart_style": "north_india",
      "sign_number_font_color": "#A5243D",
      "native_name": "Mr. Ram Charan",
      "native_name_font_size": "20px",
      "native_details_font_size": "15px",
      "chart_border_width": 1,
      "planet_name_font_size": "20px",
      "chart_heading_font_size": "25px",
      "chart_background_color": "#FEE1C7",
      "chart_border_color": "#B5A886",
      "native_details_font_color": "#000",
      "native_name_font_color": "#231F20",
      "planet_name_font_color": "#BC412B",
      "chart_heading_font_color": "#2D3319"
    }
  })

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