← Reports engine/Reports
POST/v1/numerology/chaldean/report

Numerology · Chaldean · Report API

Async Chaldean numerology 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/numerology/chaldean/report' \
  -H 'Authorization: Bearer aie_test_REPLACE_WITH_YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "name": "Sachin Tendulkar",
  "dob": "1993-07-04"
}'

Paste and run - this is the exact payload our live playground sends to this endpoint, so it is valid against the current schema. Every AstroNode endpoint needs a bearer token from your dashboard. Test keys (aie_test_*) work on the free tier - 1,000 requests / month, no card.

Request schema

Fields POST /v1/numerology/chaldean/report accepts

Request body fields for POST /v1/numerology/chaldean/report
FieldTypeNotes
namestring

len 1..200

dobrequiredstring

pattern ^\d{4}-\d{2}-\d{2}$

target_datestring

pattern ^\d{4}-\d{2}-\d{2}$

Generated from the same OpenAPI 3.1 document the API validates against, so this table cannot drift from the endpoint without the build failing.

Response

What you get back

Every AstroNode response uses the same envelope: request_id, data (the endpoint-specific payload), interpretation (optional narrative block), and meta (engine version + computed_at timestamp). This endpoint documents 200, 400, 401, 429.

The data payload for POST /v1/numerology/chaldean/report is not yet broken out field by field in the published schema. The fastest way to see its exact shape is to run the call - the playground returns a live response with no signup, and the API reference carries the full document.

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/reports/varshphal-multi-year

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

POST/v1/numerology/pythagorean/report

Async Pythagorean 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/numerology/chaldean/report?

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.