🌍 Astrocartography API, 🔷 Human Design API and ✋ Palmistry API are now live. Ship them in your app today.

Matching Planet Details

The match_planet_details API returns details of all nine planets and lagna for both male and female. The response includes details such as planet name, degree, speed, sign, nakshatra, nakshatra lord, and house.
POSThttps://json.astrologyapi.com/v1/match_planet_details

Authentication

x-astrologyapi-keystringrequired

API access token used to authenticate requests. Send your access token in this custom header.

Accept-Languagestring

Preferred language for the response content. Supported: English - en, Hindi - hi, Marathi - ma, Bengali - bn, Tamil - ta, Telugu - te, Malayalam - ml, Kannada - kn.

Body parameters

m_dayintrequired

Day of birth, eg: 10

m_monthintrequired

Month of birth, eg: 5

m_yearintrequired

Year of birth, eg: 1990

m_hourintrequired

Hour of birth, eg: 11

m_minintrequired

Minute of birth, eg: 55

m_latfloatrequired

Latitude, eg: 19.2056

m_lonfloatrequired

Longitude, eg: 25.2056

m_tzonefloatrequired

Timezone, eg: 5.5

f_dayintrequired

Day of birth, eg: 10

f_monthintrequired

Month of birth, eg: 5

f_yearintrequired

Year of birth, eg: 1990

f_hourintrequired

Hour of birth, eg: 11

f_minintrequired

Minute of birth, eg: 55

f_latfloatrequired

Latitude, eg: 19.2056

f_lonfloatrequired

Longitude, eg: 25.2056

f_tzonefloatrequired

Timezone, eg: 5.5

← Previous
Matching Astro Details
Next →
Matching Ashtakoot Points
curl --location 'https://json.astrologyapi.com/v1/match_planet_details' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "m_day": 10,
    "m_month": 5,
    "m_year": 1990,
    "m_hour": 11,
    "m_min": 55,
    "m_lat": 19.2056,
    "m_lon": 25.2056,
    "m_tzone": 5.5,
    "f_day": 10,
    "f_month": 5,
    "f_year": 1990,
    "f_hour": 11,
    "f_min": 55,
    "f_lat": 19.2056,
    "f_lon": 25.2056,
    "f_tzone": 5.5
}'
Try it

Runs with sample data — no API key needed

{
  "male_planet_details": [
    {
      "id": 0,
      "name": "Sun",
      "fullDegree": 72.18954079246434,
      "normDegree": 12.189540792464342,
      "speed": 0.9537797443255392,
      "isRetro": "false",
      "sign": "Gemini",
      "signLord": "Mercury",
      "nakshatra": "Ardra",
      "nakshatraLord": "Rahu",
      "nakshatra_pad": 2,
      "house": 9,
      "is_planet_set": false,
      "planet_awastha": "Yuva"
    },
    {
      "id": 1,
      "name": "Moon",
      "fullDegree": 11.72351598586304,
      "normDegree": 11.72351598586304,
      "speed": 13.920316198066743,
      "isRetro": "false",
      "sign": "Aries",
      "signLord": "Mars",
      "nakshatra": "Ashwini",
      "nakshatraLord": "Ketu",
      "nakshatra_pad": 4,
      "house": 7,
      "is_planet_set": false,
      "planet_awastha": "Kumara"
    },
    {
      "id": 2,
      "name": "Mars",
      "fullDegree": 73.41992352157277,
      "normDegree": 13.41992352157277,
      "speed": 0.6649777633290916,
      "isRetro": "false",
      "sign": "Gemini",
      "signLord": "Mercury",
      "nakshatra": "Ardra",
      "nakshatraLord": "Rahu",
      "nakshatra_pad": 3,
      "house": 9,
      "is_planet_set": true,
      "planet_awastha": "Yuva"
    },
    {
      "id": 3,
      "name": "Mercury",
      "fullDegree": 85.49171301406825,
      "normDegree": 25.491713014068253,
      "speed": -0.29467903633858694,
      "isRetro": "true",
      "sign": "Gemini",
      "signLord": "Mercury",
      "nakshatra": "Punarvasu",
      "nakshatraLord": "Jupiter",
      "nakshatra_pad": 2,
      "house": 9,
      "is_planet_set": false,
      "planet_awastha": "Mrit"
    },
    {
      "id": 4,
      "name": "Jupiter",
      "fullDegree": 35.53009646668099,
      "normDegree": 5.5300964666809875,
      "speed": 0.2119922731034037,
      "isRetro": "false",
      "sign": "Taurus",
      "signLord": "Venus",
      "nakshatra": "Krittika",
      "nakshatraLord": "Sun",
      "nakshatra_pad": 3,
      "house": 8,
      "is_planet_set": false,
      "planet_awastha": "Mrit"
    },
    {
      "id": 5,
      "name": "Venus",
      "fullDegree": 76.57181911264793,
      "normDegree": 16.57181911264793,
      "speed": 1.2289765385390012,
      "isRetro": "false",
      "sign": "Gemini",
      "signLord": "Mercury",
      "nakshatra": "Ardra",
      "nakshatraLord": "Rahu",
      "nakshatra_pad": 3,
      "house": 9,
      "is_planet_set": true,
      "planet_awastha": "Yuva"
    },
    {
      "id": 6,
      "name": "Saturn",
      "fullDegree": 32.39707346334402,
      "normDegree": 2.3970734633440216,
      "speed": 0.10910000257030411,
      "isRetro": "false",
      "sign": "Taurus",
      "signLord": "Venus",
      "nakshatra": "Krittika",
      "nakshatraLord": "Sun",
      "nakshatra_pad": 2,
      "house": 8,
      "is_planet_set": false,
      "planet_awastha": "Mrit"
    },
    {
      "id": 7,
      "name": "Rahu",
      "fullDegree": 91.7592615626992,
      "normDegree": 1.7592615626991943,
      "speed": -0.05299201968813196,
      "isRetro": "true",
      "sign": "Cancer",
      "signLord": "Moon",
      "nakshatra": "Punarvasu",
      "nakshatraLord": "Jupiter",
      "nakshatra_pad": 4,
      "house": 10,
      "is_planet_set": false,
      "planet_awastha": "Mrit"
    },
    {
      "id": 8,
      "name": "Ketu",
      "fullDegree": 271.7592615626992,
      "normDegree": 1.75926156269918,
      "speed": -0.05299201968813196,
      "isRetro": "true",
      "sign": "Capricorn",
      "signLord": "Saturn",
      "nakshatra": "Uttra Shadha",
      "nakshatraLord": "Sun",
      "nakshatra_pad": 2,
      "house": 4,
      "is_planet_set": false,
      "planet_awastha": "Mrit"
    },
    {
      "id": 9,
      "name": "Ascendant",
      "fullDegree": 207.92868587120444,
      "normDegree": 27.928685871204436,
      "speed": 0,
      "isRetro": false,
      "sign": "Libra",
      "signLord": "Venus",
      "nakshatra": "Vishakha",
      "nakshatraLord": "Jupiter",
      "nakshatra_pad": 3,
      "house": 1,
      "is_planet_set": false,
      "planet_awastha": "--"
    }
  ],
  "female_planet_details": [
    {
      "id": 0,
      "name": "Sun",
      "fullDegree": 72.18954079246434,
      "normDegree": 12.189540792464342,
      "speed": 0.9537797443255392,
      "isRetro": "false",
      "sign": "Gemini",
      "signLord": "Mercury",
      "nakshatra": "Ardra",
      "nakshatraLord": "Rahu",
      "nakshatra_pad": 2,
      "house": 9,
      "is_planet_set": false,
      "planet_awastha": "Yuva"
    },
    {
      "id": 1,
      "name": "Moon",
      "fullDegree": 11.72351598586304,
      "normDegree": 11.72351598586304,
      "speed": 13.920316198066743,
      "isRetro": "false",
      "sign": "Aries",
      "signLord": "Mars",
      "nakshatra": "Ashwini",
      "nakshatraLord": "Ketu",
      "nakshatra_pad": 4,
      "house": 7,
      "is_planet_set": false,
      "planet_awastha": "Kumara"
    },
    {
      "id": 2,
      "name": "Mars",
      "fullDegree": 73.41992352157277,
      "normDegree": 13.41992352157277,
      "speed": 0.6649777633290916,
      "isRetro": "false",
      "sign": "Gemini",
      "signLord": "Mercury",
      "nakshatra": "Ardra",
      "nakshatraLord": "Rahu",
      "nakshatra_pad": 3,
      "house": 9,
      "is_planet_set": true,
      "planet_awastha": "Yuva"
    },
    {
      "id": 3,
      "name": "Mercury",
      "fullDegree": 85.49171301406825,
      "normDegree": 25.491713014068253,
      "speed": -0.29467903633858694,
      "isRetro": "true",
      "sign": "Gemini",
      "signLord": "Mercury",
      "nakshatra": "Punarvasu",
      "nakshatraLord": "Jupiter",
      "nakshatra_pad": 2,
      "house": 9,
      "is_planet_set": false,
      "planet_awastha": "Mrit"
    },
    {
      "id": 4,
      "name": "Jupiter",
      "fullDegree": 35.53009646668099,
      "normDegree": 5.5300964666809875,
      "speed": 0.2119922731034037,
      "isRetro": "false",
      "sign": "Taurus",
      "signLord": "Venus",
      "nakshatra": "Krittika",
      "nakshatraLord": "Sun",
      "nakshatra_pad": 3,
      "house": 8,
      "is_planet_set": false,
      "planet_awastha": "Mrit"
    },
    {
      "id": 5,
      "name": "Venus",
      "fullDegree": 76.57181911264793,
      "normDegree": 16.57181911264793,
      "speed": 1.2289765385390012,
      "isRetro": "false",
      "sign": "Gemini",
      "signLord": "Mercury",
      "nakshatra": "Ardra",
      "nakshatraLord": "Rahu",
      "nakshatra_pad": 3,
      "house": 9,
      "is_planet_set": true,
      "planet_awastha": "Yuva"
    },
    {
      "id": 6,
      "name": "Saturn",
      "fullDegree": 32.39707346334402,
      "normDegree": 2.3970734633440216,
      "speed": 0.10910000257030411,
      "isRetro": "false",
      "sign": "Taurus",
      "signLord": "Venus",
      "nakshatra": "Krittika",
      "nakshatraLord": "Sun",
      "nakshatra_pad": 2,
      "house": 8,
      "is_planet_set": false,
      "planet_awastha": "Mrit"
    },
    {
      "id": 7,
      "name": "Rahu",
      "fullDegree": 91.7592615626992,
      "normDegree": 1.7592615626991943,
      "speed": -0.05299201968813196,
      "isRetro": "true",
      "sign": "Cancer",
      "signLord": "Moon",
      "nakshatra": "Punarvasu",
      "nakshatraLord": "Jupiter",
      "nakshatra_pad": 4,
      "house": 10,
      "is_planet_set": false,
      "planet_awastha": "Mrit"
    },
    {
      "id": 8,
      "name": "Ketu",
      "fullDegree": 271.7592615626992,
      "normDegree": 1.75926156269918,
      "speed": -0.05299201968813196,
      "isRetro": "true",
      "sign": "Capricorn",
      "signLord": "Saturn",
      "nakshatra": "Uttra Shadha",
      "nakshatraLord": "Sun",
      "nakshatra_pad": 2,
      "house": 4,
      "is_planet_set": false,
      "planet_awastha": "Mrit"
    },
    {
      "id": 9,
      "name": "Ascendant",
      "fullDegree": 207.92868587120444,
      "normDegree": 27.928685871204436,
      "speed": 0,
      "isRetro": false,
      "sign": "Libra",
      "signLord": "Venus",
      "nakshatra": "Vishakha",
      "nakshatraLord": "Jupiter",
      "nakshatra_pad": 3,
      "house": 1,
      "is_planet_set": false,
      "planet_awastha": "--"
    }
  ]
}