FAQ
Frequently asked questions
What is AstrologyService?
AstrologyService is a developer API for Vedic astrology calculations — birth charts, Panchang, planetary positions, dashas, doshas, matching and numerology — returned as structured JSON so you can build them into your own app or website.
How do API keys work?
After you sign up, you mint an API key from your dashboard. The key's secret is shown once, at creation — copy it immediately, since it can't be retrieved again. Send it in the X-API-Key header on every request. You can create multiple keys, scope each to only the endpoints it needs, and revoke any key instantly if it's compromised.
How do I start?
Create a free account, generate an API key from your dashboard, and make a request to an endpoint like /v1/chart with your key in the X-API-Key header. The Documentation page has a full example.
Which astrology calculations are available?
Birth charts (Kundli), divisional charts, planetary positions, Panchang, dasha periods, dosha analysis, Ashtakavarga, Kundli matching, numerology, planetary transits and horoscopes — see the Features page for the full list, or the API reference for exact endpoints.
How is usage measured?
Every API call is counted against your plan's monthly quota. You can see your usage — total calls, status-code breakdown and top endpoints — from the Usage page in your dashboard at any time.
What happens when my quota is exceeded?
Requests beyond your plan's monthly quota or per-second rate limit are rejected by the API. Upgrading your plan raises both limits immediately.
How does billing work?
Subscription plans are billed through Razorpay from your dashboard's Billing page. PDF report credits are a separate, prepaid balance you top up as needed — credits don't expire.
Can I upgrade my plan?
Yes — upgrade or change plans any time from the Billing page in your dashboard. The new quota and rate limit apply as soon as payment is confirmed.
How do I authenticate requests?
Include your API key in the X-API-Key request header. There's no OAuth flow or session cookie involved — it's a single header on every call.
Where is the full API documentation?
The complete, always-current API reference — every endpoint, parameter and response field — is on the Documentation page, generated directly from the live API.
Is there a free plan?
Yes — new accounts start on a free plan with a limited monthly quota, so you can build and test an integration before choosing a paid plan.