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

Planetary Positions

Explore the current celestial layout with Composite Planetary Positions, understanding the astrological influence of each planet.


Step by Step Planetary Positions API Postman Testing Integration

Open the guide


Supported Languages

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

Guide: These languages are supported by this API. Pass lan in the body with one of the codes above.


API Endpoint

POST https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions

Returns Planetary Positions in response.


Headers

NameTypeDescription
Authorization*Stringyour API Access Tokeneg: Bearer {token}

Request Body

NameTypeDescription
api_key*Stringyour API key
p1_full_name*StringP1's Full Name, ex: Rahul Kumar
p1_day*IntegerP1's date of birth, eg: 24
p1_month*IntegerP1's month of birth, eg: 05
p1_year*IntegerP1's year of birth, eg: 1998
p1_hour*IntegerP1's hour, eg: 14
p1_min *IntegerP1's minute, eg: 40
p1_sec*IntegerP1's second, eg: 43
p1_gender*StringP1's gender, ex: male
p1_place*StringP1's birth place, ex: New Delhi
p1_lat*FloatP1's latitude, eg: 28.7041
p1_lon*FloatP1's longitude, eg: 77.1025
p1_tzone*FloatP1's timezone, eg: 5.5 Timezone List
p2_full_name*StringP2's Full Name, ex: Simran Kumari
p2_day*IntegerP2's date of birth, eg: 24
p2_month*IntegerP2's month of birth, eg: 05
p2_year*IntegerP2's year of birth, eg: 1998
p2_hour*IntegerP2's hour, eg: 14
p2_min*IntegerP2's minute, eg: 40
p2_sec*IntegerP2's second, eg: 43
p2_gender*StringP2's gender, ex: female
p2_place*StringP2's birth place, ex: New Delhi
p2_lon*FloatP2's longitude, eg: 77.1025
p2_lat*FloatP2's latitude, eg: 28.7041
p2_tzone*FloatP2's timezone, eg: 5.5 Timezone List
lanStringLanguage en/hi, default en
house_systemStringHouse system code, default - P (Placidus)
node_typeStringmeannode or truenode (default: meannode)

200: OK Planetary Positions fetched successfully

{
    "status": "success",
    "code": 200,
    "message": "Request successful",
    "data": {
        "p1_planetary_positions": [
            {
                "name": "Ascendant",
                "full_degree": "257.078873",
                "sign": "Sagittarius",
                "sign_no": 9,
                "longitude": "17:4:44",
                "speed": "315.638254",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 1,
                "element": "Fire",
                "modality": "Mutable"
            },
            {
                "name": "Sun",
                "full_degree": "63.229475",
                "sign": "Gemini",
                "sign_no": 3,
                "longitude": "3:13:46",
                "speed": "0.9612737",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 6,
                "element": "Air",
                "modality": "Mutable"
            },
            {
                "name": "Moon",
                "full_degree": "46.5203485",
                "sign": "Taurus",
                "sign_no": 2,
                "longitude": "16:31:13",
                "speed": "14.9223376",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 5,
                "element": "Earth",
                "modality": "Fixed"
            },
            {
                "name": "Mars",
                "full_degree": "60.3256278",
                "sign": "Gemini",
                "sign_no": 3,
                "longitude": "0:19:32",
                "speed": "0.7118503",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 6,
                "element": "Air",
                "modality": "Mutable"
            },
            {
                "name": "Mercury",
                "full_degree": "45.2234284",
                "sign": "Taurus",
                "sign_no": 2,
                "longitude": "15:13:24",
                "speed": "1.7743321",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 5,
                "element": "Earth",
                "modality": "Fixed"
            },
            {
                "name": "Venus",
                "full_degree": "23.7709035",
                "sign": "Aries",
                "sign_no": 1,
                "longitude": "23:46:15",
                "speed": "1.1572865",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 4,
                "element": "Fire",
                "modality": "Cardinal"
            },
            {
                "name": "Jupiter",
                "full_degree": "353.6317691",
                "sign": "Pisces",
                "sign_no": 12,
                "longitude": "23:37:54",
                "speed": "0.1513475",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 3,
                "element": "Water",
                "modality": "Mutable"
            },
            {
                "name": "Saturn",
                "full_degree": "28.3512193",
                "sign": "Aries",
                "sign_no": 1,
                "longitude": "28:21:4",
                "speed": "0.1117894",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 4,
                "element": "Fire",
                "modality": "Cardinal"
            },
            {
                "name": "North node",
                "full_degree": "156.1201678",
                "sign": "Virgo",
                "sign_no": 6,
                "longitude": "6:7:13",
                "speed": "-0.0529476",
                "is_retro": "true",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 9,
                "element": "Earth",
                "modality": "Mutable"
            },
            {
                "name": "South node",
                "full_degree": "336.1201678",
                "sign": "Pisces",
                "sign_no": 12,
                "longitude": "6:7:13",
                "speed": "-0.0529476",
                "is_retro": "true",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 3,
                "element": "Water",
                "modality": "Mutable"
            },
            {
                "name": "Uranus",
                "full_degree": "312.723067",
                "sign": "Aquarius",
                "sign_no": 11,
                "longitude": "12:43:23",
                "speed": "-0.0057148",
                "is_retro": "true",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 2,
                "element": "Air",
                "modality": "Fixed"
            },
            {
                "name": "Neptune",
                "full_degree": "302.0552088",
                "sign": "Aquarius",
                "sign_no": 11,
                "longitude": "2:3:19",
                "speed": "-0.0105204",
                "is_retro": "true",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 2,
                "element": "Air",
                "modality": "Fixed"
            },
            {
                "name": "Pluto",
                "full_degree": "246.7932892",
                "sign": "Sagittarius",
                "sign_no": 9,
                "longitude": "6:47:36",
                "speed": "-0.0272822",
                "is_retro": "true",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 12,
                "element": "Fire",
                "modality": "Mutable"
            },
            {
                "name": "MC",
                "full_degree": "179.2100153",
                "sign": "Virgo",
                "sign_no": 6,
                "longitude": "29:12:36",
                "speed": "393.4340076",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 9,
                "element": "Earth",
                "modality": "Mutable"
            },
            {
                "name": "Vertex",
                "full_degree": "125.5578055",
                "sign": "Leo",
                "sign_no": 5,
                "longitude": "5:33:28",
                "speed": "217.0398238",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 8,
                "element": "Fire",
                "modality": "Fixed"
            },
            {
                "name": "Chiron",
                "full_degree": "224.2683994",
                "sign": "Scorpio",
                "sign_no": 8,
                "longitude": "14:16:6",
                "speed": "-0.0686369",
                "is_retro": "true",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 11,
                "element": "Water",
                "modality": "Fixed"
            },
            {
                "name": "Lilith",
                "full_degree": "197.8546388",
                "sign": "Libra",
                "sign_no": 7,
                "longitude": "17:51:17",
                "speed": "0.1113347",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 10,
                "element": "Air",
                "modality": "Cardinal"
            }
        ],
        "p2_planetary_positions": [
            {
                "name": "Ascendant",
                "full_degree": "110.7290016",
                "sign": "Cancer",
                "sign_no": 4,
                "longitude": "20:43:44",
                "speed": "310.2181542",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 1,
                "element": "Water",
                "modality": "Cardinal"
            },
            {
                "name": "Sun",
                "full_degree": "258.0680076",
                "sign": "Sagittarius",
                "sign_no": 9,
                "longitude": "18:4:5",
                "speed": "1.01653",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 5,
                "element": "Fire",
                "modality": "Mutable"
            },
            {
                "name": "Moon",
                "full_degree": "286.7625766",
                "sign": "Capricorn",
                "sign_no": 10,
                "longitude": "16:45:45",
                "speed": "11.8464768",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 6,
                "element": "Earth",
                "modality": "Cardinal"
            },
            {
                "name": "Mars",
                "full_degree": "310.9955031",
                "sign": "Aquarius",
                "sign_no": 11,
                "longitude": "10:59:44",
                "speed": "0.7722369",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 7,
                "element": "Air",
                "modality": "Fixed"
            },
            {
                "name": "Mercury",
                "full_degree": "239.3237776",
                "sign": "Scorpio",
                "sign_no": 8,
                "longitude": "29:19:26",
                "speed": "1.3575734",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 5,
                "element": "Water",
                "modality": "Fixed"
            },
            {
                "name": "Venus",
                "full_degree": "215.4311882",
                "sign": "Scorpio",
                "sign_no": 8,
                "longitude": "5:25:52",
                "speed": "1.1736463",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 4,
                "element": "Water",
                "modality": "Fixed"
            },
            {
                "name": "Jupiter",
                "full_degree": "25.1852047",
                "sign": "Aries",
                "sign_no": 1,
                "longitude": "25:11:7",
                "speed": "-0.0349108",
                "is_retro": "true",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 10,
                "element": "Fire",
                "modality": "Cardinal"
            },
            {
                "name": "Saturn",
                "full_degree": "41.2415504",
                "sign": "Taurus",
                "sign_no": 2,
                "longitude": "11:14:30",
                "speed": "-0.0557535",
                "is_retro": "true",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 10,
                "element": "Earth",
                "modality": "Fixed"
            },
            {
                "name": "North node",
                "full_degree": "126.2004688",
                "sign": "Leo",
                "sign_no": 5,
                "longitude": "6:12:2",
                "speed": "-0.0529262",
                "is_retro": "true",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 1,
                "element": "Fire",
                "modality": "Fixed"
            },
            {
                "name": "South node",
                "full_degree": "306.2004688",
                "sign": "Aquarius",
                "sign_no": 11,
                "longitude": "6:12:2",
                "speed": "-0.0529262",
                "is_retro": "true",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 7,
                "element": "Air",
                "modality": "Fixed"
            },
            {
                "name": "Uranus",
                "full_degree": "313.8286059",
                "sign": "Aquarius",
                "sign_no": 11,
                "longitude": "13:49:43",
                "speed": "0.0384014",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 8,
                "element": "Air",
                "modality": "Fixed"
            },
            {
                "name": "Neptune",
                "full_degree": "302.4772616",
                "sign": "Aquarius",
                "sign_no": 11,
                "longitude": "2:28:38",
                "speed": "0.0291835",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 7,
                "element": "Air",
                "modality": "Fixed"
            },
            {
                "name": "Pluto",
                "full_degree": "250.637871",
                "sign": "Sagittarius",
                "sign_no": 9,
                "longitude": "10:38:16",
                "speed": "0.0387696",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 5,
                "element": "Fire",
                "modality": "Mutable"
            },
            {
                "name": "MC",
                "full_degree": "10.5951484",
                "sign": "Aries",
                "sign_no": 1,
                "longitude": "10:35:43",
                "speed": "391.3431827",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 9,
                "element": "Fire",
                "modality": "Cardinal"
            },
            {
                "name": "Vertex",
                "full_degree": "239.9060513",
                "sign": "Scorpio",
                "sign_no": 8,
                "longitude": "29:54:22",
                "speed": "221.0533711",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 5,
                "element": "Water",
                "modality": "Fixed"
            },
            {
                "name": "Chiron",
                "full_degree": "248.9918254",
                "sign": "Sagittarius",
                "sign_no": 9,
                "longitude": "8:59:31",
                "speed": "0.1239693",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 5,
                "element": "Fire",
                "modality": "Mutable"
            },
            {
                "name": "Lilith",
                "full_degree": "261.0245069",
                "sign": "Sagittarius",
                "sign_no": 9,
                "longitude": "21:1:28",
                "speed": "0.1114365",
                "is_retro": "false",
                "is_rising": "false",
                "is_setting": "false",
                "in_midheaven": "false",
                "house": 6,
                "element": "Fire",
                "modality": "Mutable"
            }
        ],
        "composite_planetary_positions": [
            {
                "name": "Ascendant",
                "full_degree": "183.9039373",
                "sign": "Libra",
                "sign_no": 7,
                "longitude": "3:54:14",
                "house": 1,
                "element": "Air",
                "modality": "Cardinal"
            },
            {
                "name": "Sun",
                "full_degree": "340.6487413",
                "sign": "Pisces",
                "sign_no": 12,
                "longitude": "10:38:55",
                "house": 6,
                "element": "Water",
                "modality": "Mutable"
            },
            {
                "name": "Moon",
                "full_degree": "346.6414625",
                "sign": "Pisces",
                "sign_no": 12,
                "longitude": "16:38:29",
                "house": 6,
                "element": "Water",
                "modality": "Mutable"
            },
            {
                "name": "Mars",
                "full_degree": "5.6605654",
                "sign": "Aries",
                "sign_no": 1,
                "longitude": "5:39:38",
                "house": 7,
                "element": "Fire",
                "modality": "Cardinal"
            },
            {
                "name": "Mercury",
                "full_degree": "322.2736030",
                "sign": "Aquarius",
                "sign_no": 11,
                "longitude": "22:16:24",
                "house": 5,
                "element": "Air",
                "modality": "Fixed"
            },
            {
                "name": "Venus",
                "full_degree": "299.6010458",
                "sign": "Capricorn",
                "sign_no": 10,
                "longitude": "29:36:03",
                "house": 4,
                "element": "Earth",
                "modality": "Cardinal"
            },
            {
                "name": "Jupiter",
                "full_degree": "9.4084869",
                "sign": "Aries",
                "sign_no": 1,
                "longitude": "9:24:30",
                "house": 7,
                "element": "Fire",
                "modality": "Cardinal"
            },
            {
                "name": "Saturn",
                "full_degree": "34.7963849",
                "sign": "Taurus",
                "sign_no": 2,
                "longitude": "4:47:46",
                "house": 8,
                "element": "Earth",
                "modality": "Fixed"
            },
            {
                "name": "North node",
                "full_degree": "141.1603183",
                "sign": "Leo",
                "sign_no": 5,
                "longitude": "21:09:37",
                "house": 11,
                "element": "Fire",
                "modality": "Fixed"
            },
            {
                "name": "South node",
                "full_degree": "321.1603183",
                "sign": "Aquarius",
                "sign_no": 11,
                "longitude": "21:09:37",
                "house": 5,
                "element": "Air",
                "modality": "Fixed"
            },
            {
                "name": "Uranus",
                "full_degree": "313.2758365",
                "sign": "Aquarius",
                "sign_no": 11,
                "longitude": "13:16:33",
                "house": 5,
                "element": "Air",
                "modality": "Fixed"
            },
            {
                "name": "Neptune",
                "full_degree": "302.2662352",
                "sign": "Aquarius",
                "sign_no": 11,
                "longitude": "2:15:58",
                "house": 4,
                "element": "Air",
                "modality": "Fixed"
            },
            {
                "name": "Pluto",
                "full_degree": "248.7155801",
                "sign": "Sagittarius",
                "sign_no": 9,
                "longitude": "8:42:56",
                "house": 3,
                "element": "Fire",
                "modality": "Mutable"
            },
            {
                "name": "MC",
                "full_degree": "94.9025819",
                "sign": "Cancer",
                "sign_no": 4,
                "longitude": "4:54:09",
                "house": 9,
                "element": "Water",
                "modality": "Cardinal"
            },
            {
                "name": "Vertex",
                "full_degree": "182.7319284",
                "sign": "Libra",
                "sign_no": 7,
                "longitude": "2:43:54",
                "house": 12,
                "element": "Air",
                "modality": "Cardinal"
            },
            {
                "name": "Chiron",
                "full_degree": "236.6301124",
                "sign": "Scorpio",
                "sign_no": 8,
                "longitude": "26:37:48",
                "house": 2,
                "element": "Water",
                "modality": "Fixed"
            },
            {
                "name": "Lilith",
                "full_degree": "229.4395728",
                "sign": "Scorpio",
                "sign_no": 8,
                "longitude": "19:26:22",
                "house": 2,
                "element": "Water",
                "modality": "Fixed"
            }
        ]
    }
}

Example Code Implementations

Below are example implementations in various programming environments.


cURL

curl --location 'https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'p1_full_name="Rahul Kumar"' \
--form 'p1_day="24"' \
--form 'p1_month="05"' \
--form 'p1_year="1998"' \
--form 'p1_hour="14"' \
--form 'p1_min="40"' \
--form 'p1_sec="43"' \
--form 'p1_gender="male"' \
--form 'p1_place="New Delhi"' \
--form 'p1_lat="28.7041"' \
--form 'p1_lon="77.1025"' \
--form 'p1_tzone="5.5"' \
--form 'p2_full_name="Simran Kumari"' \
--form 'p2_day="24"' \
--form 'p2_month="05"' \
--form 'p2_year="1998"' \
--form 'p2_hour="14"' \
--form 'p2_min="40"' \
--form 'p2_sec="43"' \
--form 'p2_gender="female"' \
--form 'p2_place="New Delhi"' \
--form 'p2_lat="28.7041"' \
--form 'p2_lon="77.1025"' \
--form 'p2_tzone="5.5"' \
--form 'lan="en"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'p1_full_name': 'Rahul Kumar',
    'p1_day': '24',
    'p1_month': '05',
    'p1_year': '1998',
    'p1_hour': '14',
    'p1_min': '40',
    'p1_sec': '43',
    'p1_gender': 'male',
    'p1_place': 'New Delhi',
    'p1_lat': '28.7041',
    'p1_lon': '77.1025',
    'p1_tzone': '5.5',
    'p2_full_name': 'Simran Kumari',
    'p2_day': '24',
    'p2_month': '05',
    'p2_year': '1998',
    'p2_hour': '14',
    'p2_min': '40',
    'p2_sec': '43',
    'p2_gender': 'female',
    'p2_place': 'New Delhi',
    'p2_lat': '28.7041',
    'p2_lon': '77.1025',
    'p2_tzone': '5.5',
    'lan': 'en'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

JavaScript jQuery AJAX

var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("p1_full_name", "Rahul Kumar");
form.append("p1_day", "24");
form.append("p1_month", "05");
form.append("p1_year", "1998");
form.append("p1_hour", "14");
form.append("p1_min", "40");
form.append("p1_sec", "43");
form.append("p1_gender", "male");
form.append("p1_place", "New Delhi");
form.append("p1_lat", "28.7041");
form.append("p1_lon", "77.1025");
form.append("p1_tzone", "5.5");
form.append("p2_full_name", "Simran Kumari");
form.append("p2_day", "24");
form.append("p2_month", "05");
form.append("p2_year", "1998");
form.append("p2_hour", "14");
form.append("p2_min", "40");
form.append("p2_sec", "43");
form.append("p2_gender", "female");
form.append("p2_place", "New Delhi");
form.append("p2_lat", "28.7041");
form.append("p2_lon", "77.1025");
form.append("p2_tzone", "5.5");
form.append("lan", "en");

var settings = {
  "url": "https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {Your Auth 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/composite/planetary-positions"

payload = {'api_key': '{Your API Key}',
'p1_full_name': 'Rahul Kumar',
'p1_day': '24',
'p1_month': '05',
'p1_year': '1998',
'p1_hour': '14',
'p1_min': '40',
'p1_sec': '43',
'p1_gender': 'male',
'p1_place': 'New Delhi',
'p1_lat': '28.7041',
'p1_lon': '77.1025',
'p1_tzone': '5.5',
'p2_full_name': 'Simran Kumari',
'p2_day': '24',
'p2_month': '05',
'p2_year': '1998',
'p2_hour': '14',
'p2_min': '40',
'p2_sec': '43',
'p2_gender': 'female',
'p2_place': 'New Delhi',
'p2_lat': '28.7041',
'p2_lon': '77.1025',
'p2_tzone': '5.5',
'lan': 'en'}

headers = {
  'Authorization': 'Bearer {Your Auth Token}'
}

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

print(response.text)

Implementation Notes

This composite endpoint requires both P1 and P2 birth details; ensure all mandatory fields for each person are provided before calling.

Coordinates must be decimal floats (lat, lon) and timezone in decimal hours (tzone, e.g., 5.5); invalid formats will lead to parsing errors or empty composites.

The response includes extended bodies (e.g., Chiron, Lilith, Nodes, MC, Vertex) and some boolean-like values as strings ("is_retro": "true"|"false"); normalize types in your client if needed.

Defaults: lan=en, house_system=P (Placidus); override house_system only if your application explicitly supports alternative systems.

Example Code
curl -X POST "https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions" \
  -H "Authorization: Bearer {Your Auth Token}" \
  --form 'api_key="{Your API Key}"' \
  --form 'p1_full_name="Rahul Kumar"' \
  --form 'p1_day="24"' \
  --form 'p1_month="05"' \
  --form 'p1_year="1998"' \
  --form 'p1_hour="14"' \
  --form 'p1_min="40"' \
  --form 'p1_sec="43"' \
  --form 'p1_gender="male"' \
  --form 'p1_place="New Delhi"' \
  --form 'p1_lat="28.7041"' \
  --form 'p1_lon="77.1025"' \
  --form 'p1_tzone="5.5"' \
  --form 'p2_full_name="Simran Kumari"' \
  --form 'p2_day="24"' \
  --form 'p2_month="05"' \
  --form 'p2_year="1998"' \
  --form 'p2_hour="14"' \
  --form 'p2_min="40"' \
  --form 'p2_sec="43"' \
  --form 'p2_gender="female"' \
  --form 'p2_place="New Delhi"' \
  --form 'p2_lat="28.7041"' \
  --form 'p2_lon="77.1025"' \
  --form 'p2_tzone="5.5"' \
  --form 'lan="en"'
const FormData = require('form-data');
const axios = require('axios');

const form = new FormData();
form.append('api_key', '{Your API Key}');
form.append('p1_full_name', 'Rahul Kumar');
form.append('p1_day', '24');
form.append('p1_month', '05');
form.append('p1_year', '1998');
form.append('p1_hour', '14');
form.append('p1_min', '40');
form.append('p1_sec', '43');
form.append('p1_gender', 'male');
form.append('p1_place', 'New Delhi');
form.append('p1_lat', '28.7041');
form.append('p1_lon', '77.1025');
form.append('p1_tzone', '5.5');
form.append('p2_full_name', 'Simran Kumari');
form.append('p2_day', '24');
form.append('p2_month', '05');
form.append('p2_year', '1998');
form.append('p2_hour', '14');
form.append('p2_min', '40');
form.append('p2_sec', '43');
form.append('p2_gender', 'female');
form.append('p2_place', 'New Delhi');
form.append('p2_lat', '28.7041');
form.append('p2_lon', '77.1025');
form.append('p2_tzone', '5.5');
form.append('lan', 'en');

const response = await axios.post('https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions', form, {
  headers: {
    ...form.getHeaders(),
    'Authorization': 'Bearer {Your Auth Token}',
  }
});

console.log(response.data);
import requests

url = "https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions"
headers = {
    "Authorization": "Bearer {Your Auth Token}",
}
payload = {
    "api_key": "{Your API Key}",
    "p1_full_name": "Rahul Kumar",
    "p1_day": "24",
    "p1_month": "05",
    "p1_year": "1998",
    "p1_hour": "14",
    "p1_min": "40",
    "p1_sec": "43",
    "p1_gender": "male",
    "p1_place": "New Delhi",
    "p1_lat": "28.7041",
    "p1_lon": "77.1025",
    "p1_tzone": "5.5",
    "p2_full_name": "Simran Kumari",
    "p2_day": "24",
    "p2_month": "05",
    "p2_year": "1998",
    "p2_hour": "14",
    "p2_min": "40",
    "p2_sec": "43",
    "p2_gender": "female",
    "p2_place": "New Delhi",
    "p2_lat": "28.7041",
    "p2_lon": "77.1025",
    "p2_tzone": "5.5",
    "lan": "en",
}

response = requests.post(url, headers=headers, data=payload)

print(response.json())
const formData = new FormData();
formData.append('api_key', '{Your API Key}');
formData.append('p1_full_name', 'Rahul Kumar');
formData.append('p1_day', '24');
formData.append('p1_month', '05');
formData.append('p1_year', '1998');
formData.append('p1_hour', '14');
formData.append('p1_min', '40');
formData.append('p1_sec', '43');
formData.append('p1_gender', 'male');
formData.append('p1_place', 'New Delhi');
formData.append('p1_lat', '28.7041');
formData.append('p1_lon', '77.1025');
formData.append('p1_tzone', '5.5');
formData.append('p2_full_name', 'Simran Kumari');
formData.append('p2_day', '24');
formData.append('p2_month', '05');
formData.append('p2_year', '1998');
formData.append('p2_hour', '14');
formData.append('p2_min', '40');
formData.append('p2_sec', '43');
formData.append('p2_gender', 'female');
formData.append('p2_place', 'New Delhi');
formData.append('p2_lat', '28.7041');
formData.append('p2_lon', '77.1025');
formData.append('p2_tzone', '5.5');
formData.append('lan', 'en');

const response = await fetch('https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions', {
  method: 'POST',
  headers: {
      'Authorization': "Bearer {Your Auth Token}",
    },
  body: formData,
});

const data = await response.json();
console.log(data);
<?php

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('POST', 'https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions', [
    'headers' => [
        'Authorization' => 'Bearer {Your Auth Token}',
    ],
    'multipart' => [
        ['name' => 'api_key', 'contents' => '{Your API Key}'],
        ['name' => 'p1_full_name', 'contents' => 'Rahul Kumar'],
        ['name' => 'p1_day', 'contents' => '24'],
        ['name' => 'p1_month', 'contents' => '05'],
        ['name' => 'p1_year', 'contents' => '1998'],
        ['name' => 'p1_hour', 'contents' => '14'],
        ['name' => 'p1_min', 'contents' => '40'],
        ['name' => 'p1_sec', 'contents' => '43'],
        ['name' => 'p1_gender', 'contents' => 'male'],
        ['name' => 'p1_place', 'contents' => 'New Delhi'],
        ['name' => 'p1_lat', 'contents' => '28.7041'],
        ['name' => 'p1_lon', 'contents' => '77.1025'],
        ['name' => 'p1_tzone', 'contents' => '5.5'],
        ['name' => 'p2_full_name', 'contents' => 'Simran Kumari'],
        ['name' => 'p2_day', 'contents' => '24'],
        ['name' => 'p2_month', 'contents' => '05'],
        ['name' => 'p2_year', 'contents' => '1998'],
        ['name' => 'p2_hour', 'contents' => '14'],
        ['name' => 'p2_min', 'contents' => '40'],
        ['name' => 'p2_sec', 'contents' => '43'],
        ['name' => 'p2_gender', 'contents' => 'female'],
        ['name' => 'p2_place', 'contents' => 'New Delhi'],
        ['name' => 'p2_lat', 'contents' => '28.7041'],
        ['name' => 'p2_lon', 'contents' => '77.1025'],
        ['name' => 'p2_tzone', 'contents' => '5.5'],
        ['name' => 'lan', 'contents' => 'en'],
    ],
]);

echo $response->getBody();
package main

import (
    "bytes"
    "fmt"
    "mime/multipart"
    "net/http"
    "io"
)

func main() {
    body := &bytes.Buffer{}
    writer := multipart.NewWriter(body)
    writer.WriteField("api_key", "{Your API Key}")
    writer.WriteField("p1_full_name", "Rahul Kumar")
    writer.WriteField("p1_day", "24")
    writer.WriteField("p1_month", "05")
    writer.WriteField("p1_year", "1998")
    writer.WriteField("p1_hour", "14")
    writer.WriteField("p1_min", "40")
    writer.WriteField("p1_sec", "43")
    writer.WriteField("p1_gender", "male")
    writer.WriteField("p1_place", "New Delhi")
    writer.WriteField("p1_lat", "28.7041")
    writer.WriteField("p1_lon", "77.1025")
    writer.WriteField("p1_tzone", "5.5")
    writer.WriteField("p2_full_name", "Simran Kumari")
    writer.WriteField("p2_day", "24")
    writer.WriteField("p2_month", "05")
    writer.WriteField("p2_year", "1998")
    writer.WriteField("p2_hour", "14")
    writer.WriteField("p2_min", "40")
    writer.WriteField("p2_sec", "43")
    writer.WriteField("p2_gender", "female")
    writer.WriteField("p2_place", "New Delhi")
    writer.WriteField("p2_lat", "28.7041")
    writer.WriteField("p2_lon", "77.1025")
    writer.WriteField("p2_tzone", "5.5")
    writer.WriteField("lan", "en")
    writer.Close()

    req, _ := http.NewRequest("POST", "https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions", body)
    req.Header.Set("Content-Type", writer.FormDataContentType())
    req.Header.Set("Authorization", "Bearer {Your Auth Token}")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body2, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body2))
}
import okhttp3.*;
import java.io.IOException;

public class Main {
    public static void main(String[] args) throws IOException {
        OkHttpClient client = new OkHttpClient();

        RequestBody body = new MultipartBody.Builder()
            .setType(MultipartBody.FORM)
            .addFormDataPart("api_key", "{Your API Key}")
            .addFormDataPart("p1_full_name", "Rahul Kumar")
            .addFormDataPart("p1_day", "24")
            .addFormDataPart("p1_month", "05")
            .addFormDataPart("p1_year", "1998")
            .addFormDataPart("p1_hour", "14")
            .addFormDataPart("p1_min", "40")
            .addFormDataPart("p1_sec", "43")
            .addFormDataPart("p1_gender", "male")
            .addFormDataPart("p1_place", "New Delhi")
            .addFormDataPart("p1_lat", "28.7041")
            .addFormDataPart("p1_lon", "77.1025")
            .addFormDataPart("p1_tzone", "5.5")
            .addFormDataPart("p2_full_name", "Simran Kumari")
            .addFormDataPart("p2_day", "24")
            .addFormDataPart("p2_month", "05")
            .addFormDataPart("p2_year", "1998")
            .addFormDataPart("p2_hour", "14")
            .addFormDataPart("p2_min", "40")
            .addFormDataPart("p2_sec", "43")
            .addFormDataPart("p2_gender", "female")
            .addFormDataPart("p2_place", "New Delhi")
            .addFormDataPart("p2_lat", "28.7041")
            .addFormDataPart("p2_lon", "77.1025")
            .addFormDataPart("p2_tzone", "5.5")
            .addFormDataPart("lan", "en")
            .build();

        Request request = new Request.Builder()
            .url("https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions")
            .post(body)
            .addHeader("Authorization", "Bearer {Your Auth Token}")
            .build();

        Response response = client.newCall(request).execute();
        System.out.println(response.body().string());
    }
}
import Foundation

let url = URL(string: "https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer {Your Auth Token}", forHTTPHeaderField: "Authorization")

let boundary = "Boundary-\(UUID().uuidString)"
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

var bodyData = Data()
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"api_key\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("{Your API Key}\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p1_full_name\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("Rahul Kumar\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p1_day\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("24\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p1_month\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("05\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p1_year\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("1998\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p1_hour\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("14\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p1_min\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("40\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p1_sec\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("43\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p1_gender\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("male\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p1_place\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("New Delhi\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p1_lat\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("28.7041\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p1_lon\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("77.1025\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p1_tzone\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("5.5\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p2_full_name\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("Simran Kumari\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p2_day\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("24\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p2_month\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("05\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p2_year\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("1998\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p2_hour\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("14\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p2_min\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("40\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p2_sec\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("43\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p2_gender\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("female\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p2_place\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("New Delhi\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p2_lat\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("28.7041\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p2_lon\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("77.1025\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"p2_tzone\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("5.5\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"lan\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("en\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)--\r\n".data(using: .utf8)!)
request.httpBody = bodyData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()
import okhttp3.*

fun main() {
    val client = OkHttpClient()

    val body = MultipartBody.Builder()
        .setType(MultipartBody.FORM)
        .addFormDataPart("api_key", "{Your API Key}")
        .addFormDataPart("p1_full_name", "Rahul Kumar")
        .addFormDataPart("p1_day", "24")
        .addFormDataPart("p1_month", "05")
        .addFormDataPart("p1_year", "1998")
        .addFormDataPart("p1_hour", "14")
        .addFormDataPart("p1_min", "40")
        .addFormDataPart("p1_sec", "43")
        .addFormDataPart("p1_gender", "male")
        .addFormDataPart("p1_place", "New Delhi")
        .addFormDataPart("p1_lat", "28.7041")
        .addFormDataPart("p1_lon", "77.1025")
        .addFormDataPart("p1_tzone", "5.5")
        .addFormDataPart("p2_full_name", "Simran Kumari")
        .addFormDataPart("p2_day", "24")
        .addFormDataPart("p2_month", "05")
        .addFormDataPart("p2_year", "1998")
        .addFormDataPart("p2_hour", "14")
        .addFormDataPart("p2_min", "40")
        .addFormDataPart("p2_sec", "43")
        .addFormDataPart("p2_gender", "female")
        .addFormDataPart("p2_place", "New Delhi")
        .addFormDataPart("p2_lat", "28.7041")
        .addFormDataPart("p2_lon", "77.1025")
        .addFormDataPart("p2_tzone", "5.5")
        .addFormDataPart("lan", "en")
        .build()

    val request = Request.Builder()
        .url("https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions")
        .post(body!!)
        .addHeader("Authorization", "Bearer {Your Auth Token}")
        .build()

    client.newCall(request).execute().use { response ->
        println(response.body?.string())
    }
}
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program {
    static async Task Main() {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer {Your Auth Token}");

        var content = new MultipartFormDataContent();
        content.Add(new StringContent("{Your API Key}"), "api_key");
        content.Add(new StringContent("Rahul Kumar"), "p1_full_name");
        content.Add(new StringContent("24"), "p1_day");
        content.Add(new StringContent("05"), "p1_month");
        content.Add(new StringContent("1998"), "p1_year");
        content.Add(new StringContent("14"), "p1_hour");
        content.Add(new StringContent("40"), "p1_min");
        content.Add(new StringContent("43"), "p1_sec");
        content.Add(new StringContent("male"), "p1_gender");
        content.Add(new StringContent("New Delhi"), "p1_place");
        content.Add(new StringContent("28.7041"), "p1_lat");
        content.Add(new StringContent("77.1025"), "p1_lon");
        content.Add(new StringContent("5.5"), "p1_tzone");
        content.Add(new StringContent("Simran Kumari"), "p2_full_name");
        content.Add(new StringContent("24"), "p2_day");
        content.Add(new StringContent("05"), "p2_month");
        content.Add(new StringContent("1998"), "p2_year");
        content.Add(new StringContent("14"), "p2_hour");
        content.Add(new StringContent("40"), "p2_min");
        content.Add(new StringContent("43"), "p2_sec");
        content.Add(new StringContent("female"), "p2_gender");
        content.Add(new StringContent("New Delhi"), "p2_place");
        content.Add(new StringContent("28.7041"), "p2_lat");
        content.Add(new StringContent("77.1025"), "p2_lon");
        content.Add(new StringContent("5.5"), "p2_tzone");
        content.Add(new StringContent("en"), "lan");

        var response = await client.PostAsync("https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}