Aspects API
The Aspects API provides astrological aspect details based on the birth information supplied in the request. It calculates and returns aspect-related information according to the Indian Astrology API.
Step-by-Step Postman Integration
Basic Astrological Details API Postman Testing Guide
API Endpoint
POST https://astroapi-3.divineapi.com/indian-api/v1/aspects
Returns basic astrological details in the response.
Headers
| Name | Type | Description |
|---|---|---|
| Authorization * | String | Your API Access Token, e.g. Bearer {token} |
Request Body
| Name | Type | Description |
|---|---|---|
| api_key * | String | Your API key |
| full_name * | String | Full name, e.g. Rahul Kumar |
| day * | Integer | Date of birth, e.g. 24 |
| month * | Integer | Month of birth, e.g. 05 |
| year * | Integer | Year of birth, e.g. 2023 |
| hour * | Integer | Hour (24-hour format), e.g. 14 |
| min * | Integer | Minute, e.g. 40 |
| sec * | Integer | Second, e.g. 43 |
| gender * | String | Gender, e.g. male |
| place * | String | Place of birth, e.g. New Delhi |
| lat * | Float | Latitude, e.g. 28.7041 |
| lon * | Float | Longitude, e.g. 77.1025 |
| tzone * | Float | Timezone, e.g. 5.5 — See Timezone List |
200: OK Basic Astrological Details Fetched Successfully
{
"success": 1,
"data": {
"planets": [
{
"name": "Sun",
"sign": "Virgo",
"house": 9,
"aspects": [
{
"aspect": 7,
"house": 3,
"sign": "Pisces",
"planets": [
"Saturn"
]
}
],
"aspected_by": [
{
"planet": "Saturn",
"aspect": 7
}
]
},
{
"name": "Moon",
"sign": "Aries",
"house": 4,
"aspects": [
{
"aspect": 7,
"house": 10,
"sign": "Libra",
"planets": [
"Mercury",
"Venus"
]
}
],
"aspected_by": [
{
"planet": "Mercury",
"aspect": 7
},
{
"planet": "Venus",
"aspect": 7
},
{
"planet": "Ketu",
"aspect": 9
}
]
},
{
"name": "Mars",
"sign": "Cancer",
"house": 7,
"aspects": [
{
"aspect": 4,
"house": 10,
"sign": "Libra",
"planets": [
"Mercury",
"Venus"
]
},
{
"aspect": 7,
"house": 1,
"sign": "Capricorn",
"planets": []
},
{
"aspect": 8,
"house": 2,
"sign": "Aquarius",
"planets": [
"Rahu"
]
}
],
"aspected_by": []
},
{
"name": "Mercury",
"sign": "Libra",
"house": 10,
"aspects": [
{
"aspect": 7,
"house": 4,
"sign": "Aries",
"planets": [
"Moon"
]
}
],
"aspected_by": [
{
"planet": "Moon",
"aspect": 7
},
{
"planet": "Mars",
"aspect": 4
},
{
"planet": "Rahu",
"aspect": 9
}
]
},
{
"name": "Jupiter",
"sign": "Cancer",
"house": 7,
"aspects": [
{
"aspect": 5,
"house": 11,
"sign": "Scorpio",
"planets": []
},
{
"aspect": 7,
"house": 1,
"sign": "Capricorn",
"planets": []
},
{
"aspect": 9,
"house": 3,
"sign": "Pisces",
"planets": [
"Saturn"
]
}
],
"aspected_by": []
},
{
"name": "Venus",
"sign": "Libra",
"house": 10,
"aspects": [
{
"aspect": 7,
"house": 4,
"sign": "Aries",
"planets": [
"Moon"
]
}
],
"aspected_by": [
{
"planet": "Moon",
"aspect": 7
},
{
"planet": "Mars",
"aspect": 4
},
{
"planet": "Rahu",
"aspect": 9
}
]
},
{
"name": "Saturn",
"sign": "Pisces",
"house": 3,
"aspects": [
{
"aspect": 3,
"house": 5,
"sign": "Taurus",
"planets": []
},
{
"aspect": 7,
"house": 9,
"sign": "Virgo",
"planets": [
"Sun"
]
},
{
"aspect": 10,
"house": 12,
"sign": "Sagittarius",
"planets": []
}
],
"aspected_by": [
{
"planet": "Sun",
"aspect": 7
},
{
"planet": "Jupiter",
"aspect": 9
}
]
},
{
"name": "Rahu",
"sign": "Aquarius",
"house": 2,
"aspects": [
{
"aspect": 5,
"house": 6,
"sign": "Gemini",
"planets": []
},
{
"aspect": 7,
"house": 8,
"sign": "Leo",
"planets": [
"Ketu"
]
},
{
"aspect": 9,
"house": 10,
"sign": "Libra",
"planets": [
"Mercury",
"Venus"
]
}
],
"aspected_by": [
{
"planet": "Mars",
"aspect": 8
},
{
"planet": "Ketu",
"aspect": 7
}
]
},
{
"name": "Ketu",
"sign": "Leo",
"house": 8,
"aspects": [
{
"aspect": 5,
"house": 12,
"sign": "Sagittarius",
"planets": []
},
{
"aspect": 7,
"house": 2,
"sign": "Aquarius",
"planets": [
"Rahu"
]
},
{
"aspect": 9,
"house": 4,
"sign": "Aries",
"planets": [
"Moon"
]
}
],
"aspected_by": [
{
"planet": "Rahu",
"aspect": 7
}
]
}
],
"houses": [
{
"house": 1,
"sign": "Capricorn",
"planets": [],
"aspected_by": [
{
"planet": "Mars",
"aspect": 7
},
{
"planet": "Jupiter",
"aspect": 7
}
]
},
{
"house": 2,
"sign": "Aquarius",
"planets": [
"Rahu"
],
"aspected_by": [
{
"planet": "Mars",
"aspect": 8
},
{
"planet": "Ketu",
"aspect": 7
}
]
},
{
"house": 3,
"sign": "Pisces",
"planets": [
"Saturn"
],
"aspected_by": [
{
"planet": "Sun",
"aspect": 7
},
{
"planet": "Jupiter",
"aspect": 9
}
]
},
{
"house": 4,
"sign": "Aries",
"planets": [
"Moon"
],
"aspected_by": [
{
"planet": "Mercury",
"aspect": 7
},
{
"planet": "Venus",
"aspect": 7
},
{
"planet": "Ketu",
"aspect": 9
}
]
},
{
"house": 5,
"sign": "Taurus",
"planets": [],
"aspected_by": [
{
"planet": "Saturn",
"aspect": 3
}
]
},
{
"house": 6,
"sign": "Gemini",
"planets": [],
"aspected_by": [
{
"planet": "Rahu",
"aspect": 5
}
]
},
{
"house": 7,
"sign": "Cancer",
"planets": [
"Mars",
"Jupiter"
],
"aspected_by": []
},
{
"house": 8,
"sign": "Leo",
"planets": [
"Ketu"
],
"aspected_by": [
{
"planet": "Rahu",
"aspect": 7
}
]
},
{
"house": 9,
"sign": "Virgo",
"planets": [
"Sun"
],
"aspected_by": [
{
"planet": "Saturn",
"aspect": 7
}
]
},
{
"house": 10,
"sign": "Libra",
"planets": [
"Mercury",
"Venus"
],
"aspected_by": [
{
"planet": "Moon",
"aspect": 7
},
{
"planet": "Mars",
"aspect": 4
},
{
"planet": "Rahu",
"aspect": 9
}
]
},
{
"house": 11,
"sign": "Scorpio",
"planets": [],
"aspected_by": [
{
"planet": "Jupiter",
"aspect": 5
}
]
},
{
"house": 12,
"sign": "Sagittarius",
"planets": [],
"aspected_by": [
{
"planet": "Saturn",
"aspect": 10
},
{
"planet": "Ketu",
"aspect": 5
}
]
}
]
}
}Code Integration Examples
Below are examples for using this API in different programming environments.
cURL Example
curl --location 'https://astroapi-3.divineapi.com/indian-api/v1/aspects' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'full_name="Robin Kamboj"' \
--form 'day="28"' \
--form 'month="09"' \
--form 'year="2026"' \
--form 'hour="15"' \
--form 'min="32"' \
--form 'sec="0"' \
--form 'gender="male"' \
--form 'place="Bhilwara, Rajasthan"' \
--form 'lat="24.8880"' \
--form 'lon="74.6260"' \
--form 'tzone="5.5"'