Logo

SEARCH ASTRO INSIGHT API DOCS

Home Vedic Astrology
POST Vedic API v1

Lal Kitab Mukabla Grah

The Lal Kitab Mukabla Grah API identifies competing or conflicting planetary influences according to Lal Kitab astrology, helping astrologers understand planetary interactions.

https://json.astroinsightapi.com/api/v1/lalkitab/mukabla-grah
Credit Cost
1 Credit
Avg Latency
~63ms
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 Lal Kitab Mukabla Grah.

The Lal Kitab Mukabla Grah API identifies and analyses opposing or confronting planets (Mukabla Grah) in a native's birth chart according to the Lal Kitab astrological system. In Lal Kitab, certain planetary placements create a state of mutual opposition or confrontation — where one planet's energy directly clashes with or challenges another — producing specific karmic tensions, life obstacles, and remedial requirements unique to this system.

This API accepts a native's birth date, time, and geographic coordinates, computes the planetary positions using the specified Ayanamsha, and then evaluates the chart for all significant Mukabla (confrontational) planetary relationships.


What data it returns

  • A list of confronting planet pairs identified in the birth chart, along with the houses they occupy and the nature of their opposition
  • The karmic significance and life-area impact of each Mukabla Grah combination (e.g., effects on wealth, relationships, health, career)
  • Strength and intensity indicators for each confrontational pairing
  • Lal Kitab-specific remedial suggestions associated with each identified Mukabla Grah to mitigate adverse effects
  • An overall summary of how the confronting planets collectively influence the native's life trajectory

Main use cases

  • Karmic conflict analysis — Identifying planetary confrontations that manifest as recurring life challenges, blockages, or karmic debts in the native's chart
  • Personalised remedy generation — Providing targeted Lal Kitab remedies (totkas) based on the specific Mukabla Grah combinations present in the chart
  • Horoscope report enrichment — Embedding Mukabla Grah analysis as a dedicated section within comprehensive Lal Kitab horoscope reports
  • Astrology applications and platforms — Powering features in Jyotish or Lal Kitab-focused apps that surface planetary conflict insights to end users
  • Counselling and guidance tools — Supporting astrologers and practitioners in delivering structured, data-driven Lal Kitab consultations

Key functionality

  • Mukabla Grah detection — Applies Lal Kitab's unique rules for identifying confronting planets, which differ from classical Vedic opposition concepts and are specific to house-based planetary interactions in this system
  • Configurable Ayanamsha — Supports multiple Ayanamsha settings (e.g., Lahiri, Raman, KP) via the X-Ayanamsha header, ensuring compatibility with different Jyotish calculation traditions
  • Geographic precision — Uses latitude, longitude, and timezone inputs to compute accurate local planetary positions for the birth location
  • Lal Kitab remedial framework — Returns remedies grounded in the Lal Kitab tradition, including practical, accessible suggestions tied directly to the identified confrontational pairs
  • Multi-language support — Responses can be localised via the Accept-Language header, making the API suitable for regional and multilingual astrology platforms
  • Seamless integration — Designed to complement other Lal Kitab endpoints (horoscope, remedies, planetary strength) within the AstroInsight API suite for building complete Lal Kitab-based astrological experiences

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 Lal Kitab Mukabla Grah.

What is the Lal Kitab Mukabla Grah API and what data does it provide?

The Lal Kitab Mukabla Grah API provides authentic Lal Kitab 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 Lal Kitab Mukabla Grah?

The Lal Kitab Mukabla Grah 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 Lal Kitab Mukabla Grah endpoint consume?

Each calculation request to Lal Kitab Mukabla Grah consumes 1 API credit. The endpoint delivers high performance with an average response time of ~63ms.

How do I authenticate with the Lal Kitab Mukabla Grah 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 Lal Kitab Mukabla Grah 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 Lal Kitab Mukabla Grah?

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 lalkitab/mukabla-grah
Presets:
Live Output
Click Send above to execute calculation.
Sample Output

API Categories