CURATED PDF REPORT API

Western Natal PDF Report

Give your users a readable birth-chart report without building a document renderer. One queued request combines a real chart, planetary and house tables, aspect connections and localized symbolic text.

75 credits per completed PDF · up to 666 from a full monthly allowance · 12 languages.
$39.99/month or $299/year. View plan details

Cover of the generated Western Natal PDF Report

What your users receive.

  • An original chart from exact calculated positions
  • Ten major bodies, sign degrees and retrograde flags
  • Twelve house cusps and house-by-house reflections
  • Five major aspect types with explicit orbs

This sample was generated by the actual local engines and PDF renderer using fictional profile data. It is a permanent documentation example; private API-generated files use expiring download links.

From request to download.

  1. POST /v1/report-catalog/western-natal/jobs
  2. HTTP 202 returns job_id, request_id and the status URL.
  3. Poll GET /v1/jobs/{job_id} every 5–15 seconds.
  4. When status is completed, use result.artifacts[0].url.

Reuse the same idempotency key and body after an uncertain connection. Reading the finished result does not create another paid operation. A failed job releases its reserved credits and report slot.

Make it yours.

Set locale to en, uk, ja, es, fr, de, pt, ar, it, hi, zh or ko. The template, calculations and structure are shared across languages; text direction and font shaping follow the selected locale.

Upload a PNG, JPEG or WebP logo through Report branding or POST /v1/branding/logo. Pass the returned ID as branding.logo_id; optional branding.name and branding.footer add your company text. Your logo fits a white cover frame, with transparency preserved. See logo placement in an example PDF. Files are rendered locally with embedded fonts and original chart graphics.

Each PDF includes “Generated with CeleStack API” in the footer. An account-specific attribution waiver can be granted only by the CeleStack administrator.

Files last 24 hours, signed links 15 minutes and saved JSON seven days. Each report is limited to 32 pages and 12 MiB.

Start with a real request.

curl 'https://api.celestackapi.com/v1/report-catalog/western-natal/jobs' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: your-report-001' \
  --data '{
  "input": {
    "birth": {
      "date": "1990-05-21",
      "time": "14:30:00",
      "timezone": "Europe/Madrid",
      "latitude": 40.4168,
      "longitude": -3.7038
    },
    "house_system": "placidus"
  },
  "locale": "en",
  "subject": "Alex Morgan"
}'

Calculation conventions.

  • Tropical apparent geocentric coordinates, JPL DE440s. Choose whole sign, equal or Placidus.
  • A known birth time is required. The report uses ten major bodies; Chiron, Lilith, nodes and Part of Fortune are outside this template.

Interpretations are original symbolic reflections. The JSON preserves source IDs and calculated facts for your own presentation and review.