API_DOCUMENTATION.md
Official VedicOrbit Panchangam API reference
VedicOrbit Panchangam API
Version: 1.2.0
The VedicOrbit Panchangam API provides Panchangam calculations for a selected date, geographic location, timezone, language, and API mode.
It supports:
Daily Panchangam summary
Complete Panchangam calculations
Personal Tarabalam and Chandrabalam
Muhurtham and timing information
Vedic calendar information
English, Telugu, Hindi, Tamil, and Kannada responses
API-key authentication
Monthly usage tracking and plan-based limits
Base URL
https://vedicorbit-website.vercel.app/api/panchangam
The internal website route /api/site-panchangam is not a customer-facing endpoint and must not be used by external clients.
Authentication
Every API request must include a valid API key in the x-api-key request header.
x-api-key: vo_live_your_api_key
Use API keys only from:
Backend servers
Serverless functions
Secure API clients
Private development tools
Do not expose an API key in:
Browser-side JavaScript
Public mobile-app code
Public repositories
Screenshots, logs, or support messages
Missing API Key
{ "success": false, "error": "API key is required." }
Invalid API Key
{ "success": false, "error": "Invalid API key." }
Request Parameters
Parameter
Required
Description
mode
NO
API response mode: summary, full, personal, timings, or calendar
date
NO
Date in YYYY-MM-DD format
lat
NO
Latitude, for example 17.385
lon
NO
Longitude, for example 78.4867
timezone
NO
IANA timezone, for example Asia/Kolkata
lang
No
Response language: en, te, hi, ta, or kn
birthNakshatra
Personal mode only
Integer from 1 to 27
birthRasi
Personal mode only
Integer from 1 to 12
Example Location
Latitude: 17.385 Longitude: 78.4867 Timezone: Asia/Kolkata Location: Hyderabad, Telangana, India
Supported Languages
Code
Language
en
English
te
Telugu
hi
Hindi
ta
Tamil
kn
Kannada
Standard Response Envelope
{ "success": true, "source": "VedicOrbit Panchangam API", "version": "1.2.0", "mode": "summary", "language": "te", "input": {}, "location": {}, "data": {} }
The exact contents of data.astronomical depend on the selected mode.
API Modes
- •Summary Mode
Summary mode returns the most commonly used daily Panchangam information.
Request URL
cURL
curl "https://vedicorbit-website.vercel.app/api/panchangam?mode=summary&date=2026-03-03&lat=17.385&lon=78.4867&timezone=Asia/Kolkata&lang=te"
-H "x-api-key: vo_live_your_api_key"
PowerShell
Invoke-RestMethod -Uri "https://vedicorbit-website.vercel.app/api/panchangam?mode=summary&date=2026-03-03&lat=17.385&lon=78.4867&timezone=Asia/Kolkata&lang=te"
-Headers @{ "x-api-key" = "vo_live_your_api_key" }
Summary Response Includes
Sunrise
Sunset
Moonrise
Moonset
Solar noon
Tithi and Paksha
Vara
Nakshatra and Pada
Yoga
Karana
Chandra Rasi
Rahu Kalam
Yamagandam
Gulika Kalam
Transition times
Localized names
Example Response
{ "success": true, "source": "VedicOrbit Panchangam API", "version": "1.2.0", "mode": "summary", "language": "te", "input": { "date": "2026-08-06", "latitude": 17.385, "longitude": 78.4867, "elevation": 0, "timezone": "Asia/Kolkata" }, "location": { "name": "Hyderabad", "state": "Telangana", "country": "India" }, "data": { "status": "summary-ready", "astronomical": { "sunrise": { "local": "05:56 am" }, "sunset": { "local": "06:47 pm" }, "tithi": { "number": 23, "name": "Ashtami", "paksha": "Krishna Paksha", "completionPercent": 41.39 }, "vara": { "number": 5, "name": "Guruvara", "teluguName": "గురువారం" }, "nakshatra": { "number": 2, "name": "Bharani", "teluguName": "భరణి", "pada": 2 }, "yoga": { "number": 10, "name": "Ganda", "teluguName": "గండ" }, "karana": { "number": 45, "name": "Balava", "teluguName": "బాలవ" }, "rasi": { "number": 1, "name": "Mesha", "teluguName": "మేషం" }, "rahuKalam": { "startLocal": "01:58 pm", "endLocal": "03:34 pm" }, "yamagandam": { "startLocal": "05:56 am", "endLocal": "07:33 am" }, "gulikaKalam": { "startLocal": "09:09 am", "endLocal": "10:45 am" } } } }
- •Full Mode
Full mode returns the complete Panchangam calculation response.
Request URL
cURL
curl "https://vedicorbit-website.vercel.app/api/panchangam?mode=full&date=2026-03-03&lat=17.385&lon=78.4867&timezone=Asia/Kolkata&lang=te"
-H "x-api-key: vo_live_your_api_key"
Full Response Includes
Sunrise, sunset, moonrise, moonset, and solar noon
Tithi, Paksha, transition, and completion percentage
Special Tithi indicators
Vara
Nakshatra, Pada, and transition
Yoga and Karana
Chandra Rasi and Chandra Rasi transition
Surya Rasi and Sankranti
Amanta Masa and Purnimanta Masa
Samvatsara
Ayana and Ritu
Anandadi Yoga
Siddhi Yogas
Rahu Kalam, Yamagandam, and Gulika Kalam
Durmuhurtham
Abhijit Muhurtham
Brahma Muhurta
Auspicious timings
Amrit Kalam
Hora
Choghadiya
Gowri Panchangam
Tarabalam
Chandrabalam
Festivals and observances
Lahiri Ayanamsa
Tropical and sidereal longitude values
Localized names and results
Example Response
{ "success": true, "source": "VedicOrbit Panchangam API", "version": "1.2.0", "mode": "full", "language": "te", "data": { "status": "astronomical-engine-connected", "astronomical": { "sunrise": { "local": "05:56 am" }, "sunset": { "local": "06:47 pm" }, "tithi": { "name": "Ashtami", "paksha": "Krishna Paksha" }, "nakshatra": { "name": "Bharani", "pada": 2 }, "rasi": { "name": "Mesha" }, "yoga": { "name": "Ganda" }, "karana": { "name": "Balava" }, "masa": { "name": "Ashadha" }, "samvatsara": { "name": "Raudra" }, "ayana": { "name": "Dakshinayana" }, "ritu": { "name": "Varsha" }, "suryaRasi": { "name": "Karkataka" }, "sankranti": { "sankrantiName": "Simha Sankranti" }, "abhijitMuhurtham": { "startLocal": "11:56 am", "endLocal": "12:47 pm" }, "tarabalam": { "favorableBirthNakshatras": [] }, "chandrabalam": { "favorableBirthRasis": [] }, "festivals": [] } } }
The actual Full response contains many more fields than this shortened example.
- •Personal Mode
Personal mode returns Tarabalam and Chandrabalam for a selected birth Nakshatra and birth Rasi.
Request URL
Required Personal Parameters
Parameter
Required
Valid Values
birthNakshatra
Yes
Integer from 1 to 27
birthRasi
Yes
Integer from 1 to 12
cURL
curl "https://vedicorbit-website.vercel.app/api/panchangam?mode=personal&date=2026-03-03&lat=17.385&lon=78.4867&timezone=Asia/Kolkata&lang=te&birthNakshatra=10&birthRasi=5"
-H "x-api-key: vo_live_your_api_key"
Personal Response Includes
Selected birth Nakshatra
Selected birth Rasi
Current Vara
Current Tithi
Current Nakshatra
Current Chandra Rasi
Matching Tarabalam result
Matching Chandrabalam result
Favorable status
Highly favorable status
Localized result text
Example Response
{ "success": true, "source": "VedicOrbit Panchangam API", "version": "1.2.0", "mode": "personal", "language": "te", "input": { "date": "2026-08-06", "latitude": 17.385, "longitude": 78.4867, "elevation": 0, "timezone": "Asia/Kolkata", "birthNakshatra": 1, "birthRasi": 1 }, "data": { "status": "personal-ready", "astronomical": { "tithi": { "number": 23, "name": "Ashtami", "paksha": "Krishna Paksha" }, "nakshatra": { "number": 2, "name": "Bharani", "teluguName": "భరణి", "pada": 2 }, "rasi": { "number": 1, "name": "Mesha", "teluguName": "మేషం" }, "tarabalam": { "birthNakshatraNumber": 1, "birthNakshatraName": "Ashwini", "currentNakshatraNumber": 2, "currentNakshatraName": "Bharani", "taraNumber": 2, "taraName": "Sampata", "result": "Very Good", "teluguResult": "చాలా శుభప్రదం", "effect": "very-good", "isFavorable": true, "isHighlyFavorable": true }, "chandrabalam": { "birthRasiNumber": 1, "birthRasiName": "Mesha", "currentMoonRasiNumber": 1, "currentMoonRasiName": "Mesha", "houseFromBirthRasi": 1, "result": "Favorable", "teluguResult": "శుభప్రదం", "isFavorable": true, "isHighlyFavorable": false } } } }
- •Timings Mode
Timings mode returns auspicious, inauspicious, and daily time-division information.
Request URL
cURL
curl "https://vedicorbit-website.vercel.app/api/panchangam?mode=timings&date=2026-03-03&lat=17.385&lon=78.4867&timezone=Asia/Kolkata&lang=te"
-H "x-api-key: vo_live_your_api_key"
Timings Response Includes
Sunrise and sunset
Rahu Kalam
Yamagandam
Gulika Kalam
Durmuhurtham
Abhijit Muhurtham
Brahma Muhurta
Auspicious timings
Pratah Sandhya
Vijaya Muhurta
Godhuli Muhurta
Sayahna Sandhya
Nishita Muhurta
Amrit Kalam
Day and night Hora
Day and night Choghadiya
Day and night Gowri Panchangam
Example Response
{ "success": true, "source": "VedicOrbit Panchangam API", "version": "1.2.0", "mode": "timings", "language": "te", "data": { "status": "timings-ready", "astronomical": { "sunrise": { "local": "05:56 am" }, "sunset": { "local": "06:47 pm" }, "rahuKalam": { "startLocal": "01:58 pm", "endLocal": "03:34 pm" }, "yamagandam": { "startLocal": "05:56 am", "endLocal": "07:33 am" }, "gulikaKalam": { "startLocal": "09:09 am", "endLocal": "10:45 am" }, "durmuhurtham": { "windows": [ { "startLocal": "10:13 am", "endLocal": "11:04 am" }, { "startLocal": "03:21 pm", "endLocal": "04:12 pm" } ] }, "abhijitMuhurtham": { "startLocal": "11:56 am", "endLocal": "12:47 pm" }, "brahmaMuhurta": { "startLocal": "04:20 am", "endLocal": "05:08 am" }, "hora": { "weekdayLord": "Jupiter" }, "choghadiya": { "currentChoghadiya": { "name": "Shubh" } }, "gowriPanchangam": { "currentPeriod": { "name": "Dhanam" } } } } }
- •Calendar Mode
Calendar mode returns Vedic calendar and festival information for a selected date.
Request URL
cURL
curl "https://vedicorbit-website.vercel.app/api/panchangam?mode=calendar&date=2026-03-03&lat=17.385&lon=78.4867&timezone=Asia/Kolkata&lang=te"
-H "x-api-key: vo_live_your_api_key"
Calendar Response Includes
Date
Vara
Tithi
Special Tithi indicators
Amanta Masa
Purnimanta Masa
Samvatsara
Ayana
Ritu
Surya Rasi
Sankranti and transition
Festivals and observances
Example Response
{ "success": true, "source": "VedicOrbit Panchangam API", "version": "1.2.0", "mode": "calendar", "language": "te", "data": { "status": "calendar-ready", "astronomical": { "date": "2026-08-06", "vara": { "number": 5, "name": "Guruvara", "teluguName": "గురువారం" }, "tithi": { "number": 23, "name": "Ashtami", "paksha": "Krishna Paksha" }, "specialTithi": { "isAshtami": true, "labels": ["Ashtami"], "teluguLabels": ["అష్టమి"] }, "masa": { "system": "Amanta", "number": 3, "name": "Ashadha", "teluguName": "ఆషాఢం", "isAdhika": false }, "purnimantaMasa": { "system": "Purnimanta", "number": 4, "name": "Shravana", "teluguName": "శ్రావణం", "paksha": "Krishna Paksha" }, "samvatsara": { "number": 54, "name": "Raudra", "teluguName": "రౌద్ర", "verifiedYear": true }, "ayana": { "name": "Dakshinayana", "teluguName": "దక్షిణాయనం" }, "ritu": { "name": "Varsha", "teluguName": "వర్ష ఋతువు" }, "suryaRasi": { "name": "Karkataka", "teluguName": "కర్కాటకం" }, "sankranti": { "sankrantiName": "Simha Sankranti", "teluguSankrantiName": "సింహం సంక్రాంతి", "transition": { "endLocal": "17 Aug, 07:55 am" } }, "festivals": [] } } }
SDK Examples
JavaScript
const response = await fetch( "https://vedicorbit-website.vercel.app/api/panchangam?mode=summary&date=2026-03-03&lat=17.385&lon=78.4867&timezone=Asia/Kolkata&lang=te", { method: "GET", headers: { "x-api-key": "vo_live_your_api_key", }, }, );
const data = await response.json();
console.log(data);
Python
import requests
url = "https://vedicorbit-website.vercel.app/api/panchangam"
params = { "mode": "summary", "date": "2026-03-03", "lat": "17.385", "lon": "78.4867", "timezone": "Asia/Kolkata", "lang": "te", }
headers = { "x-api-key": "vo_live_your_api_key", }
response = requests.get(url, params=params, headers=headers) data = response.json()
print(data)
PHP
<?php $url = "https://vedicorbit-website.vercel.app/api/panchangam?mode=summary&date=2026-03-03&lat=17.385&lon=78.4867&timezone=Asia/Kolkata&lang=te"; $ch = curl_init($url); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "x-api-key: vo_live_your_api_key", ], ]); $response = curl_exec($ch); curl_close($ch); $data = json_decode($response, true); print_r($data); HTTP Status Codes HTTP Status Meaning 200 Request completed successfully 400 Invalid or missing request parameters 401 API key is missing or invalid 403 API key is inactive or access is not allowed 404 Endpoint or resource not found 429 Monthly API request limit exceeded 500 Internal server error Error Responses Missing API Key { "success": false, "error": "API key is required." } Invalid API Key { "success": false, "error": "Invalid API key." } Monthly Limit Exceeded { "success": false, "error": "Monthly API request limit exceeded.", "usage": 200000, "limit": 200000 } Generic Invalid Request { "success": false, "error": "Invalid request parameters." } Internal Server Error { "success": false, "error": "Internal server error." } Rate Limits and Pricing Plan Monthly Requests Price Free 500 ₹0 Starter 10,000 ₹499/month Developer 50,000 ₹999/month Business 200,000 ₹2,499/month Enterprise Custom Custom pricing When the monthly request quota is reached, the API returns HTTP 429. Plan Limit HTTP 429 Starts At Free 500 501st request Starter 10,000 10,001st request Developer 50,000 50,001st request Business 200,000 200,001st request Best Practices Always call the API from a secure backend. Never expose API keys in frontend code. Store API keys in server-side environment variables. Validate dates, coordinates, and timezones before forwarding requests. Use an IANA timezone such as Asia/Kolkata. Handle non-200 responses explicitly. Do not continuously retry 401, 403, or 429 responses. Cache responses when the same date and location are requested repeatedly. Monitor current usage to avoid monthly-limit errors. Security Notes API keys are secrets. Do not store API keys in GitHub. Do not use NEXT_PUBLIC_ environment variables for private API keys. Do not send Supabase service or secret keys to customers. Do not use SUPABASE_SECRET_KEY as a customer API key. Rotate or deactivate a key if it is exposed. Use HTTPS for all production requests. Versioning Current API version: 1.2.0 The response includes a version field. Future breaking changes should use a new documented version and migration instructions. Changelog Version 1.2.0 Released Panchangam API modes Added secure API-key authentication Added monthly usage tracking Added plan-based request limits Added English, Telugu, Hindi, Tamil, and Kannada responses Added Summary mode Added Full mode Added Personal mode Added Timings mode Added Calendar mode Added secure website proxy integration Added production deployment on Vercel Added interactive API documentation and playground Support For API access, pricing, enterprise plans, technical support, and partnership enquiries: support@vedicorbit.in Documentation portal: https://vedicorbit-website.vercel.app/api-docs Website: https://vedicorbit-website.vercel.app Terms of Use By using the API, customers agree to: Keep API credentials confidential Use the API only within the purchased plan limits Avoid abusive, illegal, or excessive automated usage Avoid reselling raw API access without written permission Follow applicable laws and platform policies Commercial contracts, enterprise terms, refunds, uptime commitments, and redistribution rights should be handled through a separate written agreement. Disclaimer Panchangam data is provided for informational, cultural, spiritual, and application-development purposes. Developers are responsible for: Testing the API for their intended use case Presenting timezone and location information correctly Handling missing or unavailable astronomical events Displaying appropriate disclaimers in end-user products Avoiding unsupported medical, legal, or financial claims based on Panchangam data License and Attribution API access is governed by the customer’s active plan and the VedicOrbit terms of use. The API, calculations, response structure, documentation, and related branding remain the property of VedicOrbit unless a separate written agreement states otherwise. Do not copy, redistribute, sublicense, or resell the API service or documentation without written permission.