Skip to main content

Quickstart

Get your first Asterwise API response in under 5 minutes.

1. Get your API key​

Sign up at asterwise.com and copy your API key from the dashboard.

2. Make your first call​

curl -X POST https://api.asterwise.com/v1/astro/panchanga \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-04-09",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": "Asia/Kolkata"
  }'

3. Read the response​

The API returns today's Panchanga — tithi, nakshatra, yoga, karana, and vara — for any location on Earth. A successful call looks like this:

{
  "success": true,
  "message": "success",
  "data": {
    "tithi": {
      "number": 22,
      "name": "Saptami",
      "paksha": "Krishna",
      "degrees_elapsed": 4.9961,
      "degrees_remaining": 7.0039,
      "end_time": "2026-04-09T15:50:09Z"
    },
    "vara": {
      "number": 5,
      "name": "Guruvar",
      "lord": "Jupiter",
      "end_time": null
    },
    "nakshatra": {
      "index": 18,
      "name": "Mula",
      "pada": 4,
      "degrees_elapsed": 11.9466,
      "degrees_remaining": 1.3867,
      "end_time": "2026-04-09T03:18:37Z"
    },
    "yoga": {
      "index": 18,
      "name": "Parigha",
      "is_inauspicious": true,
      "degrees_elapsed": 6.8972,
      "end_time": "2026-04-09T12:28:11Z"
    },
    "karana": {
      "number": 43,
      "name": "Vishti",
      "degrees_elapsed": 4.9961,
      "degrees_remaining": 1.0039,
      "end_time": "2026-04-09T02:43:07Z"
    }
  }
}

Confirm success is true and data includes tithi, vara, nakshatra, yoga, and karana. Replace YOUR_API_KEY if you see authentication_failed.