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`

Example Response

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)