Daily Panchang (Basic)

Endpoint POST https://starsapi.com/api/v3/vedic/panchang/basic

Returns a lightweight daily panchang for any date and location: the five limbs — tithi (with paksha), nakshatra (with pada), yoga, karana, and vaar (weekday with its lord) — plus sunrise, sunset, moonrise, and moonset, all computed at local sunrise as per the traditional method.

For end times, deities, the Hindu calendar (maas, samvatsara, ritu, ayana), muhurta windows, gandanta, panchak, tarabala, and disha shool, use the advanced endpoint.

Authentication

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

Request body

Field	Type	Required	Description
`year`	integer	Yes	Calendar year.
`month`	integer	Yes	Month, 1–12.
`day`	integer	Yes	Day of month.
`latitude`	number	Yes	Decimal degrees.
`longitude`	number	Yes	Decimal degrees.
`timezone`	string	Yes	IANA timezone (e.g. `Asia/Kolkata`).
`ayanamsa`	string	No	Default `lahiri`.

Response shape

Field	Type	Description
`five_limbs`	object	The five panchang limbs: `tithi` (name, paksha), `nakshatra` (name, pada), `yoga`, `karana`, `vaar` (English/Hindi name and planetary lord).
`sun_moon`	object	Local `sunrise`, `sunset`, `moonrise`, `moonset` (HH:MM:SS).
`ayanamsa`	object	Ayanamsa name and value used for sidereal positions.

Errors

HTTP	Code	Cause
400	`MISSING_FIELD`	Required field absent.
400	`INVALID_DATE`	Bad calendar date.
400	`INVALID_TIMEZONE`	Non-IANA timezone.
400	`INVALID_COORDINATE`	Lat/lon out of range.
400	`INVALID_PARAM`	Bad ayanamsa value.
405	`METHOD_NOT_ALLOWED`	Non-POST request.

# Replace YOUR_API_KEY with the key from your dashboard
curl -X POST "https://starsapi.com/api/v3/vedic/panchang/basic" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "year": 2026,
        "month": 6,
        "day": 12,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
    }'

const response = await fetch(
  'https://starsapi.com/api/v3/vedic/panchang/basic',
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      year: 2026,
      month: 6,
      day: 12,
      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/panchang/basic',
    headers={'X-Api-Key': os.environ['STARSAPI_KEY']},
    json={
        'year': 2026,
        'month': 6,
        'day': 12,
        'latitude': 28.6139,
        'longitude': 77.209,
        'timezone': 'Asia/Kolkata'
    }
)
result = response.json()

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

<?php
$payload = [
    'year' => 2026,
    'month' => 6,
    'day' => 12,
    'latitude' => 28.6139,
    'longitude' => 77.209,
    'timezone' => 'Asia/Kolkata',
];

$ch = curl_init('https://starsapi.com/api/v3/vedic/panchang/basic');
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/panchang/basic'),
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: jsonEncode({
      'year': 2026,
      'month': 6,
      'day': 12,
      '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/panchang/basic"
    )!)
    request.httpMethod = "POST"
    request.setValue("YOUR_API_KEY", forHTTPHeaderField: "X-Api-Key")
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    request.httpBody = """
        {
            "year": 2026,
            "month": 6,
            "day": 12,
            "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": 2026,
        "month": 6,
        "day": 12,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
    }
    """.trimIndent()

    val request = Request.Builder()
        .url("https://starsapi.com/api/v3/vedic/panchang/basic")
        .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": 2026,
        "month": 6,
        "day": 12,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata",
    })

    req, _ := http.NewRequest("POST",
        "https://starsapi.com/api/v3/vedic/panchang/basic",
        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/panchang/basic')
payload = {
  'year' => 2026,
  'month' => 6,
  'day' => 12,
  '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": {
    "date": "Jun 12, 2026",
    "timezone": "Asia/Kolkata",
    "location": { "latitude": 28.6139, "longitude": 77.209 },
    "ayanamsa": { "name": "Lahiri", "value_dms": "24\u00b013'42\"" },
    "five_limbs": {
      "tithi": { "name": "Dwadashi", "paksha": "Krishna" },
      "nakshatra": { "name": "Ashwini", "pada": 4 },
      "yoga": { "name": "Atiganda" },
      "karana": { "name": "Kaulava" },
      "vaar": { "name_en": "Friday", "name_hindi": "\u0936\u0941\u0915\u094d\u0930\u0935\u093e\u0930", "lord": "Venus" }
    },
    "sun_moon": {
      "sunrise": "05:22:49",
      "sunset": "19:19:15",
      "moonrise": "02:26:43",
      "moonset": "16:22:47"
    }
  },
  "meta": { "endpoint": "/api/v3/vedic/panchang/basic", "version": "3.0" }
}