Astrology API: frequently asked questions
Short answers, each with a link to the page that has the detail. Not here? Write to us at developers@astrologics.in.
Getting started
What is the AstroLogics API?
A REST API for Vedic astrology, built for India: kundli, dasha, doshas, kundli matching, panchang and muhurat, horoscopes, transits, numerology, chart images and PDF reports, plus Western, Chinese, Feng Shui and Vastu. It has 133 operations. You send JSON over HTTPS with one key and get JSON back, in English or Hindi.
Is there a free astrology API plan?
Yes. The Free plan gives 3,000 credits a month, and every operation is included. Test keys are never charged. No card is needed to sign up. See pricing.
How do I get an astrology API key?
Sign up with your email or Google account. Your dashboard then gives you a test key (al_test_) and a live key (al_live_). The quickstart makes your first call in a few minutes.
What is the difference between a test key and a live key?
Both run the same engine and return the same results. A test key is never charged, and each project gets 100 test calls a day. A live key spends your plan's credits. See authentication.
Which languages and frameworks can I use?
Any language that can make an HTTPS request. There are official clients for TypeScript and JavaScript, Python and PHP (SDKs), tutorials for Next.js and Flutter, and guides for WordPress, Shopify and n8n. The reference shows every call in several languages.
Credits and billing
How are credits counted?
Each operation costs a fixed number of credits, shown in the reference and on pricing. A birth chart, POST /v1/kundli (2 credits), costs 2. Only successful (2xx) calls are charged; errors are free.
What happens when the free credits run out?
On the Free plan, calls stop with 429 quota_exhausted until the next UTC month. Paid plans continue as overage, up to a cap you control.
How do I pay, and in which currency?
Paid plans are priced in INR, plus GST. You pay on Razorpay's page by UPI, card or net banking, and a GST tax invoice follows every payment. For billing in USD, write to us at developers@astrologics.in.
Can I make several chart calls in one request?
Yes. POST /v1/kundli/bundle (3 credits) runs several chart operations in one call: it takes one rate-limit slot and is charged their sum less one credit.
Calculation
How accurate is the API?
We compare the engine's planetary longitudes with NASA JPL Horizons across 1900–2025, and publish the figures and the test set on accuracy. Every engine change must also reproduce 291 golden charts exactly before it ships.
Which ayanamsa and house system does it use?
Lahiri ayanamsa and whole-sign houses by default, with the true node. You can choose Raman, Krishnamurti, Yukteshwar or Fagan-Bradley ayanamsa on chart operations. KP uses its own ayanamsa. All of it is listed on conventions.
Do I need to work out the timezone of the birth place?
No. Send coordinates, a place from GET /v1/places/search (1 credit), or a free-text place, and the API works out the timezone that was in force at that date, including India's historical offsets. See birth input.
What if the birth time is not known?
Do not invent one. Set time_accuracy to unknown: the fields that depend on the lagna and the houses are left out and listed in warnings, never filled with a noon default. See birth input.
Is astrology a science?
No. Astrology is a tradition. The API computes planetary positions accurately and applies each tradition's rules as stated, and it labels a choice between traditions as a convention. Read the disclaimer before you show results to users.
Languages and output
Does the API return Hindi?
Yes. Add lang=hi and labels and readings come back in Hindi, in Devanagari. Machine ids stay the same in both languages, so your code does not change. See languages.
Can I get kundli chart images?
Yes, as SVG or PNG, North or South Indian style, for any divisional chart from D1 to D60. See chart images.
Can I generate PDF kundli reports under my own brand?
Yes. Reports are client-ready PDFs with your own name, logo and colour, in English or Hindi. They are built for one response and not stored.
Apps, websites and AI
Can I call the API from a browser or a mobile app?
Not with a secret key: anyone could copy it. Call the API from your server, or use a publishable key (al_pub_) for the read-only widgets and operations without birth data. See mobile apps and widgets.
Is there a horoscope or panchang widget for my website?
Yes. The widgets put a panchang, a horoscope, a kundli, matching or a Vastu check on any page with one script tag.
Can I use the API in an AI chatbot or assistant?
Yes. Every public operation is also a tool on our MCP server, for Claude Code, Cursor and other MCP clients, and the docs are searchable over MCP too. See MCP servers and notes for coding agents.
Can I send daily horoscopes on WhatsApp?
Yes, through a WhatsApp Business provider. The WhatsApp guide covers AiSensy, Gupshup, Interakt, LeadNXT and WATI, and the n8n guide has a workflow you can import.
Data and reliability
Do you store the birth details I send?
We do not store request bodies. The web server's access log keeps request addresses, including query strings, for up to 8 days, so send birth details in a POST body. See caching and data retention and the privacy policy.
Can I cache the results?
Yes. A result for the same input and engine_version does not change. What to cache and for how long is on caching and data retention.
Does the API have webhooks?
No. Every call returns its result at once, so there is nothing to wait for.
What are the rate limits?
Each plan has a number of requests a second and at once, per key, shown on pricing. Over the limit you get 429 rate_limited with a Retry-After header. See rate limits.
How do I know when a calculation changes?
Every response carries meta.engine_version. A change to any result is announced in the changelog with the new version. See versioning. Live status is on the status page.