# Nakshatra API

> Nakshatra API. Get the complete list of 27 nakshatras (lunar mansions) in Vedic astrology. Returns names, zodiac ranges, ruling planets, presiding

- Capability page: https://roxyapi.com/apis/nakshatra-api
- Full domain: https://roxyapi.com/products/vedic-astrology-api
- OpenAPI spec: https://roxyapi.com/api/v2/vedic-astrology/openapi.json
- Remote MCP server: https://roxyapi.com/mcp/vedic-astrology

## Overview

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.

## Endpoints

- `GET /api/v2/vedic-astrology/nakshatras` List all 27 Nakshatras - Lunar Mansions Reference
- `GET /api/v2/vedic-astrology/nakshatras/{id}` Get Nakshatra by ID - Lunar Mansion Detail

## Example request

```bash
curl "https://roxyapi.com/api/v2/vedic-astrology/nakshatras" \
  -H "X-API-Key: YOUR_KEY"
```

## Example response

```json
[
  {
    "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."
    }
  }
]
```

## Remote MCP

Every endpoint is a callable tool on the Remote MCP server at https://roxyapi.com/mcp/vedic-astrology over Streamable HTTP. Tool name for `GET /vedic-astrology/nakshatras`: `get_vedic_astrology_nakshatras`. `tools/list` is free; `tools/call` bills the same as REST.

## 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.

## Full reference

Fetch the OpenAPI spec at https://roxyapi.com/api/v2/vedic-astrology/openapi.json. Master agent manifest at https://roxyapi.com/llms.txt.
