Nakshatra API

Lunar Mansions Reference

GET/vedic-astrology/nakshatrasGET/vedic-astrology/nakshatras/{id}

Get the complete list of 27 nakshatras (lunar mansions) in Vedic astrology. Returns names, zodiac ranges, ruling planets, presiding deities, symbols, personality characteristics, and traditional remedies (mantras, gemstones, rituals) for each nakshatra from Ashwini to Revati. Essential for nakshatra lookup tables, dasha period calculations, muhurta selection, and astrology app reference data.

Request

GET /api/v2/vedic-astrology/nakshatras

Parameters

ParameterTypeDescription
langquerystring enumResponse language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English. Default en.

Response

Structured JSON with documented fields, verified against NASA JPL Horizons across 828 gold-standard tests. Not hallucinated text.

200 OK
[
  {
    "id": "ashwini",
    "name": "Ashwini",
    "number": 1,
    "range": "0 to 13 degrees 20 minutes Aries",
    "lord": "Ketu",
    "deity": "Ashwini Kumaras (celestial healers)",
    "symbol": "Horse's Head",
    "characteristics": "Energetic, pioneering, natural problem-solvers.",
    "remedies": {
      "mantras": "Chanting mantras dedicated to the Ashwini Kumaras can boost healing and vitality.",
      "gemstones": "Cat's eye or garnet to harness Ketu's energy.",
      "rituals": "Early morning meditation and engaging in acts of charity."
    }
  }
]

Response fields

FieldTypeDescription
[].id*stringUnique slug identifier for the nakshatra. Used in URL paths and cross-references.
[].name*stringNakshatra name as used in Vedic astrology. One of 27 lunar mansions spanning 13 degrees 20 minutes each.
[].number*numberSequential number (1-27) of this nakshatra in the zodiac starting from 0 degrees Aries.
[].range*stringSidereal longitude range this nakshatra occupies within its zodiac sign.
[].lord*stringRuling planet (nakshatra lord) used in Vimshottari dasha calculations. Determines the planetary period sequence.
[].deity*stringPresiding deity of the nakshatra. Influences the spiritual qualities and mythology associated with natives.
[].symbol*stringTraditional symbol representing this nakshatra. Reflects its core nature and energy.
[].characteristics*stringPersonality traits, behavioral tendencies, and life themes for natives born under this nakshatra.
[].remedies*objectTraditional Vedic remedies including mantras, gemstones, and rituals for this nakshatra.
[].remedies.mantras*stringRecommended mantras for this nakshatra to enhance positive qualities.
[].remedies.gemstones*stringRecommended gemstones aligned with the ruling planet of this nakshatra.
[].remedies.rituals*stringSpiritual practices and daily rituals beneficial for natives of this nakshatra.

Supported options

lang

entrdeeshiptfrru

Call it in your language in seconds.

Every snippet is generated from the live OpenAPI spec, so method names, parameters, and fields always match production.

TypeScript
import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.vedicAstrology.listNakshatras()
Install: npm install @roxyapi/sdk

Prefer to try before you write code? Run this Vedic Astrology endpoint live in the API playground and inspect a real production response.

More Nakshatra endpoints

The Nakshatra API bundles these related endpoints under one key.

GET/vedic-astrology/nakshatras/{id}

Get Nakshatra by ID - Lunar Mansion Detail

Get detailed information for a single nakshatra (lunar mansion) by its ID slug. Returns name, zodiac range, ruling planet, presiding deity, symbol, personality characteristics, and traditional remedies including mantras, gemstones, and rituals.

Try it live

Remote MCP for AI agents

Every Vedic Astrology endpoint is a callable tool on the Remote MCP server over Streamable HTTP. No local setup, no Docker. Claude, ChatGPT, Cursor, and any MCP client auto-discover the tools and ground their answers in verified data.

Claude Code / Cursor
claude mcp add --transport http \
  roxy-vedic-astrology https://roxyapi.com/mcp/vedic-astrology \
  --header "X-API-Key: YOUR_KEY"

Tool name for GET /vedic-astrology/nakshatras: get_vedic_astrology_nakshatras. Full MCP setup guide

What you can build

Matrimonial matchmaking platforms - automate Gun Milan compatibility scoring, Manglik dosha checks, Navamsa spouse analysis, and generate match reports with remedies for Shaadi.com-style features

Daily horoscope and prediction apps - fetch planetary transits, current Dasha periods, Panchang data, and birth star forecasts to power personalized daily readings at consumer-app scale

Kundli generation and PDF report services - combine D1/D9 charts, planetary positions, Dasha timelines, yoga detection, and dosha analysis into automated birth chart reports

KP horary and event prediction apps - build stellar astrology software with significator analysis, cusp sub-lords, and 249-level precision for answering when/yes-no questions

Spiritual wellness and calendar apps - integrate Panchang for Hindu festival dates, fasting calendars, temple muhurat selection, and Nakshatra-based meditation schedules

AI astrology chatbots and virtual consultants - power conversational AI with structured Vedic calculations, compatibility queries, Dasha predictions, and remedy suggestions via ChatGPT plugins or MCP integration

Drop-in UI components

Render Nakshatra API responses without building charts yourself. These open source, framework-agnostic web components take the typed response and draw it, in React, Vue, Svelte, Angular, plain HTML, and WordPress.

<roxy-nakshatra-card>
See them live on Roxy UI

Related capabilities

Nakshatra API FAQ

What does the Nakshatra API return?

Get the complete list of 27 nakshatras (lunar mansions) in Vedic astrology. Every response is structured JSON with documented fields, not free text, so you map it straight into your product.

How do I authenticate with the Nakshatra API?

Pass your key in the X-API-Key header on every request. Keys are delivered instantly at checkout with no approval queue. Use a secret sk key server side, or mint a publishable pk key locked to your origins for browser and no-code use.

Does the Nakshatra API support multiple languages?

Yes. Append the lang query parameter to any endpoint for responses in English, German, Spanish, French, Hindi, Portuguese, Russian and Turkish. The translated payload includes the full interpretation text, not just field labels.

Is the Nakshatra API available over Remote MCP for AI agents?

Yes. Every endpoint is exposed as a callable tool on the Remote MCP server at https://roxyapi.com/mcp/vedic-astrology over Streamable HTTP, so Claude, ChatGPT, Cursor, and any MCP client auto-discover it with no local setup or Docker.

How is the Nakshatra API billed?

Flat pricing: 1 request equals 1 quota unit, REST and MCP identical, with no credit weighting or per-token markup. Every plan includes all 12 domains, so the Nakshatra API is included at no extra cost.

What lang values does the Nakshatra API accept?

The lang parameter accepts en, tr, de, es, hi, pt, fr, ru. Case-insensitive where it is a path value.

Start using Nakshatra API today.

Launch your Jyotish or KP astrology product in days. Not months.

All 12 domains included with every plan. Every endpoint, MCP server, SDK, and starters.

Plans from $39/mo, starting at $2.70 per domain on annual billing. No credit card required for testing.

View Pricing & Get API Key