GET/v1/astro/nakshatra/{name}

Nakshatra Profile

Returns the complete classical profile of one nakshatra, from deity and ruling planet to favourable activities and body map. The profile covers deity, ruling planet, gana, nature, body part, profession, life themes, strengths, challenges, favorable/unfavorable activities, and body map. The name is matched ignoring case, spaces, hyphens and common romanisation differences (e.g. 'uttarashadha' finds Uttara Ashadha, 'Aswini' finds Ashwini); an unknown name returns 404 with the 27 valid names.

Request parameters

namerequired

string

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.name

string

data.index

integer

data.interpretation

object

data.activities

object

data.body_map

object

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Ayanamsha Values
• Graha Nature
• Generate Kundali chart SVG
• Natal Chart — Janam Kundali

Request

GET·application/json

curl

curl -X GET "https://api.asterwise.com/v1/astro/nakshatra/Ashwini" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import asterwise
from asterwise.api.astrology_api import AstrologyApi

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

with asterwise.ApiClient(configuration) as client:
    api = AstrologyApi(client)
    result = api.nakshatra(name="Ashwini")
    print(result)

TypeScript

import { createClient, createConfig, nakshatra } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await nakshatra({
  client,
  path: {
      "name": "Ashwini"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "name": "Ashwini",
    "index": 0,
    "interpretation": {
      "nakshatra_number": 1,
      "name": "Ashwini",
      "sanskrit": "अश्विनी",
      "span": "Aries 0°00' to 13°20'",
      "symbol": "Horse's head",
      "deity": "Ashwini Kumaras (divine twin physicians)",
      "ruling_planet": "Ketu",
      "sign": "Aries",
      "sign_lord": "Mars",
      "gana": "Deva (divine)",
      "nature": "Laghu (light) and Kshipra (swift)",
      "body_part": "Knees",
      "varna": "Kshatriya",
      "yoni": "Horse (Male)",
      "nadi": "Adi (Vata)",
      "classical_qualities": [
        "Swift and pioneering",
        "Healing ability",
        "... and 3 more items"
      ],
      "classical_specific_notes": {
        "text": "Brihat Jataka describes the Ashwini native as priyabhushanah — deeply fond of ornaments and personal adornment — combine…"
      },
      "padas": [
        {
          "pada": 1,
          "span": "Aries 0°00' to 3°20'",
          "navamsa_sign": "Aries",
          "navamsa_lord": "Mars",
          "vargottama": true,
          "special_note": "Gandanta — first pada of fire sign Aries. Intense karmic beginning. Planets here carry both exceptional force and karmic…"
        },
        {
          "pada": 2,
          "span": "Aries 3°20' to 6°40'",
          "navamsa_sign": "Taurus",
          "navamsa_lord": "Venus",
          "vargottama": false,
          "special_note": ""
        },
        "... and 2 more items"
      ],
      "appearance": {
        "classical": "Broad forehead, bright quick-darting eyes, magnetic countenance, athletic and agile build",
        "modern": "The native likely carries a youthful, energetic presence with bright, alert eyes and an athletic build. A brisk, purpose…"
      },
      "nature_description": {
        "classical": "Impulsive, pioneering, fiercely independent, unbridled life force, quick to act, pure and innocent intentions, deep well…",
        "modern": "The native's defining quality is the energy of a fresh beginning — the native initiates, pioneers, and acts before other…"
      },
      "profession": {
        "primary": [
          "Medicine",
          "Surgery",
          "... and 3 more items"
        ],
        "secondary": [
          "Military",
          "Law enforcement",
          "... and 4 more items"
        ],
        "modern": "The native thrives in fast-paced environments where immediate action produces tangible results. Medicine, emergency serv…"
      },
      "life_themes": {
        "core": "Journey from impulsive action to sustained spiritual realization",
        "karmic_path": "Ketu as nakshatra lord brings sudden beginnings, abrupt transformations, and a soul-level drive toward liberation",
        "challenge": "Bridling immense vitality and channeling it into sustained achievement rather than scattered brilliant starts",
        "gift": "Natural healing ability and the courage to act immediately when others are paralyzed by hesitation",
        "modern": "The native's life moves in sudden leaps rather than gradual progressions. Each major chapter begins abruptly and transfo…"
      },
      "keywords": [
        "healing",
        "pioneering",
        "... and 5 more items"
      ],
      "gifts": [
        "Natural healer",
        "Extraordinary physical vitality",
        "... and 3 more items"
      ],
      "growth_areas": [
        "Impulsiveness",
        "Inability to sustain long-term",
        "... and 2 more items"
      ]
    },
    "activities": {
      "favorable_activities": [
        "starting treatments",
        "travel beginnings",
        "... and 3 more items"
      ],
      "unfavorable_activities": [
        "long-term marriage rites",
        "foundational house-warming",
        "... and 1 more item"
      ]
    },
    "body_map": {
      "parts": [
        "head",
        "brain",
        "... and 1 more item"
      ],
      "sensitivity": "Quick-reactive constitution; stress can show first in the head region."
    }
  }
}