/v1/reports/:idReports API
Poll status / fetch ready report
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 — across every tradition.
Request
Try it from the command line
curl https://api.astronode.dev/v1/reports/:id \
-H 'Authorization: Bearer aie_test_YOUR_KEY_HERE'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 GET /v1/reports/:id 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
- Per-type viewers in the dashboard (multi-year, KP, LK, numerology, 12 Western)
- PDF artefacts via pdfkit — invoice-grade typography
Related endpoints
Other Reports endpoints
/v1/reports/compatibilityAsync detailed compatibility report
/v1/reports/varshphal-multi-year1–25 years of varshphal in one report
/v1/reports/kpKP-flavored chart report
/v1/reports/lal-kitabLK report with rins + remedies
/v1/reports/numerologyNumerology profile report
/v1/compatibility/batchCSV batch scoring (matrimony portals)
Ready to call GET /v1/reports/:id?
Free tier covers 100 requests / month. Razorpay-billed, GST-compliant invoices when you upgrade.
Informational, not predictive. Not medical, legal, or financial advice.