AstrologyAPI

Use access token to call astrology api.

Learn More

Matching Planet Details

POSThttps://json.astrologyapi.com/v1/match_planet_details
Copy

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.

POST/match_planet_details
Copy
1curl --location 'https://json.astrologyapi.com/v1/match_planet_details' \
2  --header 'Content-Type: application/json' \
3  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
4  --data '{
5    "m_day": 10,
6    "m_month": 5,
7    "m_year": 1990,
8    "m_hour": 11,
9    "m_min": 55,
10    "m_lat": 19.2056,
11    "m_lon": 25.2056,
12    "m_tzone": 5.5,
13    "f_day": 10,
14    "f_month": 5,
15    "f_year": 1990,
16    "f_hour": 11,
17    "f_min": 55,
18    "f_lat": 19.2056,
19    "f_lon": 25.2056,
20    "f_tzone": 5.5
21}'
22
200Response
Copy
1{
2  "male_planet_details": [
3    {
4      "id": 0,
5      "name": "Sun",
6      "fullDegree": 72.18954079246434,
7      "normDegree": 12.189540792464342,
8      "speed": 0.9537797443255392,
9      "isRetro": "false",
10      "sign": "Gemini",
11      "signLord": "Mercury",
12      "nakshatra": "Ardra",
13      "nakshatraLord": "Rahu",
14      "nakshatra_pad": 2,
15      "house": 9,
16      "is_planet_set": false,
17      "planet_awastha": "Yuva"
18    },
19    {
20      "id": 1,
21      "name": "Moon",
22      "fullDegree": 11.72351598586304,
23      "normDegree": 11.72351598586304,
24      "speed": 13.920316198066743,
25      "isRetro": "false",
26      "sign": "Aries",
27      "signLord": "Mars",
28      "nakshatra": "Ashwini",
29      "nakshatraLord": "Ketu",
30      "nakshatra_pad": 4,
31      "house": 7,
32      "is_planet_set": false,
33      "planet_awastha": "Kumara"
34    },
35    {
36      "id": 2,
37      "name": "Mars",
38      "fullDegree": 73.41992352157277,
39      "normDegree": 13.41992352157277,
40      "speed": 0.6649777633290916,
41      "isRetro": "false",
42      "sign": "Gemini",
43      "signLord": "Mercury",
44      "nakshatra": "Ardra",
45      "nakshatraLord": "Rahu",
46      "nakshatra_pad": 3,
47      "house": 9,
48      "is_planet_set": true,
49      "planet_awastha": "Yuva"
50    },
51    {
52      "id": 3,
53      "name": "Mercury",
54      "fullDegree": 85.49171301406825,
55      "normDegree": 25.491713014068253,
56      "speed": -0.29467903633858694,
57      "isRetro": "true",
58      "sign": "Gemini",
59      "signLord": "Mercury",
60      "nakshatra": "Punarvasu",
61      "nakshatraLord": "Jupiter",
62      "nakshatra_pad": 2,
63      "house": 9,
64      "is_planet_set": false,
65      "planet_awastha": "Mrit"
66    },
67    {
68      "id": 4,
69      "name": "Jupiter",
70      "fullDegree": 35.53009646668099,
71      "normDegree": 5.5300964666809875,
72      "speed": 0.2119922731034037,
73      "isRetro": "false",
74      "sign": "Taurus",
75      "signLord": "Venus",
76      "nakshatra": "Krittika",
77      "nakshatraLord": "Sun",
78      "nakshatra_pad": 3,
79      "house": 8,
80      "is_planet_set": false,
81      "planet_awastha": "Mrit"
82    },
83    {
84      "id": 5,
85      "name": "Venus",
86      "fullDegree": 76.57181911264793,
87      "normDegree": 16.57181911264793,
88      "speed": 1.2289765385390012,
89      "isRetro": "false",
90      "sign": "Gemini",
91      "signLord": "Mercury",
92      "nakshatra": "Ardra",
93      "nakshatraLord": "Rahu",
94      "nakshatra_pad": 3,
95      "house": 9,
96      "is_planet_set": true,
97      "planet_awastha": "Yuva"
98    },
99    {
100      "id": 6,
101      "name": "Saturn",
102      "fullDegree": 32.39707346334402,
103      "normDegree": 2.3970734633440216,
104      "speed": 0.10910000257030411,
105      "isRetro": "false",
106      "sign": "Taurus",
107      "signLord": "Venus",
108      "nakshatra": "Krittika",
109      "nakshatraLord": "Sun",
110      "nakshatra_pad": 2,
111      "house": 8,
112      "is_planet_set": false,
113      "planet_awastha": "Mrit"
114    },
115    {
116      "id": 7,
117      "name": "Rahu",
118      "fullDegree": 91.7592615626992,
119      "normDegree": 1.7592615626991943,
120      "speed": -0.05299201968813196,
121      "isRetro": "true",
122      "sign": "Cancer",
123      "signLord": "Moon",
124      "nakshatra": "Punarvasu",
125      "nakshatraLord": "Jupiter",
126      "nakshatra_pad": 4,
127      "house": 10,
128      "is_planet_set": false,
129      "planet_awastha": "Mrit"
130    },
131    {
132      "id": 8,
133      "name": "Ketu",
134      "fullDegree": 271.7592615626992,
135      "normDegree": 1.75926156269918,
136      "speed": -0.05299201968813196,
137      "isRetro": "true",
138      "sign": "Capricorn",
139      "signLord": "Saturn",
140      "nakshatra": "Uttra Shadha",
141      "nakshatraLord": "Sun",
142      "nakshatra_pad": 2,
143      "house": 4,
144      "is_planet_set": false,
145      "planet_awastha": "Mrit"
146    },
147    {
148      "id": 9,
149      "name": "Ascendant",
150      "fullDegree": 207.92868587120444,
151      "normDegree": 27.928685871204436,
152      "speed": 0,
153      "isRetro": false,
154      "sign": "Libra",
155      "signLord": "Venus",
156      "nakshatra": "Vishakha",
157      "nakshatraLord": "Jupiter",
158      "nakshatra_pad": 3,
159      "house": 1,
160      "is_planet_set": false,
161      "planet_awastha": "--"
162    }
163  ],
164  "female_planet_details": [
165    {
166      "id": 0,
167      "name": "Sun",
168      "fullDegree": 72.18954079246434,
169      "normDegree": 12.189540792464342,
170      "speed": 0.9537797443255392,
171      "isRetro": "false",
172      "sign": "Gemini",
173      "signLord": "Mercury",
174      "nakshatra": "Ardra",
175      "nakshatraLord": "Rahu",
176      "nakshatra_pad": 2,
177      "house": 9,
178      "is_planet_set": false,
179      "planet_awastha": "Yuva"
180    },
181    {
182      "id": 1,
183      "name": "Moon",
184      "fullDegree": 11.72351598586304,
185      "normDegree": 11.72351598586304,
186      "speed": 13.920316198066743,
187      "isRetro": "false",
188      "sign": "Aries",
189      "signLord": "Mars",
190      "nakshatra": "Ashwini",
191      "nakshatraLord": "Ketu",
192      "nakshatra_pad": 4,
193      "house": 7,
194      "is_planet_set": false,
195      "planet_awastha": "Kumara"
196    },
197    {
198      "id": 2,
199      "name": "Mars",
200      "fullDegree": 73.41992352157277,
201      "normDegree": 13.41992352157277,
202      "speed": 0.6649777633290916,
203      "isRetro": "false",
204      "sign": "Gemini",
205      "signLord": "Mercury",
206      "nakshatra": "Ardra",
207      "nakshatraLord": "Rahu",
208      "nakshatra_pad": 3,
209      "house": 9,
210      "is_planet_set": true,
211      "planet_awastha": "Yuva"
212    },
213    {
214      "id": 3,
215      "name": "Mercury",
216      "fullDegree": 85.49171301406825,
217      "normDegree": 25.491713014068253,
218      "speed": -0.29467903633858694,
219      "isRetro": "true",
220      "sign": "Gemini",
221      "signLord": "Mercury",
222      "nakshatra": "Punarvasu",
223      "nakshatraLord": "Jupiter",
224      "nakshatra_pad": 2,
225      "house": 9,
226      "is_planet_set": false,
227      "planet_awastha": "Mrit"
228    },
229    {
230      "id": 4,
231      "name": "Jupiter",
232      "fullDegree": 35.53009646668099,
233      "normDegree": 5.5300964666809875,
234      "speed": 0.2119922731034037,
235      "isRetro": "false",
236      "sign": "Taurus",
237      "signLord": "Venus",
238      "nakshatra": "Krittika",
239      "nakshatraLord": "Sun",
240      "nakshatra_pad": 3,
241      "house": 8,
242      "is_planet_set": false,
243      "planet_awastha": "Mrit"
244    },
245    {
246      "id": 5,
247      "name": "Venus",
248      "fullDegree": 76.57181911264793,
249      "normDegree": 16.57181911264793,
250      "speed": 1.2289765385390012,
251      "isRetro": "false",
252      "sign": "Gemini",
253      "signLord": "Mercury",
254      "nakshatra": "Ardra",
255      "nakshatraLord": "Rahu",
256      "nakshatra_pad": 3,
257      "house": 9,
258      "is_planet_set": true,
259      "planet_awastha": "Yuva"
260    },
261    {
262      "id": 6,
263      "name": "Saturn",
264      "fullDegree": 32.39707346334402,
265      "normDegree": 2.3970734633440216,
266      "speed": 0.10910000257030411,
267      "isRetro": "false",
268      "sign": "Taurus",
269      "signLord": "Venus",
270      "nakshatra": "Krittika",
271      "nakshatraLord": "Sun",
272      "nakshatra_pad": 2,
273      "house": 8,
274      "is_planet_set": false,
275      "planet_awastha": "Mrit"
276    },
277    {
278      "id": 7,
279      "name": "Rahu",
280      "fullDegree": 91.7592615626992,
281      "normDegree": 1.7592615626991943,
282      "speed": -0.05299201968813196,
283      "isRetro": "true",
284      "sign": "Cancer",
285      "signLord": "Moon",
286      "nakshatra": "Punarvasu",
287      "nakshatraLord": "Jupiter",
288      "nakshatra_pad": 4,
289      "house": 10,
290      "is_planet_set": false,
291      "planet_awastha": "Mrit"
292    },
293    {
294      "id": 8,
295      "name": "Ketu",
296      "fullDegree": 271.7592615626992,
297      "normDegree": 1.75926156269918,
298      "speed": -0.05299201968813196,
299      "isRetro": "true",
300      "sign": "Capricorn",
301      "signLord": "Saturn",
302      "nakshatra": "Uttra Shadha",
303      "nakshatraLord": "Sun",
304      "nakshatra_pad": 2,
305      "house": 4,
306      "is_planet_set": false,
307      "planet_awastha": "Mrit"
308    },
309    {
310      "id": 9,
311      "name": "Ascendant",
312      "fullDegree": 207.92868587120444,
313      "normDegree": 27.928685871204436,
314      "speed": 0,
315      "isRetro": false,
316      "sign": "Libra",
317      "signLord": "Venus",
318      "nakshatra": "Vishakha",
319      "nakshatraLord": "Jupiter",
320      "nakshatra_pad": 3,
321      "house": 1,
322      "is_planet_set": false,
323      "planet_awastha": "--"
324    }
325  ]
326}

Request Headers

x-astrologyapi-key

string

required

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

Accept-Language

string

Preferred language for the response content

Properties

English - enHindi - hiMarathi - maBengali - bnTamil - taTelugu - teMalayalam - mlKannada - kn

Request Body (JSON)

m_day

int

required

Day of birth, eg: 10

m_month

int

required

Month of birth, eg: 5

m_year

int

required

Year of birth, eg: 1990

m_hour

int

required

Hour of birth, eg: 11

m_min

int

required

Minute of birth, eg: 55

m_lat

float

required

Latitude, eg: 19.2056

m_lon

float

required

Longitude, eg: 25.2056

m_tzone

float

required

Timezone, eg: 5.5

f_day

int

required

Day of birth, eg: 10

f_month

int

required

Month of birth, eg: 5

f_year

int

required

Year of birth, eg: 1990

f_hour

int

required

Hour of birth, eg: 11

f_min

int

required

Minute of birth, eg: 55

f_lat

float

required

Latitude, eg: 19.2056

f_lon

float

required

Longitude, eg: 25.2056

f_tzone

float

required

Timezone, eg: 5.5

Errors

400
Bad Request

Something is wrong with your request format or parameters.

401
Unauthorized

Your API key is missing or invalid.

403
Forbidden

You don't have permission to access this specific resource.

404
Not Found

The API endpoint you're trying to reach doesn't exist.

500
Internal Server Error

Our server is having a temporary glitch.