1. Securing Your API Key
To start, you need an API key. Head over to DivineAPI and register to initiate your 7-day trial.
- Select the APIs you are interested in (you can change selections anytime).
- Click on checkout, fill out the sign-up form, and enter payment details.
- Your trial will begin immediately. No charges during the trial period, and you can cancel anytime.
After logging in, your API key will be visible on your dashboard: API Key Page.
2. Importing the Postman Collection
Import our Postman collection to facilitate your API testing:
- After logging into your Postman account:
- Open This link: https://documenter.getpostman.com/view/27195761/2sA3Qs8rfV
- Click “Run in Postman” and then select “Run in Web”.
- Select your workspace and then select ‘import’.
3. Configuring Your API Request
Once the collection is imported:
Locate the "Custom Transit" API request.
Ensure the method is set to POST.
Use this request URL: https://astroapi-4.divineapi.com/western-api/v1/transit/custom
4. Setting Request Parameters
This API call necessitates only your API key. To find your API key.
- Go to your DivineAPI dashboard > API Key page.
- Click on “Copy” next to the API key
Notice the difference between the key, and the Access Token.
Go back to Postman to set the parameters.
- Navigate to “Authorization”, select “Bearer Token” in the Auth type, and then add the token from your Divine API profile.
- Navigate to 'Body', select 'form_data', and then add:
api_key: "<Your_API_Key>" - Your unique API subscription identifier.
full_name: "Person Name" - Enter full name.
day: "24" - Enter the date of birth.
month: "05" - Enter the month of birth.
year: "1998" - Enter the year of birth.
hour: "14" - Enter the hour.
min: "40" - Enter the minute.
sec: "43" - Enter the second.
gender: "male" - Enter the gender.
place: "New Delhi" - Enter the name of the city.
lat: "28.7041" - Enter latitude for location-specific details.
lon: "77.1025" - Enter longitude for accurate location insights.
tzone: "5.5" - Enter timezone offset from UTC.
lan: "en" - Enter the language (default is "en").
transit_day: "10" - Enter the transit day.
transit_month: "02" - Enter the transit month.
transit_year: "2024" - Enter the transit year.
transit_hour: "18" - Enter the transit hour.
transit_min: "10" - Enter the transit minute.
transit_sec: "05" - Enter the transit second.
transit_lat: "19.0760" - Enter transit latitude.
transit_lon: "72.8774" - Enter transit longitude.
transit_tzone: "5.5" - Enter transit timezone offset from UTC.
transit_place: "Mumbai, Maharashtra, India" - Enter the transit location.
house_system: "P" - Enter the house system code (default is "P" for Placidus).
Please ensure that the bearer token is exactly the same as in your profile, with no changes in spacing or formatting.
Use translator for other language:
Update translator: https://divineapi.com/translator
en For English
hi For Hindi
pt For Portuguese
fr For French
es For Spanish
ru For Russian
de For German
nl For Dutch
it For Italian
pl For Polish
ar For Arabic
ja For Japanese
zh For Chinese
5. Making the Request
Hit the 'Send' button to submit your request.
6. Deciphering the Response
The API's response will be structured as follows:
{
"success": 1,
"data": [
{
"natal_planet": "Ascendant",
"transit_planet": "Mars",
"orb": 5.87,
"aspect": "Sextile"
},
{
"natal_planet": "Ascendant",
"transit_planet": "Venus",
"orb": 1.23,
"aspect": "Opposition"
},
{
"natal_planet": "Ascendant",
"transit_planet": "Uranus",
"orb": 1.03,
"aspect": "Conjunction"
},
{
"natal_planet": "Sun",
"transit_planet": "Jupiter",
"orb": 4.57,
"aspect": "Trine"
},
{
"natal_planet": "Sun",
"transit_planet": "MC",
"orb": 1.33,
"aspect": "Sextile"
},
{
"natal_planet": "Sun",
"transit_planet": "Chiron",
"orb": 4.5,
"aspect": "Sextile"
},
{
"natal_planet": "Moon",
"transit_planet": "Ascendant",
"orb": 4.47,
"aspect": "Sextile"
},
{
"natal_planet": "Moon",
"transit_planet": "Mars",
"orb": 5.66,
"aspect": "Sextile"
},
{
"natal_planet": "Mars",
"transit_planet": "Ascendant",
"orb": 1.18,
"aspect": "Conjunction"
},
{
"natal_planet": "Mars",
"transit_planet": "Sun",
"orb": 2.6,
"aspect": "Square"
},
{
"natal_planet": "Mars",
"transit_planet": "Mars",
"orb": 2.37,
"aspect": "Conjunction"
},
{
"natal_planet": "Mars",
"transit_planet": "Venus",
"orb": 7.02,
"aspect": "Trine"
},
{
"natal_planet": "Mercury",
"transit_planet": "North node",
"orb": 7.98,
"aspect": "Sextile"
},
{
"natal_planet": "Mercury",
"transit_planet": "MC",
"orb": 1.76,
"aspect": "Sextile"
},
{
"natal_planet": "Venus",
"transit_planet": "North node",
"orb": 4.94,
"aspect": "Conjunction"
},
{
"natal_planet": "Venus",
"transit_planet": "South node",
"orb": 4.94,
"aspect": "Opposition"
},
{
"natal_planet": "Jupiter",
"transit_planet": "South node",
"orb": 5.64,
"aspect": "Trine"
},
{
"natal_planet": "Saturn",
"transit_planet": "Ascendant",
"orb": 2.59,
"aspect": "Trine"
},
{
"natal_planet": "Saturn",
"transit_planet": "Moon",
"orb": 4.13,
"aspect": "Conjunction"
},
{
"natal_planet": "Saturn",
"transit_planet": "Mars",
"orb": 3.78,
"aspect": "Trine"
},
{
"natal_planet": "Saturn",
"transit_planet": "Jupiter",
"orb": 3.39,
"aspect": "Square"
},
{
"natal_planet": "Saturn",
"transit_planet": "Saturn",
"orb": 4.35,
"aspect": "Conjunction"
},
{
"natal_planet": "North node",
"transit_planet": "Mars",
"orb": 7.95,
"aspect": "Trine"
},
{
"natal_planet": "North node",
"transit_planet": "Uranus",
"orb": 3.11,
"aspect": "Sextile"
},
{
"natal_planet": "North node",
"transit_planet": "Neptune",
"orb": 1.75,
"aspect": "Conjunction"
},
{
"natal_planet": "South node",
"transit_planet": "Venus",
"orb": 3.31,
"aspect": "Sextile"
},
{
"natal_planet": "South node",
"transit_planet": "Neptune",
"orb": 1.75,
"aspect": "Opposition"
},
{
"natal_planet": "South node",
"transit_planet": "Pluto",
"orb": 0.01,
"aspect": "Trine"
},
{
"natal_planet": "Uranus",
"transit_planet": "Ascendant",
"orb": 2.79,
"aspect": "Sextile"
},
{
"natal_planet": "Uranus",
"transit_planet": "Mars",
"orb": 1.6,
"aspect": "Sextile"
},
{
"natal_planet": "Uranus",
"transit_planet": "Venus",
"orb": 3.05,
"aspect": "Opposition"
},
{
"natal_planet": "Uranus",
"transit_planet": "Uranus",
"orb": 3.25,
"aspect": "Conjunction"
},
{
"natal_planet": "Neptune",
"transit_planet": "Uranus",
"orb": 1.57,
"aspect": "Sextile"
},
{
"natal_planet": "Neptune",
"transit_planet": "Neptune",
"orb": 0.21,
"aspect": "Conjunction"
},
{
"natal_planet": "Pluto",
"transit_planet": "North node",
"orb": 3.45,
"aspect": "Sextile"
},
{
"natal_planet": "MC",
"transit_planet": "North node",
"orb": 5.93,
"aspect": "Sextile"
},
{
"natal_planet": "MC",
"transit_planet": "MC",
"orb": 3.82,
"aspect": "Sextile"
},
{
"natal_planet": "Chiron",
"transit_planet": "Ascendant",
"orb": 0.85,
"aspect": "Square"
},
{
"natal_planet": "Chiron",
"transit_planet": "Sun",
"orb": 2.27,
"aspect": "Opposition"
},
{
"natal_planet": "Chiron",
"transit_planet": "Mars",
"orb": 2.04,
"aspect": "Square"
},
{
"natal_planet": "Chiron",
"transit_planet": "Jupiter",
"orb": 1.65,
"aspect": "Sextile"
},
{
"natal_planet": "Chiron",
"transit_planet": "MC",
"orb": 4.25,
"aspect": "Conjunction"
},
{
"natal_planet": "Chiron",
"transit_planet": "Chiron",
"orb": 1.57,
"aspect": "Conjunction"
}
]
}
- To decipher the API response, identify each "natal_planet" and "transit_planet" pair, their "aspect," and the "orb" value.
- The "aspect" field describes the type of interaction (e.g., Trine, Opposition), and the "orb" indicates the closeness of the aspect.
- Each entry provides specific transit influences on the natal chart.
7. Error Resolution
Ensure your API key is correctly entered if you encounter errors, as most issues are due to invalid or missing API keys.
8. Further Assistance
For additional support or inquiries, feel free to contact our customer service team at admin@divineapi.com.