Varga Signs

Endpoint POST https://starsapi.com/api/v3/vedic/charts/varga-signs

Returns the sign occupied by each planet across all 16 Parashari divisional charts in a single call — the “Signs occupied in the 16 divisions” table. Each row is one varga (D1–D60), each column is one of the 9 Vedic planets.

This is a table-first endpoint: the response is shaped so you can loop it directly into a grid without any post-processing. For the corresponding dignity table, call /charts/varga-dignities. For single-chart planet data, use /charts/varga-planets.

Authentication

Required. Three methods accepted:

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

See authentication for security considerations.

Request body

Send a JSON object with Content-Type: application/json. Standard birth data — no chart parameter needed (all 16 are always returned).

Field	Type	Required	Description
`year`	integer	Yes	Birth year, 4-digit (e.g. `1990`).
`month`	integer	Yes	Birth month, `1`–`12`.
`day`	integer	Yes	Day of month, `1`–`31`.
`hour`	integer	Yes	Hour in 24-hour local clock time, `0`–`23`.
`minute`	integer	Yes	Minute, `0`–`59`.
`second`	integer	No	Second, `0`–`59`. Default `0`.
`latitude`	number	Yes	Signed decimal degrees, −90…90. Positive = North.
`longitude`	number	Yes	Signed decimal degrees, −180…180. Positive = East.
`timezone`	string	Yes	IANA timezone identifier (e.g. `Asia/Kolkata`).
`ayanamsa`	string	No	Default `lahiri`. Full list →
`node_type`	string	No	`mean` (default) or `true`.

Response shape

data.charts is an array of 16 objects, one per varga in order (D1, D2, D3, D4, D7, D9, D10, D12, D16, D20, D24, D27, D30, D40, D45, D60). Each object has code, name, and the sign name for each of the 9 Vedic planets.

Field	Type	Description
charts[]
`code`	string	Varga code (e.g. `D9`).
`name`	string	Sanskrit chart name (e.g. `Navamsa`).
`Sun`	string	Sign occupied by Sun in this varga.
`Moon`	string	Sign occupied by Moon.
`Mars`	string	Sign occupied by Mars.
`Mercury`	string	Sign occupied by Mercury.
`Jupiter`	string	Sign occupied by Jupiter.
`Venus`	string	Sign occupied by Venus.
`Saturn`	string	Sign occupied by Saturn.
`Rahu`	string	Sign occupied by Rahu.
`Ketu`	string	Sign occupied by Ketu.
top-level
`total_charts`	integer	Always `16`.

Use cases

16-varga sign grid — render the classic “Signs occupied in the 16 divisions” table directly from the response.
Vargottama detection — compare D1 and D9 rows to find planets in the same sign in both charts.
Sign repetition analysis — count how many vargas a planet appears in the same sign to gauge its varga strength.
Cross-varga comparison — display side-by-side how a planet moves through different vargas for research or teaching.

Errors

HTTP	Code	Cause
400	`MISSING_FIELD`	A required birth field is absent.
400	`INVALID_DATE`	Invalid calendar date.
400	`INVALID_TIME`	Hour/minute/second out of range.
400	`INVALID_TIMEZONE`	Numeric or non-IANA timezone.
400	`INVALID_COORDINATE`	`latitude` / `longitude` out of range.
401	`AUTH_MISSING_KEY`	No API key in request.
401	`AUTH_INVALID_KEY`	Key format invalid or not found.
401	`AUTH_REVOKED_KEY`	Key has been revoked.
403	`AUTH_ORIGIN_DENIED`	Request from non-whitelisted origin.
405	`METHOD_NOT_ALLOWED`	Non-POST request.
429	`RATE_LIMIT_EXCEEDED`	Plan quota exceeded.
500	`CALCULATION_ERROR`	Ephemeris calculation failed.

Error response format

{
  "success": false,
  "error": {
    "code": "INVALID_TIMEZONE",
    "message": "Unrecognised timezone: 'Asia/Calcutta_'. Use a valid IANA identifier such as 'Asia/Kolkata'."
  }
}

# Replace YOUR_API_KEY with the key from your dashboard
curl -X POST "https://starsapi.com/api/v3/vedic/charts/varga-signs" \
  -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/charts/varga-signs',
  {
    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/charts/varga-signs',
    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/charts/varga-signs');
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/charts/varga-signs'),
    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/charts/varga-signs"
    )!)
    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/charts/varga-signs")
        .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/charts/varga-signs",
        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/charts/varga-signs')
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": {
    "charts": [
      { "code": "D1",  "name": "Rashi",           "Sun": "Taurus",      "Moon": "Pisces",     "Mars": "Aquarius",    "Mercury": "Aries",     "Jupiter": "Gemini",      "Venus": "Pisces",     "Saturn": "Capricorn",  "Rahu": "Capricorn",  "Ketu": "Cancer" },
      { "code": "D2",  "name": "Hora",            "Sun": "Cancer",      "Moon": "Cancer",     "Mars": "Cancer",      "Mercury": "Leo",       "Jupiter": "Cancer",      "Venus": "Leo",        "Saturn": "Cancer",     "Rahu": "Leo",        "Ketu": "Leo" },
      { "code": "D3",  "name": "Drekkana",        "Sun": "Taurus",      "Moon": "Pisces",     "Mars": "Libra",       "Mercury": "Leo",       "Jupiter": "Libra",       "Venus": "Scorpio",    "Saturn": "Capricorn",  "Rahu": "Taurus",     "Ketu": "Scorpio" },
      { "code": "D4",  "name": "Chaturthamsa",    "Sun": "Taurus",      "Moon": "Gemini",     "Mars": "Scorpio",     "Mercury": "Cancer",    "Jupiter": "Sagittarius", "Venus": "Sagittarius","Saturn": "Capricorn",  "Rahu": "Cancer",     "Ketu": "Capricorn" },
      { "code": "D7",  "name": "Saptamsa",        "Sun": "Sagittarius", "Moon": "Libra",      "Mars": "Leo",         "Mercury": "Cancer",    "Jupiter": "Virgo",       "Venus": "Aquarius",   "Saturn": "Cancer",     "Rahu": "Scorpio",    "Ketu": "Taurus" },
      { "code": "D9",  "name": "Navamsa",         "Sun": "Aquarius",    "Moon": "Virgo",      "Mars": "Gemini",      "Mercury": "Leo",       "Jupiter": "Pisces",      "Venus": "Aquarius",   "Saturn": "Capricorn",  "Rahu": "Gemini",     "Ketu": "Sagittarius" },
      { "code": "D10", "name": "Dasamsa",         "Sun": "Aquarius",    "Moon": "Capricorn",  "Mars": "Scorpio",     "Mercury": "Leo",       "Jupiter": "Scorpio",     "Venus": "Cancer",     "Saturn": "Virgo",      "Rahu": "Aquarius",   "Ketu": "Leo" },
      { "code": "D12", "name": "Dwadasamsa",      "Sun": "Cancer",      "Moon": "Gemini",     "Mars": "Capricorn",   "Mercury": "Virgo",     "Jupiter": "Sagittarius", "Venus": "Sagittarius","Saturn": "Capricorn",  "Rahu": "Cancer",     "Ketu": "Capricorn" },
      { "code": "D16", "name": "Shodasamsa",      "Sun": "Libra",       "Moon": "Aries",      "Mars": "Scorpio",     "Mercury": "Scorpio",   "Jupiter": "Leo",         "Venus": "Capricorn",  "Saturn": "Aries",      "Rahu": "Capricorn",  "Ketu": "Capricorn" },
      { "code": "D20", "name": "Vimsamsa",        "Sun": "Pisces",      "Moon": "Capricorn",  "Mars": "Gemini",      "Mercury": "Capricorn", "Jupiter": "Cancer",      "Venus": "Sagittarius","Saturn": "Aries",      "Rahu": "Pisces",     "Ketu": "Pisces" },
      { "code": "D24", "name": "Siddhamsa",       "Sun": "Scorpio",     "Moon": "Capricorn",  "Mars": "Gemini",      "Mercury": "Cancer",    "Jupiter": "Virgo",       "Venus": "Aquarius",   "Saturn": "Leo",        "Rahu": "Leo",        "Ketu": "Leo" },
      { "code": "D27", "name": "Saptavimshamsa",  "Sun": "Scorpio",     "Moon": "Cancer",     "Mars": "Scorpio",     "Mercury": "Taurus",    "Jupiter": "Capricorn",   "Venus": "Scorpio",    "Saturn": "Leo",        "Rahu": "Libra",      "Ketu": "Aries" },
      { "code": "D30", "name": "Trimsamsa",       "Sun": "Virgo",       "Moon": "Virgo",      "Mars": "Libra",       "Mercury": "Sagittarius","Jupiter": "Sagittarius","Venus": "Capricorn",  "Saturn": "Taurus",     "Rahu": "Pisces",     "Ketu": "Pisces" },
      { "code": "D40", "name": "Khavedamsa",      "Sun": "Taurus",      "Moon": "Leo",        "Mars": "Taurus",      "Mercury": "Scorpio",   "Jupiter": "Aquarius",    "Venus": "Gemini",     "Saturn": "Scorpio",    "Rahu": "Virgo",      "Ketu": "Virgo" },
      { "code": "D45", "name": "Akshavedamsa",    "Sun": "Aries",       "Moon": "Scorpio",    "Mars": "Aquarius",    "Mercury": "Capricorn", "Jupiter": "Capricorn",   "Venus": "Capricorn",  "Saturn": "Gemini",     "Rahu": "Gemini",     "Ketu": "Gemini" },
      { "code": "D60", "name": "Shashtiamsa",     "Sun": "Pisces",      "Moon": "Gemini",     "Mars": "Libra",       "Mercury": "Virgo",     "Jupiter": "Pisces",      "Venus": "Aries",      "Saturn": "Pisces",     "Rahu": "Scorpio",    "Ketu": "Taurus" }
    ],
    "total_charts": 16
  },
  "meta": {
    "endpoint": "/api/v3/vedic/charts/varga-signs",
    "version": "3.0",
    "response_time_ms": 5,
    "timestamp": "2026-06-09T07:35:42+05:30",
    "credits_remaining": 198580,
    "request_id": "47aa526df64b5d62",
    "ayanamsa": {
      "name": "Lahiri",
      "value": 23.725957,
      "value_dms": "23°43'33\""
    },
    "node_type": "mean"
  }
}