Quickstart

Make your first DivyAstroAPI call in under 5 minutes.

1. Sign up and get a key

Create a free account. You get 500 trial credits — no card required. After signup, visit your dashboard to copy your dv_live_* API key.

dv_live_0123456789abcdef0123456789abcdef

Security: treat dv_live_* keys like passwords. Store in environment variables or a secret manager. Never commit to source control. Never embed in mobile or web bundles.

2. Make your first call

Fetch the current tithi for a time and location, in the language of your choice:

curl "https://api.divyastroapi.com/v1/panchang/tithi?date=2026-04-19&time=06:30&tz=%2B05:30&lat=28.61&lon=77.21" \
-H "Authorization: Bearer dv_live_0123456789abcdef0123456789abcdef"

You should see a response like:

{
"tithi": {
  "index": 2,
  "name": "Dwitiya",
  "paksha": "Shukla"
},
"start_jd": 2461137.478,
"end_jd":   2461138.362,
"percent_complete": 34.6
}

That's one credit consumed. You have 499 remaining.

3. Shared query parameters

Every time-sensitive endpoint accepts either civil time or Julian Day.

Civil time (most common):

Julian Day (power users):

Location (for location-sensitive endpoints):

4. Next steps

• Browse the full API reference
• Read about authentication
• Understand error responses
• See use-case guides