Reports

The Reports engine.

When a single API call's response is a 50KB JSON, the next thing your customer wants is a PDF. The reports surface enqueues async generation, polls to ready, and serves a stable shareable URL plus a downloadable PDF. Today's catalog covers compatibility, multi-year varshphal (1–25 years per call), and both numerology systems individually + combined.

  • Asynchronous queue (BullMQ in production, in-process in dev)
  • Polling endpoint exposes pending / ready / failed states
  • Optional public share link with PII redaction toggle
  • PDF artefacts via pdfkit — invoice-grade typography
  • Cap: 25 years per multi-year varshphal request, 500 pairs per compatibility batch
Get free API keyTry in playground
Sample request/v1/reports/varshphal-multi-year
bash
curl -X POST https://api.astronode.dev/v1/reports/varshphal-multi-year \
  -H "Authorization: Bearer aie_test_…" \
  -H "Content-Type: application/json" \
  -d '{
  "birth": {
    "date": "1973-04-24",
    "time": "17:25:00",
    "tz_offset_minutes": 330,
    "lat": 19.076,
    "lng": 72.8777
  },
  "start_age": 53,
  "count": 5
}'

Endpoints in this engine

7 endpoints, one consistent JSON shape

POST/v1/reports/compatibility

Async detailed Gun Milan compatibility PDF.

Endpoint details
Open in console ↗
POST/v1/reports/varshphal-multi-year

1–25 years of varshphal (year-chart + muntha + mudda + Tajika yogas + balas + month-chart) in one PDF.

Endpoint details
Open in console ↗
POST/v1/numerology/pythagorean/report

Async Pythagorean numerology PDF.

Endpoint details
Open in console ↗
POST/v1/numerology/chaldean/report

Async Chaldean numerology PDF.

Endpoint details
Open in console ↗
POST/v1/numerology/report

Combined Pythagorean + Chaldean numerology PDF.

Endpoint details
Open in console ↗
POST/v1/compatibility/batch

Batch scoring up to 500 pairs — async, results sorted by score desc.

Endpoint details
Open in console ↗
GET/v1/reports/:id

Poll status + fetch the signed download URL when ready.

Endpoint details
Open in console ↗

Other engines

VedicBirth charts, varga, dasha, varshphal, panchang, balas, doshas.NadiNadiamsa (D150) — meaning (Dhruva) + timing (Chandra Kala).KPCuspal sub-lord theory + horary 1–249.Lal KitabFixed-house kundli, 7 rins, and remedies.NumerologyPythagorean and Chaldean reductions, ank milan, personal cycles.WesternTropical natal, transits, synastry, solar return, sun-sign forecasts.TarotRider-Waite-Smith spreads, yes/no, biorhythm.RemediesGemstones, rudraksha, pujas — tradition-sourced, pending astrologer pass.CompatibilityCross-tradition match: Ashtakoot, Dashakoot, Porutham, synastry, ank milan.AI AstrologerBounded conversational reasoning, grounded in the chart.

Ready to ship Reports features?

Free tier covers 100 calls/day. Upgrade when you need production headroom — Razorpay-billed, GST-compliant invoices.

Get free API keyRead the docs

Informational, not predictive. Not medical, legal, or financial advice.