https://json.astrologyapi.com/v1/natal_aspects_reportx-astrologyapi-keystringrequiredAPI access token used to authenticate requests. Send your access token in this custom header.
Accept-LanguagestringPreferred language for the response content. Supported: English - en.
dayintrequiredDate of birth, eg: 10
monthintrequiredMonth of birth, eg: 5
yearintrequiredYear of birth, eg: 1990
hourintrequiredHour of birth, eg: 19
minintrequiredMinute of birth, eg: 55
latfloatrequiredLatitude, eg: 19.2056
lonfloatrequiredLongitude, eg: 25.2056
tzonefloatrequiredTimezone, eg: 5.5
curl --location 'https://json.astrologyapi.com/v1/natal_aspects_report' \
--header 'Content-Type: application/json' \
--header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
--data '{
"day": 10,
"month": 5,
"year": 1990,
"hour": 19,
"min": 55,
"lat": 19.2056,
"lon": 25.2056,
"tzone": 5.5
}'
Runs with sample data — no API key needed
[
{
"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."
}
]