POST

Chaturthamsa chart (D4 Chart) SVG Image URL

The D4 chart, also known as the Chaturthamsa chart, is a divisional chart in Vedic astrology. It is created by dividing each sign of the zodiac into four equal parts, resulting in a total of 48 divisions.

/d4-chart-url

Method

POST

Format

JSON

Auth

API Key

Credits

Overview

The D4 chart is primarily used to analyze a person's property, education, and happiness. It provides insights into a person's overall sense of well-being, as well as their ability to accumulate and manage property. The chart can also provide information about a person's education and learning abilities, as well as their potential for success in intellectual pursuits. To analyze the D4 chart, an astrologer will consider the position of the planets in each of the 48 divisions, as well as the overall placement of the ascendant and other important points in the chart. They will also consider any planetary combinations or aspects that may be present, as these can have a significant impact on a person's property, education, and happiness. In addition to its use in analyzing property and education, the D4 chart can also provide insights into a person's relationship with their mother and the overall state of their emotional well-being. Overall, the D4 chart is an important tool for understanding the various aspects of a person's life that are associated with the fourth house, which is traditionally associated with property, mother, education, and happiness.

Request Parameters

Parameter	Type	Required	Description	Example
`year`	integer	Yes	Year number, eg: 2023	2023
`month`	integer	Yes	Month number,with no leading zero	7
`date`	integer	Yes	Day number,with no leading zero	5
`hours`	integer	Yes	Hours number,with no leading zero	1
`minutes`	integer	Yes	Minutes number,with no leading zero	1
`seconds`	integer	Yes	Seconds number, with no leading zero	0
`latitude`	float	Yes	Latitude number, in the range from -90 to 90	12.86
`longitude`	float	Yes	Longitude number, in the range from -180 to 180	123.5
`timezone`	float	Yes	Timezone of birth location, eg: 5.5	5.5
📦 `config`	object	No	Contains optional configuration values
`ayanamsha`	string	No	Either "tropical" or "sayana" or "lahiri"	Either "tropical" or "sayana" or "lahiri"
`language`	string	No	Valid 2 letter ISO 639-1 language code	Either "en" For English or "te" for Telugu or "hi" for Hindi or "ta" for Tamil or "kn" for Kannada or "ml" for Malayalam or "or" for Odia or "gu" for Gujarati or "pa" for Punjabi or "bn" for Bengali or "mr" for Marathi or "as" for Assamese or "ur" for Urdu or "ne" for Nepali
`observation_point`	string	No	Geocentric positions are calculated with respect to the center of Earth. Topocentric positions are calculated with respect to the actual given place	Either "topocentric" or "geocentric"
📦 `chart_config`	object	No	Configuration properties of Chart
`font_family`	string	No	Font name	Mallana or Roboto
`hide_time_location`	boolean	No	Whether to write or hide Time and Location information on chart	"True" or "False"
`hide_outer_planets`	boolean	No	Whether to hide Outer Planets or not	"True" or "False"
`chart_style`	string	No	Chart Style	"south_india" or "north_india"
`sign_number_font_color`	string	No	HEX color code to be used for Sign Numbers (works for north_india chart only)	#A5243D
`native_name`	string	No	Native Name	Mr Ram Charan
`native_name_font_size`	string	No	Font Size to be used to show Native Name	20px
`native_details_font_size`	string	No	Font size to be used to print Native Details	22px
`chart_border_width`	integer	No	Border width of Chart	1
`planet_name_font_size`	string	No	Font size to be used to show Planet names	22px
`chart_heading_font_size`	string	No	Font Size to be used to show Chart Heading	25px
`chart_background_color`	string	No	HEX color code to be used for Chart Background	#FEE1C7
`chart_border_color`	string	No	HEX color code to be used for chart borders	#B5A886
`native_details_font_color`	string	No	HEX color code to be used to show Native details	#000000
`native_name_font_color`	string	No	HEX color code to be uses to show native name	#231F20
`planet_name_font_color`	string	No	HEX color code to be used tp show Planet names	#BC412B
`chart_heading_font_color`	string	No	HEX color code to be used to show Chart Heading	#2D3319

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	Code
English	`en`
Telugu	`te`
Hindi	`hi`
Tamil	`ta`
Kannada	`kn`
Malayalam	`ml`
Odia	`or`
Gujarati	`gu`
Punjabi	`pa`
Bengali	`bn`
Marathi	`mr`
Assamese	`as`
Urdu	`ur`
Nepali	`ne`

Example

To request the response in Telugu, use te as the language code:

{
    "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.

English D4 Chart

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

Code Examples

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

PHP Code

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://json.freeastrologyapi.com/d4-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;

Python Code

import requests
import json

url = "https://json.freeastrologyapi.com/d4-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)

Node JS Code

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://json.freeastrologyapi.com/d4-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);
});