Matching Basic Astro Details API
Align the stars for a prosperous union with the Matching Basic Astro Details API, which evaluates the foundational astrological parameters of two individuals for Kundali Matching within Indian Astrology.
Step by Step Matching Basic Astro Details API Postman Testing Integration
Step by Step Matching Basic Astro Details API Postman Testing Integration
Supported Language Codes
Support Article URL
https://support.divineapi.com/general-api-support/translating-an-indian-vedic-apis-into-a-different-language
| Code | Language |
|---|---|
| en | English |
| hi | Hindi |
| bn | Bengali |
| ma | Marathi |
| tm | Tamil |
| tl | Telugu |
| ml | Malayalam |
| kn | Kannada |
Guide
These languages are supported by this API. Pass "lan" in the request body with one of the above codes to get the response in that language. If omitted, the default is en.
API Endpoint
POST https://astroapi-3.divineapi.com/indian-api/v3/matching/basic-astro-details
Description
This API returns the basic astrological profile of two people (P1 and P2) needed for Kundali Matching. It calculates and returns birth data, lunar details, nakshatra, rashi, tithi, paksha, paya, guna-related classifications (like gana, nadi, yoni, vashya, varna), and other calendar attributes for each person.
You can use this API as a building block before running higher-level matching or dosha checks.
Headers
| Name | Type | Description |
|---|---|---|
| Authorization* | String | Your API Access Token, e.g. Bearer {token} |
Request Body
| Name | Type | Description |
|---|---|---|
| api_key* | String | Your API key |
| p1_full_name* | String | Person 1 full name, e.g. Rahul Kumar |
| p1_day* | Integer | Person 1 date of birth, e.g. 24 |
| p1_month* | Integer | Person 1 month of birth, e.g. 05 |
| p1_year* | Integer | Person 1 year of birth, e.g. 1998 |
| p1_hour* | Integer | Person 1 hour of birth (24h), e.g. 14 |
| p1_min* | Integer | Person 1 minute, e.g. 40 |
| p1_sec* | Integer | Person 1 second, e.g. 43 |
| p1_gender* | String | Person 1 gender, e.g. male |
| p1_place* | String | Person 1 birth place, e.g. New Delhi |
| p1_lat* | Float | Person 1 latitude, e.g. 28.7041 |
| p1_lon* | Float | Person 1 longitude, e.g. 77.1025 |
| p1_tzone* | Float | Person 1 timezone, e.g. 5.5 |
| p2_full_name* | String | Person 2 full name, e.g. Simran Kumari |
| p2_day* | Integer | Person 2 date of birth |
| p2_month* | Integer | Person 2 month of birth |
| p2_year* | Integer | Person 2 year of birth |
| p2_hour* | Integer | Person 2 hour of birth |
| p2_min* | Integer | Person 2 minute |
| p2_sec* | Integer | Person 2 second |
| p2_gender* | String | Person 2 gender, e.g. female |
| p2_place* | String | Person 2 birth place |
| p2_lat* | Float | Person 2 latitude |
| p2_lon* | Float | Person 2 longitude |
| p2_tzone* | Float | Person 2 timezone |
| lan | String | Optional language code from the supported list, default en |
200: OK Matching Basic Astro Details Fetched Successfully
{
"success": 1,
"data": {
"p1": {
"full_name": "Rahul Chauhan",
"year": 1990,
"month": 6,
"day": 24,
"hour": 14,
"minute": 30,
"gender": "male",
"place": "New Delhi",
"latitude": 28.6139,
"longitude": 77.209,
"timezone": 5.5,
"sunrise": "1990-06-24 05:24:47",
"sunset": "1990-06-24 19:22:31",
"tithi": "Dwitiya",
"paksha": "Shukla",
"paya": {
"type": "Silver",
"result": "Best"
},
"sunsign": "Gemini",
"moonsign": "Cancer",
"rashi_akshar": "ही, हू, हे, हो, डा, डी, डु, डे, डो",
"chandramasa": "Ashaada",
"tatva": "Watery",
"prahar": 3,
"nakshatra": "Punarvasu",
"vaar": "Sunday",
"varna": "Brahmin",
"vashya": "Jalchar",
"yoni": "Marjar",
"gana": "Dev",
"nadi": "Adi",
"yoga": "Dhruv",
"karana": "Kaulava",
"ayanamsha": "23.80933",
"yunja": "Madhya"
},
"p2": {
"full_name": "Priya Sharma",
"year": 1992,
"month": 8,
"day": 15,
"hour": 9,
"minute": 45,
"gender": "female",
"place": "Mumbai",
"latitude": 19.076,
"longitude": 72.8777,
"timezone": 5.5,
"sunrise": "1992-08-15 06:19:32",
"sunset": "1992-08-15 19:06:02",
"tithi": "Dwitiya",
"paksha": "Krishna",
"paya": {
"type": "Copper",
"result": "Good"
},
"sunsign": "Cancer",
"moonsign": "Aquarius",
"rashi_akshar": "गू, गे, गो, स, सी, सू, से, सो, द",
"chandramasa": "Shraavana",
"tatva": "Airy",
"prahar": 2,
"nakshatra": "Satabhisha",
"vaar": "Saturday",
"varna": "Shudra",
"vashya": "Biped",
"yoni": "Ashwa",
"gana": "Rakshasa",
"nadi": "Adi",
"yoga": "Atiganda",
"karana": "Gar",
"ayanamsha": "23.837259",
"yunja": "Antya"
}
}
}Example Integrations
Below are examples of how you might call this API using different programming languages and environments.
cURL
curl --location 'https://astroapi-3.divineapi.com/indian-api/v3/matching/basic-astro-details' \
--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-3.divineapi.com/indian-api/v3/matching/basic-astro-details',
'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-3.divineapi.com/indian-api/v3/matching/basic-astro-details",
"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-3.divineapi.com/indian-api/v3/matching/basic-astro-details"
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)