Sun Sign Report

Endpoint POST https://starsapi.com/api/v3/vedic/predictions/sun-sign-report

Returns a comprehensive profile based on the Vedic Sun sign — the sidereal Surya rashi, the sign the Sun occupied at birth. In Vedic astrology the Sun signifies the soul (atma), ego, vitality, willpower, authority and the father, so this report reads a person's core sense of self and life-force. It covers 7 sections: overview, self & vitality, personality, strengths, weaknesses, career, and relationships. Content is pre-written by professional Vedic astrologers for all 12 Sun signs.

Authentication

Method	Example
Header (recommended)	`X-Api-Key: sa_live_xxxxxxxxxxxx`
Bearer	`Authorization: Bearer sa_live_xxxxxxxxxxxx`
Query	`?api_key=sa_live_xxxxxxxxxxxx`

Request body

Field	Type	Required	Description
`year`	integer	Yes	Birth year, 1800–2400.
`month`	integer	Yes	Birth month, 1–12.
`day`	integer	Yes	Day of month.
`hour`	integer	Yes	Hour, 0–23 (24-hour format).
`minute`	integer	Yes	Minute, 0–59.
`second`	integer	No	Default `0`.
`latitude`	number	Yes	Decimal degrees, −90…90.
`longitude`	number	Yes	Decimal degrees, −180…180.
`timezone`	string	Yes	IANA timezone identifier, e.g. `Asia/Kolkata`.
`ayanamsa`	string	No	Default `lahiri`.
`node_type`	string	No	`mean` (default) or `true`.
`language`	string	No	Default `en`. Supported: `en`, `es`, `fr`, `pt`, `it`, `de`, `ru`, `hi`, `ta`, `te`, `kn`, `ml`, `bn`.

Response shape

Top-level fields

Field	Type	Description
`language`	string	Language code used for interpretation texts.
`sun_sign`	string	Vedic Sun sign (Surya rashi) in English, e.g. `"Taurus"`.
`sun_sign_hindi`	string	Sun sign in Hindi (Devanagari), e.g. `"वृषभ"`.
`degree`	number	Sun's degree within the sign, 0–30.
`nakshatra`	string	Sun's nakshatra.
`nakshatra_pada`	integer	Nakshatra pada (quarter), 1–4.
`sections`	object	7 keyed sections, each with `title`, `text`, and `keywords`.

Section object

Each key inside sections contains the same structure:

Field	Type	Description
`title`	string	Human-readable section title.
`text`	string	Detailed interpretation paragraph, typically 80–150 words.
`keywords`	array	Array of 5–7 keyword strings summarizing the section.

Sections included

Key	Title	Description
`overview`	The … (evocative)	Rashi lord, element, quality, symbol, and the significance of the Sun's placement (incl. exaltation in Aries, debilitation in Libra, own sign Leo).
`core_self`	Self & Vitality	The Sun's core domain — identity, ego, willpower, vitality and life-force, and what the native needs to feel fully themselves.
`personality`	Personality	Outward temperament and character shaped by the Sun sign.
`strength`	Strengths	Natural gifts and advantages the placement confers.
`weakness`	Weaknesses	Ego pitfalls and shadow tendencies to watch.
`career`	Career & Vocation	Vocations and work environments that suit the Sun sign, incl. authority and leadership fit.
`relationships`	Love & Relationships	How the native relates and what they need from a partner.

Errors

HTTP	Code	Cause
400	`MISSING_FIELD`	Required field absent or not numeric.
400	`INVALID_DATE`	Year out of range or bad calendar date.
400	`INVALID_TIMEZONE`	Non-IANA timezone.
400	`INVALID_COORDINATE`	Latitude or longitude out of range.
400	`INVALID_PARAM`	Bad `node_type`, `ayanamsa`, or `language`.
405	`METHOD_NOT_ALLOWED`	Non-POST request.
500	`COMPUTE_ERROR`	Chart computation or Sun-position resolution failed.

Notes

Interpretations are based on the sidereal Sun sign (Surya rashi, Lahiri ayanamsa by default). The sidereal Sun sign is typically one sign earlier than the tropical/Western sun sign most people know.
All 12 Sun signs are covered with 7 sections each — 84 unique interpretation entries.
Content is pre-written, not AI-generated — deterministic, cacheable, and consistent across calls.
Pairs naturally with the Moon Sign Report (mind/emotions) and Nakshatra Report (birth star) for a complete luminary profile.

# Replace YOUR_API_KEY with the key from your dashboard
curl -X POST "https://starsapi.com/api/v3/vedic/predictions/sun-sign-report" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
    }'

const response = await fetch(
  'https://starsapi.com/api/v3/vedic/predictions/sun-sign-report',
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      year: 1990,
      month: 5,
      day: 20,
      hour: 14,
      minute: 30,
      second: 0,
      latitude: 28.6139,
      longitude: 77.209,
      timezone: 'Asia/Kolkata'
    })
  }
);
const result = await response.json();

if (result.success) {
  console.log(result.data);
}

import requests
import os

response = requests.post(
    'https://starsapi.com/api/v3/vedic/predictions/sun-sign-report',
    headers={'X-Api-Key': os.environ['STARSAPI_KEY']},
    json={
        'year': 1990,
        'month': 5,
        'day': 20,
        'hour': 14,
        'minute': 30,
        'second': 0,
        'latitude': 28.6139,
        'longitude': 77.209,
        'timezone': 'Asia/Kolkata'
    }
)
result = response.json()

if result['success']:
    print(result['data'])

<?php
$payload = [
    'year' => 1990,
    'month' => 5,
    'day' => 20,
    'hour' => 14,
    'minute' => 30,
    'second' => 0,
    'latitude' => 28.6139,
    'longitude' => 77.209,
    'timezone' => 'Asia/Kolkata',
];

$ch = curl_init('https://starsapi.com/api/v3/vedic/predictions/sun-sign-report');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-Api-Key: ' . getenv('STARSAPI_KEY'),
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

if ($data['success']) {
    print_r($data['data']);
}

import 'package:http/http.dart' as http;
import 'dart:convert';

Future<Map<String, dynamic>> getAscendant() async {
  final response = await http.post(
    Uri.parse('https://starsapi.com/api/v3/vedic/predictions/sun-sign-report'),
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: jsonEncode({
      'year': 1990,
      'month': 5,
      'day': 20,
      'hour': 14,
      'minute': 30,
      'second': 0,
      'latitude': 28.6139,
      'longitude': 77.209,
      'timezone': 'Asia/Kolkata',
    }),
  );
  return jsonDecode(response.body);
}

import Foundation

func getAscendant() async throws -> [String: Any] {
    var request = URLRequest(url: URL(string:
        "https://starsapi.com/api/v3/vedic/predictions/sun-sign-report"
    )!)
    request.httpMethod = "POST"
    request.setValue("YOUR_API_KEY", forHTTPHeaderField: "X-Api-Key")
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    request.httpBody = """
        {
            "year": 1990,
            "month": 5,
            "day": 20,
            "hour": 14,
            "minute": 30,
            "second": 0,
            "latitude": 28.6139,
            "longitude": 77.209,
            "timezone": "Asia/Kolkata"
        }
        """.data(using: .utf8)

    let (data, _) = try await URLSession.shared.data(for: request)
    return try JSONSerialization.jsonObject(with: data) as! [String: Any]
}

import okhttp3.*
import org.json.JSONObject

val client = OkHttpClient()
val JSON = "application/json; charset=utf-8".toMediaType()

fun getAscendant(callback: (JSONObject) -> Unit) {
    val payload = """
    {
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
    }
    """.trimIndent()

    val request = Request.Builder()
        .url("https://starsapi.com/api/v3/vedic/predictions/sun-sign-report")
        .addHeader("X-Api-Key", "YOUR_API_KEY")
        .post(payload.toRequestBody(JSON))
        .build()

    client.newCall(request).enqueue(object : Callback {
        override fun onResponse(call: Call, response: Response) {
            callback(JSONObject(response.body!!.string()))
        }
        override fun onFailure(call: Call, e: java.io.IOException) {
            e.printStackTrace()
        }
    })
}

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

func main() {
    payload, _ := json.Marshal(map[string]interface{}{
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata",
    })

    req, _ := http.NewRequest("POST",
        "https://starsapi.com/api/v3/vedic/predictions/sun-sign-report",
        bytes.NewBuffer(payload))
    req.Header.Set("X-Api-Key", os.Getenv("STARSAPI_KEY"))
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result["data"])
}

require 'net/http'
require 'json'

uri = URI('https://starsapi.com/api/v3/vedic/predictions/sun-sign-report')
payload = {
  'year' => 1990,
  'month' => 5,
  'day' => 20,
  'hour' => 14,
  'minute' => 30,
  'second' => 0,
  'latitude' => 28.6139,
  'longitude' => 77.209,
  'timezone' => 'Asia/Kolkata'
}

req = Net::HTTP::Post.new(uri)
req['X-Api-Key'] = ENV['STARSAPI_KEY']
req['Content-Type'] = 'application/json'
req.body = payload.to_json

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
res = http.request(req)

data = JSON.parse(res.body)
puts data['data'] if data['success']

200 RESPONSE

{
  "status": 200,
  "success": true,
  "data": {
    "language": "en",
    "sun_sign": "Taurus",
    "sun_sign_hindi": "वृषभ",
    "degree": 5.1120,
    "nakshatra": "Krittika",
    "nakshatra_pada": 3,
    "sections": {
      "overview": {
        "title": "The Steadfast Self",
        "text": "With the Sun in Vrishabha (Taurus), your identity is grounded in stability, endurance and the enjoyment of life's tangible goods…",
        "keywords": ["Venus-ruled", "Fixed earth", "Grounded identity", "Patient & determined", "Values security", "Immovable will"]
      },
      "core_self": {
        "title": "Self & Vitality",
        "text": "Your core identity rests on steadiness and substance — you define yourself by what you build, own and can rely on…",
        "keywords": ["Enduring vitality", "Steady identity", "Great staying power", "Immovable will", "Needs security", "Grounded strength"]
      },
      "personality": {
        "title": "Personality",
        "text": "You are steady, dependable and warmly grounded — the calm, reliable presence others build around…",
        "keywords": ["Steady", "Dependable", "Patient", "Practical", "Determined", "Loyal"]
      },
      "strength": {
        "title": "Strengths",
        "text": "Your strength is enduring reliability — a patient, determined constancy that builds lasting success where others give up…",
        "keywords": ["Reliability", "Endurance", "Patience", "Loyalty", "Productivity", "Practical strength"]
      },
      "weakness": {
        "title": "Weaknesses",
        "text": "Your steadiness can harden into stubbornness and resistance to change…",
        "keywords": ["Stubborn", "Resists change", "Possessive", "Materialistic", "Over-indulgent", "Slow to adapt"]
      },
      "career": {
        "title": "Career & Vocation",
        "text": "You excel in stable, tangible work that rewards patience and produces lasting value…",
        "keywords": ["Finance & real estate", "Arts & luxury", "Food & hospitality", "Agriculture & construction", "Craftsmanship", "Needs stability"]
      },
      "relationships": {
        "title": "Love & Relationships",
        "text": "In love you are devoted, sensual and steadfast — you commit deeply and love for the long haul…",
        "keywords": ["Devoted & sensual", "Steadfast", "Values security", "Possessive at times", "Loyal for life", "Home-loving"]
      }
    }
  },
  "meta": {
    "endpoint": "/api/v3/vedic/predictions/sun-sign-report",
    "version": "3.0",
    "response_time_ms": 3,
    "timestamp": "2026-07-16T22:52:04+05:30",
    "credits_remaining": 196454,
    "request_id": "d9e3b2a5c6f7d8e9",
    "ayanamsa": { "name": "Lahiri", "value": 23.725957, "value_dms": "23°43'33\"" },
    "node_type": "mean"
  }
}