Logo

SEARCH ASTRO INSIGHT API DOCS

Home Vedic Astrology
POST Vedic API v1

Manglik Dosha

The Manglik Dosha API provides horoscope dosha related data and calculations using Vedic Astrology principles. This endpoint is designed for astrology applications, kundli generation, horoscope platforms, and developer integrations requiring accurate JSON-based responses and scalable REST API access.

https://json.astroinsightapi.com/api/v1/horoscope-dosha/manglik
Credit Cost
1 Credit
Avg Latency
~62ms
Auth Type
Basic Auth
Format
JSON / UTF-8

Available Response Languages

🇬🇧 English en
🇮🇳 Hindi hi
🇮🇳 Marathi ma

API Overview & Calculation Details

Methodology and astrological context for Manglik Dosha.

Manglik Dosha

Detects and analyses the Manglik Dosha (also known as Mangal Dosha or Kuja Dosha) in a person's Vedic birth chart, based on their birth date, time, and geographic location.

What this API does

In Vedic astrology, Manglik Dosha is one of the most widely referenced afflictions, particularly in the context of marriage compatibility. It occurs when Mars (Mangal) is placed in certain houses of the birth chart — traditionally the 1st, 2nd, 4th, 7th, 8th, or 12th house — from the Lagna (Ascendant), Moon, or Venus. This placement is believed to introduce intensity, conflict, and challenges in marital and partnership dynamics.

This endpoint computes the position of Mars in the birth chart for the given birth data, evaluates the Manglik Dosha conditions across the relevant reference points, and returns a clear determination of whether the dosha is present along with supporting interpretive details.

What data it returns

The API returns a structured JSON response containing:

  • Dosha presence: A clear indication of whether Manglik Dosha is present in the birth chart
  • Dosha level: The degree or intensity of the dosha (e.g., high Manglik, low Manglik, or non-Manglik), reflecting how strongly Mars's placement activates the affliction
  • Mars house position: The house occupied by Mars in the birth chart, which is the primary determinant of the dosha
  • Reference point analysis: Assessment of the dosha from multiple reference points (Lagna, Moon, Venus) as per classical rules
  • Cancellation (Dosha Bhanga): Whether any classical cancellation conditions apply that neutralise or reduce the dosha's effect
  • Interpretive description: A textual explanation of the dosha's significance, its potential effects on relationships and marriage, and relevant astrological context

Main use cases

  • Kundali matching and marriage compatibility platforms that need to assess Manglik Dosha status for both prospective partners before evaluating overall compatibility
  • Horoscope analysis tools that include a dedicated dosha section as part of a complete birth chart reading
  • Matrimonial and matchmaking applications that surface Manglik status as a key filter or compatibility signal for users
  • Astrology consultation services where practitioners require a quick, accurate Manglik assessment to advise clients on marriage timing and partner selection
  • Personal astrology apps that inform users about significant planetary afflictions in their chart and their implications for relationships

Request Parameters

Payload specifications for JSON request body.

application/json
Parameter Type Description & Example
day
Required
integer
Day of birth (1–31).
Example: 15
month
Required
integer
Month of birth (1–12).
Example: 9
year
Required
integer
Year of birth (e.g., 1994).
Example: 1994
hour
Required
integer
Hour of birth in 24-hour format (0–23).
Example: 12
min
Required
integer
Minute of birth (0–59).
Example: 30
sec
Optional
integer
Second of birth (0–59). Optional. If not provided, it is considered as 0.
Example: 30
lat
Required
float
Latitude of the birth location.
Example: 28.6139
lon
Required
float
Longitude of the birth location.
Example: 77.1025
tzone
Optional
float
Timezone offset from UTC. Optional. If not provided, it is considered as 5.5 (IST).
Example: 5.5

Required & Optional Headers

Header Key Value / Format Description
Authorization
Required
Basic {base64} Base64 encoded string of CLIENT_ID:CLIENT_SECRET.
Content-Type
Required
application/json Specifies JSON payload format in request body.
Accept-Language
Optional
en, hi, ta, te... Returns localized astrology output. Default: en
X-Ayanamsha
Optional
lahiri, raman, krishnamurti... Ayanamsha system: lahiri, raman, fagan_bradley, usha_shashi, krishnamurti, djwhal_khul, yukteshwar, jn_bhasin, suryasiddhanta, aryabhata. Default: lahiri

Frequently Asked Questions

Comprehensive developer guidance for Manglik Dosha.

What is the Manglik Dosha API and what data does it provide?

The Manglik Dosha API provides authentic Horoscope Dosha calculations based on Vedic astrology algorithms. It returns structured JSON data containing detailed planetary positions, house calculations, and astrological parameters suitable for Kundli apps, astrology websites, and developer applications.

What input parameters are required to call Manglik Dosha?

The Manglik Dosha API requires standard Vedic birth details: day, month, year, hour, min, sec, latitude (lat), longitude (lon), and timezone (tzone). All parameters can be passed in the JSON request body.

How many credits does the Manglik Dosha endpoint consume?

Each calculation request to Manglik Dosha consumes 1 API credit. The endpoint delivers high performance with an average response time of ~62ms.

How do I authenticate with the Manglik Dosha API?

Authenticate using HTTP Basic Authentication by including your Base64 encoded client_id:client_secret credentials in the Authorization header (Authorization: Basic BASE64(client_id:client_secret)).

Can I get Manglik Dosha responses in regional Indian languages?

Yes! The API supports multiple languages including English, Hindi, Marathi. Pass your desired language code (e.g. 'hi' for Hindi, 'ta' for Tamil, 'en' for English) in the Accept-Language request header.

Which Ayanamsha systems can be calculated with Manglik Dosha?

Supported Ayanamshas include NC Lahiri (Default), BV Raman, Krishnamurti (KP), Fagan Bradley, Usha Shashi, Djwhal Khul, Sri Yukteshwar, JN Bhasin, Surya Siddhanta, and Aryabhata. Specify your choice using the X-Ayanamsha header.

What response format and HTTP codes does this API return?

The API returns clean JSON UTF-8 output. Successful requests return HTTP 200 OK with the computed data payload. Parameter validation errors return HTTP 422 with actionable error messages.

POST horoscope-dosha/manglik
Presets:
Live Output
Click Send above to execute calculation.
Sample Output

API Categories