← Reports engine/Reports
POST/v1/reports/varshphal-multi-year

Reports · Varshphal Multi Year API

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

Get free API keyTry in playgroundFull schema in docs ↗

About the engine

Part of 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.

Request

Try it from the command line

curl -X POST https://api.astronode.dev/v1/reports/varshphal-multi-year \
  -H 'Authorization: Bearer aie_test_YOUR_KEY_HERE' \
  -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
}'

All AstroNode endpoints require a bearer token from your dashboard. Test keys (`aie_test_*`) are free up to 100 calls/month.

Response

What you get back

Every AstroNode response uses the same envelope:request_id,data (the endpoint-specific payload),interpretation (optional narrative block), andmeta (engine version + computed_at timestamp). The exact data schema for POST /v1/reports/varshphal-multi-year is published in the OpenAPI 3.1 spec under /docs.

Engine highlights

What the Reports engine ships

  • 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

Related endpoints

Other Reports endpoints

POST/v1/reports/compatibility

Async detailed Gun Milan compatibility PDF.

POST/v1/numerology/pythagorean/report

Async Pythagorean numerology PDF.

POST/v1/numerology/chaldean/report

Async Chaldean numerology PDF.

POST/v1/numerology/report

Combined Pythagorean + Chaldean numerology PDF.

POST/v1/compatibility/batch

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

GET/v1/reports/:id

Poll status + fetch the signed download URL when ready.

Ready to call POST /v1/reports/varshphal-multi-year?

Free tier covers 1,000 requests / month. Razorpay-billed, GST-compliant invoices when you upgrade.

Get free API keyTry in playground

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