✋ Palmistry API and 🎧 Audio Reports API are now live. Ship them in your app today.

SEARCH ASTROLOGY API DOCS

Home
Western Astrology

Natal Aspects Report/natal_aspects_report

The Natal Aspects Report API identifies the aspects formed between two planets and provides detailed descriptions of each aspect, helping interpret the key planetary relationships and influences in the natal chart.

API Endpoint : natal_aspects_report
Method : POST
Full URL :
https://json.astrologyapi.com/v1/natal_aspects_report
How to change language
Header:
Accept-Language: en

Guide:These languages are supported by this API. You can use them by passing Accept-Language header with a value of the language code.

Supported Languages
Provide birth date, birth time, latitude, longitude, and timezone to generate a natal aspects report.

Request Data

ParamsData typeDescriptions

day required

month required

year required

hour required

min required

lat required

lon required

tzone required

house_type

int

int

int

int

int

float

float

float

string

date of birth, eg: 10

month of birth, eg: 5

year of birth, eg: 1990

hour, eg: 19

minute, eg: 55

latitude, eg: 19.2056

longitude, eg: 25.2056

timezone, eg: 5.5

Default : "placidus" // koch/topocentric/poryphry/equal_house/whole_sign

Response Data

[
	{
		"aspecting_planet": "Sun",
		"aspected_planet": "Mars",
		"type": "Trine",
		"report": "A trine formed between the Sun and Mars strengthens your vitality, self-confidence, and will power. You can function at high energy levels for prolonged periods. You enjoy the challenge of any difficult task. Although firm in thought, you readily accept the opinions of others and you relate in a polished way, never threatening others. You know that you can succeed in whatever you set out to do without resorting to deception or dishonorable tactics. You accept people for what they are and expect them to do the same with you. While you can act impulsively at times, in general you plan actions efficiently and purposely. You take on life's problems without hesitancy and handle most situations with little fanfare or publicity. Your life is not uneventful, but you can cope without apparent difficulty."
	},
	{
		"aspecting_planet": "Sun",
		"aspected_planet": "Jupiter",
		"type": "Sextile",
		"report": "The sextile between the Sun and Jupiter shows that you are philosophical, curious, and sympathetic. You understand your capabilities and have confidence in what you know and can do. People will believe what you say because of the way you express yourself and because you are so well equipped with the facts. Routines are hard for you because you are an idea person needing freedom of expression. You are self-satisfied and contented, and unless other aspects of the chart suggest otherwise, you sometimes can be self-indulgent."
	},
	{
		"aspecting_planet": "Sun",
		"aspected_planet": "Uranus",
		"type": "Square",
		"report": "A square formed between the Sun and Uranus shows that you are impulsive and unpredictable. You go your own way and do your own thing without much concern about what others think. You are original, but sometimes impractical. You like to do what you want, when you want. Nervous and accident prone, you may sometimes think you have a dark cloud following you. Your periodic unwillingness to follow rules may hamper your progress. With maturity, your views may remain eccentric and liberal, but they become more broadly based and humanitarian."
	},
	{
		"aspecting_planet": "Sun",
		"aspected_planet": "Neptune",
		"type": "Square",
		"report": "A square formed between the Sun and Neptune shows suffering from an inferiority complex. You feel that you must constantly defend your ideals and objectives. You may find yourself being undermined, or perceive this is the case. You are imaginative, but you may reject reality. It can be difficult for you to find an avenue of self-expression. It's hard for you to create a vision of exactly where you are going, because you underestimate your ability to succeed. You become involved when others lean on you and depend on you. You are sensitive to suffering, fond of animals, and more emotional than you let on. You are vulnerable emotionally. This aspect sometimes produces a lax in morality, bohemian tendencies, and many impractical and unrealistic ideas."
	},
	{
		"aspecting_planet": "Moon",
		"aspected_planet": "Saturn",
		"type": "Square",
		"report": "The square formed between the Moon and Saturn suggests a serious side to your nature. There is a strong urge to get ahead. Yet your demeanor can get heavy sometimes and you can turn moody and depressed. Being temperamental in youth can cause you many problems. A guilt complex falls away with maturity. There is a lot of negativism and insecurity associated with this aspect, but there is also an ability to learn by mistakes. You understand yourself well, and you work harder than most people to prove yourself. With this aspect in your chart, you must learn to handle your frustration, depression and dissatisfaction. Although determined and apparently ardent in emotional matters, you can be pretty cold when it suits your purposes. Little of a personal nature is allowed to interfere with the main stream of your intentions."
	},
	{
		"aspecting_planet": "Mars",
		"aspected_planet": "Jupiter",
		"type": "Sextile",
		"report": "The sextile formed between Mars and Jupiter suggests the effective use of the mind and physical body to meet objectives. You are at your best when confronted with competition or a challenge to overcome. You know how to assert yourself under pressure, and have developed your talent for effective communication through dramatic delivery and clever use of words. Your sex drive is expanded by this aspect, but it's necessary to restrict partners to those with whom you have intellectual rapport."
	},
	{
		"aspecting_planet": "Mercury",
		"aspected_planet": "Venus",
		"type": "Conjunction",
		"report": "The conjunction of Mercury and Venus shows an affable manner and social grace. You can get along with most people because you understand the art of compromise. This doesn't mean that you always give in, but just that you try to be fair and don't offend people without a good reason. You know how to express your opinions with skill and color, and without being argumentative. You are refined in your presentations and you usually see to it that your position is well documented."
	},
	{
		"aspecting_planet": "Jupiter",
		"aspected_planet": "Venus",
		"type": "Sextile",
		"report": "The sextile formed between Venus and Jupiter shows an outgoing personality. You have the ability to say the right thing at the right time. You are generous with praise and everyone thinks of you as a very sympathetic and understanding person. You can always be counted on when you are needed, while not being the type to impose your views when they are unwanted. You like people and know how to get along with them. This aspect bestows the likelihood of achieving the good life in a material sense, as you are very successful socially."
	},
	{
		"aspecting_planet": "Venus",
		"aspected_planet": "Uranus",
		"type": "Square",
		"report": "The square formed between Venus and Uranus suggests a free spirit who's hard to tie down to a permanent relationship. You are fascinated by individuals who have unusual qualities. A fickle nature makes it hard for you to accept the responsibility of belonging to one person. Touchy and willful, you have a problem with the opposite sex that may have roots in a deep inferiority complex. There is a tendency to defy convention and become a little bored with those who submit to it. You are used to having your own way and expect it. You confuse love and friendship, but you don't become over attached to friends or lovers. A nervous condition may result from this configuration, especially if you fail to get adequate rest."
	},
	{
		"aspecting_planet": "Saturn",
		"aspected_planet": "Pluto",
		"type": "Sextile",
		"report": "Saturn sextile Pluto offers great strength of purpose and the ability to hold tightly to principles and beliefs. Those born with this aspect see beneath superficial surfaces and have a good grasp of the reality behind any situation. There is an aptitude for political intrigue and the deeper mysteries of life. Emotions are deeply felt but not easily expressed."
	},
	{
		"aspecting_planet": "Neptune",
		"aspected_planet": "Pluto",
		"type": "Sextile",
		"report": "This is a 'generational' influence that is most noticeable in charts where it contacts the angles or Sun or Moon. Neptune relates to mass consciousness. Pluto relates to political power, global organisations, focussed energy or 'underground' institutions. When these planets are in contact with each other there is often widespread onflict or focus upon political issues and collective ideals."
	}
]
POST
var api = 'natal_aspects_report';
var userId = '<Your User Id>';
var apiKey = '<Your Api Key>';
var language = '<Your Language>' // By default it is set to en
var data = {
  day: 6,
  month: 1,
  year: 2000,
  hour: 7,
  min: 45,
  lat: 19.132,
  lon: 72.342,
  tzone: 5.5,
};

var auth = "Basic " + new Buffer(userId + ":" + apiKey).toString("base64");

var request = $.ajax({
url: "https://json.astrologyapi.com/v1/"+api,
method: "POST",
dataType:'json',
headers: {
    "authorization": auth,
    "Content-Type":'application/json',
    "Accept-Language": language 
},
    data:JSON.stringify(data)
});

request.then( function(resp){
    console.log(resp);
}, function(err){
    console.log(err);
});