search

Copy page

Copy page as Markdown for LLMs

View as Markdown

View this page as plain text


Open in ChatGPT

Ask ChatGPT about this page

Open in Claude

Ask Claude about this page

Full Transit 

Understand complete planetary movements and their astrological effects using the Full Transit API, offering detailed insights for every major planetary influence in transit interpretation.

Supported Language Codes

CodeLanguage
enEnglish
hiHindi
ptPortuguese
frFrench
deGerman
jaJapanese
trTurkish
ruRussian
itItalian
esSpanish
nlDutch
plPolish

Guide: These languages are supported by this API. You can use them by passing lan in the body with the desired language code.


Allowed Transit Planets

Use one of the following values in transit_planet.

ValueMeaning
SunFor Sun transit
MoonFor Moon transit
MercuryFor Mercury transit
VenusFor Venus transit
MarsFor Mars transit
JupiterFor Jupiter transit
SaturnFor Saturn transit
UranusFor Uranus transit
NeptuneFor Neptune transit

API Endpoint

POST https://astroapi-8.divineapi.com/western-api/v1/full-transit

Returns Full Transit details in response.


Headers

NameTypeDescription
Authorization*Stringyour API Access Token (eg: Bearer {token})

Request Body

KeyTypeExample ValueDescription
api_keyTextyour API KeyYour API authentication key.
full_nameTextRobin KambojFull name of the person whose transit is being calculated.
day*Text6Birth day of the user.
month*Text11Birth month of the user.
year*Text2025Birth year of the user.
hour*Text0Birth hour in 24-hour format.
min*Text0Birth minute.
sec*Text0Birth second.
genderTextfemaleGender of the user.
place*TextBareillyBirth place of the user.
lat*Text28.644800Birth location latitude.
lon*Text77.216721Birth location longitude.
tzone*Text5.5Timezone of the birth place.
transit_year*Text2025Year for which transit calculations are required.
transit_month*Text10Month for which transit calculations are required.
transit_lat*Text25.321684Latitude of the transit location.
transit_lon*Text82.987289Longitude of the transit location.
transit_tzone*Text5.5Timezone of the transit location.
transit_place*TextNew DelhiPlace for which transit is being analyzed.
transit_planet*TextmoonTransit planet to be analyzed.
aspect_orbs_typeTextFIXEDType of aspect orb used for aspect calculation.
aspect_orbs_valueText5_30Orb value(s) used for aspect calculation.
aspects_typeTextALLSpecifies which aspects should be included (ALL/FIXED/CUSTOM).
transit_day*Text27Day for which transit calculation is performed.

You can control which astrological aspects are included by using the aspects_type parameter.
It supports category-based values, single aspect values, or multiple aspect values separated by commas.

Category Values

ALL: Includes all major and minor aspects

MAJOR_ASPECTS: Conjunction, Sextile, Square, Trine, Opposition

MINOR_ASPECTS : Semisextile, Semisquare, Sesquiquadrate, Quincunx, Quintile, Biquintile, Novile, Septile

Individual Aspect Values

You may specify any single aspect:

aspects_typeDescription
CONJUNCTIONUsed to calculate conjunction aspect
SEXTILEUsed to calculate sextile aspect
SQUAREUsed to calculate square aspect
TRINEUsed to calculate trine aspect
OPPOSITIONUsed to calculate opposition aspect
SEMISEXTILEUsed to calculate semisextile aspect
SEMISQUAREUsed to calculate semisquare aspect
SESQUIQUADRATEUsed to calculate sesquiquadrate aspect
QUINCUNXUsed to calculate quincunx aspect
QUINTILEUsed to calculate quintile aspect
BIQUINTILEUsed to calculate biquintile aspect
NOVILEUsed to calculate novile aspect
SEPTILEUsed to calculate septile aspect

Multiple Aspects

To select more than one, provide comma-separated values:
SEMISQUARE,SEMISEXTILE,QUINTILE

Aspect Orb Settings 

The aspect_orbs_type parameter defines how the orb values are interpreted. It supports two modes:

1. FIXED

When aspect_orbs_type = FIXED, the orb range (0°30' to 15°00') is applied based on the degree group:

1. 0°30' to 3°00':  Applies to All Aspects

2. 3°30' to 4°00': Applies to Major Aspects Only

3. 4°30' to 15°00': Applies to Major Aspects Except Sextile

Example values:
0_30, 1_00, 5_00, 12_00, 15_00
(Use underscore to represent degrees_minutes format)

2. PERCENTAGE

When using PERCENTAGE, the aspect_orbs_value represents a percentage adjustment applied to the default orb.

Allowed percentage range: -90% - +100%

Example values:
-20%, -10%, 0%, +20%, +50%, +100%

3. BOTH

You may also support both modes, allowing the user to choose either FIXED or PERCENTAGE based on their preference.

aspect_orbs_typeMeaningaspect_orbs_value Range
FIXEDOrb defined in fixed degrees/minutes0°30' – 15°00'
PERCENTAGEOrb adjusted by percentage-90% to +100%
BOTHAllows either modeFollows the rules of each mode

200: OK Full Transit Details Fetched Successfully

 {
    "status": "success",
    "code": 200,
    "message": "Request successful",
    "data": {
        "transit": [
            {
                "natal_planet": "Sun",
                "transit_planet": "Moon",
                "aspect": "Septile",
                "start_time": "2025-10-28 04:15:00",
                "exact_time": "2025-10-27 12:00:00",
                "end_time": "2025-10-28 04:15:00"
            },
            {
                "natal_planet": "Moon",
                "transit_planet": "Moon",
                "aspect": "Sesquiquadrate",
                "start_time": "2025-10-26 12:01:00",
                "exact_time": "2025-10-27 12:00:00",
                "end_time": "2025-10-26 12:00:00"
            },
            {
                "natal_planet": "Mercury",
                "transit_planet": "Moon",
                "aspect": "Semisextile",
                "start_time": "2025-10-28 03:48:00",
                "exact_time": "2025-10-27 12:00:00",
                "end_time": "2025-10-28 03:48:00"
            },
            {
                "natal_planet": "Venus",
                "transit_planet": "Moon",
                "aspect": "Quintile",
                "start_time": "2025-10-27 01:28:00",
                "exact_time": "2025-10-27 19:23:00",
                "end_time": "2025-10-28 13:06:00"
            },
            {
                "natal_planet": "Mars",
                "transit_planet": "Moon",
                "aspect": "Novile",
                "start_time": "2025-10-27 02:10:00",
                "exact_time": "2025-10-27 20:04:00",
                "end_time": "2025-10-28 13:47:00"
            },
            {
                "natal_planet": "Uranus",
                "transit_planet": "Moon",
                "aspect": "Biquintile",
                "start_time": "2025-10-26 20:35:00",
                "exact_time": "2025-10-27 12:00:00",
                "end_time": "2025-10-26 20:35:00"
            },
            {
                "natal_planet": "Pluto",
                "transit_planet": "Moon",
                "aspect": "Semisextile",
                "start_time": "2025-10-26 12:01:00",
                "exact_time": "2025-10-27 12:00:00",
                "end_time": "2025-10-26 12:00:00"
            }
        ]
    }
}

Example Code Implementations

Below are example implementations in various programming environments.


cURL

curl --location 'https://astroapi-8.divineapi.com/western-api/v1/full-transit' \
--header 'Authorization: Bearer your API Access Token' \
--form 'api_key="your API Key"' \
--form 'full_name="Robin Kamboj"' \
--form 'day="6"' \
--form 'month="11"' \
--form 'year="2025"' \
--form 'hour="0"' \
--form 'min="0"' \
--form 'sec="0"' \
--form 'gender="female"' \
--form 'place="Bareilly"' \
--form 'lat="28.644800"' \
--form 'lon="77.216721"' \
--form 'tzone="5.5"' \
--form 'transit_year="2025"' \
--form 'transit_month="10"' \
--form 'transit_lat="25.321684"' \
--form 'transit_lon="82.987289"' \
--form 'transit_tzone="5.5"' \
--form 'transit_place="New Delhi"' \
--form 'transit_planet="moon"' \
--form 'aspect_orbs_type="Fixed"' \
--form 'aspect_orbs_value="5_30"' \
--form 'aspects_type="ALL"' \
--form 'transit_day="27"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-8.divineapi.com/western-api/v1/full-transit',
  'headers': {
    'Authorization': 'Bearer your API Access Token'
  },
  formData: {
    'api_key': 'your API Key',
    'full_name': 'Robin Kamboj',
    'day': '6',
    'month': '11',
    'year': '2025',
    'hour': '0',
    'min': '0',
    'sec': '0',
    'gender': 'female',
    'place': 'Bareilly',
    'lat': '28.644800',
    'lon': '77.216721',
    'tzone': '5.5',
    'transit_year': '2025',
    'transit_month': '10',
    'transit_lat': '25.321684',
    'transit_lon': '82.987289',
    'transit_tzone': '5.5',
    'transit_place': 'New Delhi',
    'transit_planet': 'moon',
    'aspect_orbs_type': 'Fixed',
    'aspect_orbs_value': '5_30',
    'aspects_type': 'ALL',
    'transit_day': '27'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

JavaScript jQuery

var form = new FormData();
form.append("api_key", "your API Key");
form.append("full_name", "Robin Kamboj");
form.append("day", "6");
form.append("month", "11");
form.append("year", "2025");
form.append("hour", "0");
form.append("min", "0");
form.append("sec", "0");
form.append("gender", "female");
form.append("place", "Bareilly");
form.append("lat", "28.644800");
form.append("lon", "77.216721");
form.append("tzone", "5.5");
form.append("transit_year", "2025");
form.append("transit_month", "10");
form.append("transit_lat", "25.321684");
form.append("transit_lon", "82.987289");
form.append("transit_tzone", "5.5");
form.append("transit_place", "New Delhi");
form.append("transit_planet", "moon");
form.append("aspect_orbs_type", "Fixed");
form.append("aspect_orbs_value", "5_30");
form.append("aspects_type", "ALL");
form.append("transit_day", "27");

var settings = {
  "url": "https://astroapi-8.divineapi.com/western-api/v1/full-transit",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer your API Access Token"
  },
  "processData": false,
  "mimeType": "multipart/form-data",
  "contentType": false,
  "data": form
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Python

import requests

url = "https://astroapi-8.divineapi.com/western-api/v1/full-transit"

payload = {'api_key': 'your API Key',
'full_name': 'Robin Kamboj',
'day': '6',
'month': '11',
'year': '2025',
'hour': '0',
'min': '0',
'sec': '0',
'gender': 'female',
'place': 'Bareilly',
'lat': '28.644800',
'lon': '77.216721',
'tzone': '5.5',
'transit_year': '2025',
'transit_month': '10',
'transit_lat': '25.321684',
'transit_lon': '82.987289',
'transit_tzone': '5.5',
'transit_place': 'New Delhi',
'transit_planet': 'moon',
'aspect_orbs_type': 'Fixed',
'aspect_orbs_value': '5_30',
'aspects_type': 'ALL',
'transit_day': '27'}
files=[

]
headers = {
  'Authorization': 'Bearer your API Access Token'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)