Logo

SEARCH ASTRO INSIGHT API DOCS

Home Vedic Astrology
POST Vedic API v1

Favourable Lord Report

The Favourable Lord Report API provides Numerology related calculations and insights based on Vedic Astrology principles. This endpoint is designed for astrology applications, report generation systems, horoscope platforms, and developer integrations requiring structured JSON responses and reliable REST API access.

https://json.astroinsightapi.com/api/v1/numerology/favourable-lord
Credit Cost
1 Credit
Avg Latency
~32ms
Auth Type
Basic Auth
Format
JSON / UTF-8

Available Response Languages

🇬🇧 English en
🇮🇳 Hindi hi

API Overview & Calculation Details

Methodology and astrological context for Favourable Lord Report.

The Favourable Lord Report API generates a personalised report identifying the most auspicious planetary lords for an individual based on their numerological profile. By analysing a person's name and date of birth, this endpoint determines which planetary deities or ruling lords are most favourable for them, providing guidance on how to harness their positive energies for success, well-being, and spiritual growth.

What This API Does

This API combines numerology with Vedic planetary science to identify the ruling lords — planets or deities — that are most aligned with an individual's core numerological numbers. It derives key numerological values from the person's name and birth date, such as the life path number, name number, and destiny number, and maps these to the nine planets (Navagrahas) of Vedic astrology. The result is a detailed report identifying which planetary lords are favourable, neutral, or unfavourable for the individual, along with guidance on how to strengthen their positive influence.

What Data It Returns

The response includes a structured report containing:

  • Numerological profile — key numbers derived from the person's name and date of birth, including life path, name, and destiny numbers

  • Favourable planetary lords — a ranked or categorised list of planets (e.g., Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu) identified as most beneficial for the individual

  • Planetary characteristics — descriptions of each favourable lord's qualities, domains of influence (e.g., wealth, health, relationships, career), and associated energies

  • Remedies and propitiation methods — recommended practices to strengthen the influence of favourable lords, such as mantras, gemstones, colours, days, or rituals

  • Unfavourable or neutral lords — identification of planets that may present challenges or require caution, with corresponding mitigation guidance

  • Numerology-to-planet mapping — the correspondence between the individual's numerological numbers and their ruling planetary lords

Main Use Cases

  • Personal guidance and life planning — Help individuals understand which planetary energies support their goals and how to align their actions with favourable cosmic forces

  • Gemstone and remedy recommendations — Power applications that suggest gemstones, metals, or colours based on an individual's favourable planetary lords

  • Astrology and numerology platforms — Enrich horoscope and numerology services with detailed planetary lord analysis for a more comprehensive personal reading

  • Spiritual and ritual planning — Guide users in selecting the right days, mantras, or deities for worship and spiritual practices based on their favourable lords

  • Career and relationship counselling — Assist users in making important life decisions by understanding which planetary energies are working in their favour at a given time

  • Wellness and lifestyle apps — Integrate planetary lord guidance into holistic wellness platforms to offer personalised lifestyle, diet, and routine recommendations

Key Functionality

  • Accepts a person's full namedaymonth, and year of birth as input

  • Derives numerological values from the name and birth date to establish the individual's core numerological identity

  • Maps numerological numbers to the nine Vedic planets (Navagrahas) to identify favourable, neutral, and unfavourable lords

  • Provides actionable remedies and recommendations for each favourable planetary lord

  • Returns a language-aware response based on the Accept-Language header, supporting multilingual output

  • Suitable for integration into astrology, spirituality, wellness, and personal development applications

Request Parameters

Payload specifications for JSON request body.

application/json
Parameter Type Description & Example
name
Required
string
Full Name.
Example: Sanjay
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

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 Favourable Lord Report.

What is the Favourable Lord Report API and what data does it provide?

The Favourable Lord Report API provides authentic Numerology 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 Favourable Lord Report?

The Favourable Lord Report 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 Favourable Lord Report endpoint consume?

Each calculation request to Favourable Lord Report consumes 1 API credit. The endpoint delivers high performance with an average response time of ~32ms.

How do I authenticate with the Favourable Lord Report 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 Favourable Lord Report responses in regional Indian languages?

Yes! The API supports multiple languages including English, Hindi. 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 Favourable Lord Report?

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 numerology/favourable-lord
Presets:
Live Output
Click Send above to execute calculation.
Sample Output

API Categories