One API call. A complete branded report.
Send birth details. Get a production-ready PDF back — Kundli, match-making, Varshphal, life forecast. White-labeled, multi-language, 3-second generation. Hand it directly to your users.
Report types
12+
Pages per report
40+
White-labeled
100%
Generation time
~3 sec
LIVE PREVIEW
What your users
actually receive.
Fully white-labeled reports. Your brand, your logo, your domain. The user never sees "AstrologyAPI".
Detailed Kundli Report
Prepared for: Rahul Sharma · DOB: 15 Aug 1990
Sun Sign
Leo
Moon Sign
Scorpio
Ascendant
Libra
Birth Chart (D1)
Navamsa (D9)
Sun
Leo · House 11
Moon
Leo · House 11
Mars
Leo · House 11
Interactive preview. Generate a real PDF to see the full 40-page report.
generate_report.py
1import requests 2 3response = requests.post( 4 "https://pdf.astrologyapi.com/v1/kundli_report", 5 headers={"Authorization": "Basic {key}"}, 6 json={ 7 "day": 15, "month": 8, "year": 1990, 8 "hour": 10, "min": 30, "lat": 28.61, 9 "lon": 77.20, "tzone": 5.5, 10 "lang": "en", "report_style": "detailed" 11 } 12) 13 14with open("kundli.pdf", "wb") as f: 15 f.write(response.content)
White-Label Branding
Configure your company details, logo, and footer text in the dashboard. Our API handles the heavy rendering while you focus on the user experience.
Catalogue
Choose your tradition,
ship curated report suites.
Each collection is crafted with astrologers and designers to convert raw data into narratives that feel counselled, not auto-generated.
Vedic Focus
Vedic Astrology PDFs
Embed premium Kundli, Varshphal, matchmaking or gemstone PDFs in your app to convert leads, power memberships and delight paying users.
Western Focus
Western Astrology PDFs
Offer natal, forecast and compatibility reports that look studio-produced, perfect for monetised drops or loyalty campaigns.
AI PDFs
Turn palm insights into reports worth sharing.
Bring hand analysis, life readings, and partner compatibility together in clear, beautifully presented PDF reports.
Your data
How we handle PDF report data
A generated report can contain personal information. Plan for its storage, delivery and deletion.
3 monthsGenerated PDF retention
Privacy & your rights What you send
The birth or profile details and report options needed to generate the requested PDF. The resulting report may contain personal information and interpretations.
Storage & early deletion
Generated PDF reports are kept for three months. You can request earlier deletion at [email protected] with your account email and the report identifier or link.
Downloads & model use
Deleting a hosted report does not remove copies already downloaded by you or your users. AstrologyAPI never trains models on user data.
Share report links only with intended recipients. The three-month rule applies to generated PDFs; JSON APIs retain only API identity and success/failure status, not submitted user details.
Infrastructure & service providers
We use AWS and Google Cloud infrastructure in India and US regions, Cloudflare for DNS and website hosting, and R2 and S3 storage. These are overall infrastructure details, not exclusive residency commitments for every product, provider or backup. Service-specific arrangements belong in your agreement.
Explore service providersWhat the Astrology PDF Report API builds
Many astrology businesses sell reports, not just charts. Our PDF Report API builds those reports for you. You send birth details and your branding in one POST request. We build a finished PDF and return a link to it.
We cover both Vedic and Western astrology. On the Vedic side, you get kundli reports at four levels of detail. You also get match making, Varshaphal, gemstone and numerology reports. On the Western side, you get natal, solar return, synastry and life forecast reports.
Each report carries your logo, company name and contact details, not ours. So you can sell it as your own white-label report. The pdf_url comes back in the same response. You can show a download button, attach the file to an email or save it in your own storage.
You do not need to write code to try it. Our dashboard has a PDF generator that builds the same reports from a form.
Kundli reports
Mini, basic, professional and premium kundli PDFs. The premium report is 150 pages, with charts, dasha, yogas and life-area readings.
Match making
A report for two people. You turn the Ashtakoot, Dashakoot and Papasamyam sections on or off in the request.
Yearly forecasts
Vedic Varshaphal for the year you choose, plus Western solar return and life forecast reports.
Western birth charts
Natal reports with planetary aspects, and synastry reports that compare two natal charts.
Numerology and gemstones
A 98-page pro numerology report from a full name and birth date, and a gemstone report with remedies.
Your branding
Your logo, company name, email, phone numbers, website and footer link on every report.
Key PDF endpoints
Every report is a POST request with birth details and branding fields in a JSON body. Here are four endpoints most teams start with, with real sample output from our docs.
Base URL: https://pdf.astrologyapi.com/v1
POST
/basic_horoscope_pdfBasic kundli PDF
Takes name, gender, birth date and time, place, lat, lon and tzone. Set chart_style to NORTH_INDIAN, SOUTH_INDIAN or EAST_INDIAN. It comes in eight languages.
1{ 2 "status": true, 3 "pdf_url": "https://s3.amazonaws.com/astrologyapi-pdfs/sample_horoscope.pdf" 4}
POST
/premium_kundli_reportPremium kundli PDF
Our most detailed Vedic report. It covers charts, planets, dasha, yogas, career, marriage, money and health. Note that it uses latitude, longitude and timezone as field names.
1{ 2 "status": 200, 3 "success": true, 4 "message": "PDF created successfully", 5 "response": { 6 "pdf_url": "https://pdfapilambda.s3.ap-south-1.amazonaws.com/d7889b94-7a1c-4893-8f16-398be310954e.pdf" 7 } 8}
POST
/match_making_pdfMatch making PDF
Takes two sets of birth details. Fields that start with m_ are for the male and f_ for the female. You can include or skip the Ashtakoot, Dashakoot and Papasamyam sections.
1{ 2 "status": true, 3 "pdf_url": "https://s3.amazonaws.com/astrologyapi-pdfs/match_making_sample.pdf" 4}
POST
/natal_horoscope_report/tropicalWestern natal PDF
A tropical birth chart report for Western astrology users. It comes in English, Portuguese, German, French, Spanish, Italian and Russian.
1{ 2 "status": true, 3 "pdf_url": "https://s3.amazonaws.com/astrologyapi-pdfs/western_natal_horoscope_sample.pdf" 4}
Who uses the PDF Report API
More than 3,000+ businesses build on AstrologyAPI. These are common ways to use our PDF reports.
Astrology apps and astrologers
Sell a branded kundli as a paid add-on. Or send one before a consultation, so the client comes prepared.
Kundli PDF API →Matrimony platforms
Give families a printable match making report with Mangal analysis and matching scores.
Kundli matching for matrimony platforms →Western horoscope sites
Offer natal, solar return and synastry reports to readers in seven languages.
Western PDF Reports API →Numerology apps
Sell a full numerology profile from a name and birth date. It comes in English and Hindi.
Pro numerology report docs →Palm reading apps
Turn a stored palm reading into a full report. We send the PDF link to your webhook when it is ready.
Palm Reading API →Report stores
Sell reports on your own store under your own brand. You set the price, and we build the file.
How to monetize an astrology app →Docs, guides and reading
Start with the reference. Then follow the guide to send your first PDF request.
Astrology PDF Report API FAQ
What is an astrology PDF report API?
An astrology PDF report API turns birth details into a finished report file. You send one POST request with the birth data and your company details. We build the PDF and send back a pdf_url. Your user can download it, or you can email it to them.
Which reports can I generate?
We build Vedic and Western reports. The Vedic reports are the mini, basic, professional and premium kundli, match making, Varshaphal, gemstone and pro numerology. The Western reports are natal, solar return, synastry, life forecast and star sign compatibility. We also build palm and couple compatibility reports from a palm reading.
Can I white-label the PDF with my own brand?
Yes. Every request carries your branding fields: logo_url, company_name, company_info, domain_url, footer_link, company_email, company_landline and company_mobile. These fields are required. We print them on the report, so it reads as your product and not ours. Keep company_info under 500 characters.
Which languages do the PDF reports support?
It depends on the report. The mini and basic kundli come in English, Hindi, Bengali, Marathi, Tamil, Telugu, Kannada and Malayalam. The professional and premium kundli, match making, gemstone and pro numerology reports come in English and Hindi. Natal, solar return and synastry come in English, Portuguese, German, French, Spanish, Italian and Russian. Varshaphal, life forecast and star sign compatibility are in English.
Do I get the PDF in the same response?
For the kundli, matching, numerology and Western reports, yes. The pdf_url comes back in the same response, with no polling and no webhook. The palm and couple compatibility reports work in a different way. They return a request_id first. When the report is ready, we POST the pdf_url to your webhook_url.
How do I start, and what does it cost?
Create a free account to get your user ID, API key and 150 free credits. No credit card is needed. Each PDF report has its own credit cost, shown on our pricing page. Call the API from your server with HTTP Basic auth, so your key never reaches the browser.
From birth details to branded PDF. In one API call.
Sandbox access in minutes. Preview every report template, test generation, and ship your first PDF flow today — no credit card required.