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 — across every tradition.

  • Asynchronous queue (BullMQ in production, in-process in dev)
  • Polling endpoint exposes pending / ready / failed states
  • Optional public share link with PII redaction toggle
  • Per-type viewers in the dashboard (multi-year, KP, LK, numerology, 12 Western)
  • PDF artefacts via pdfkit — invoice-grade typography
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 '{
  "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 compatibility report

Open in console
POST/v1/reports/varshphal-multi-year

1–25 years of varshphal in one report

Open in console
POST/v1/reports/kp

KP-flavored chart report

Open in console
POST/v1/reports/lal-kitab

LK report with rins + remedies

Open in console
POST/v1/reports/numerology

Numerology profile report

Open in console
GET/v1/reports/:id

Poll status / fetch ready report

Open in console
POST/v1/compatibility/batch

CSV batch scoring (matrimony portals)

Open in console

Ready to ship Reports features?

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

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