REPORTS · JSON REST API

Astrology PDF & PNG Report API

Turn a completed calculation into a downloadable document or image. A report job uses a saved result owned by your organization, preserving the original numerical JSON while rendering a bounded, localized presentation.

AvailablePOST /v1/reports

50,000 credits per monthly allowance · no trial · no automatic overage charges. Plan details ↗

BUILD AROUND THE DATA

What this API provides.

Create private PDF reports or PNG chart images from a saved CeleStack result. Download real sample artifacts before subscribing and inspect the workflow.

01

Asynchronous PDF or PNG generation

02

Original zodiac charts from calculated positions

03

Multi-script PDF shaping across the 12 supported locales

04

Private production artifacts with expiring signed links

Send

  • source_operation_id of a completed result belonging to your organization
  • format: pdf or png, and the same locale as the source result
  • Poll the returned job URL or receive your configured customer webhook

Receive

  • A queued job reference from POST /v1/reports
  • A completed result containing artifact metadata
  • A private signed download URL, MIME type and SHA-256 in production
REAL RENDERED ARTIFACTS

Open the actual output.

These files were rendered locally from the published synthetic natal result. No account, private customer data or paid provider call was used.

First page of the real CeleStack PDF natal report, generated from the public synthetic chart
Actual PDF, first-page preview. Download full PDF ↗
Original 1600 by 1600 PNG zodiac chart rendered from the same numerical sample
Actual 1600 × 1600 chart image. Download PNG ↗
INSPECT BEFORE SUBSCRIBING

Real input. Real output.

The response panel shows actual local renderer artifact metadata, not a fabricated HTTP job completion. The request illustrates how to submit your own completed result.

Request JSON POST /v1/reports
{
  "source_operation_id": "1299830cdfe3ed0bb78549f7be780e77",
  "format": "pdf",
  "locale": "en"
}
Actual local renderer metadata
{
  "example_type": "local_renderer_artifact_metadata_not_an_HTTP_job_response",
  "source_response": "/fixtures/apis/natal-chart-api/response.json",
  "artifacts": [
    {
      "mime_type": "application/pdf",
      "sha256": "e0310da754d6d6460f4173f51dedf7797d099c76f086e2f16113db28efd3e6e7",
      "pages": 6,
      "preview": false,
      "coverage": {
        "selection": "evenly-spaced-whole-topics-v1",
        "total_topic_count": 26,
        "available_rule_topic_count": 26,
        "selected_topic_count": 24,
        "omitted_count": 2,
        "selected_fact_ids": [
          "astrology/natal.planets.sun",
          "astrology/natal.planets.moon",
          "astrology/natal.planets.mercury",
          "astrology/natal.planets.venus",
          "astrology/natal.planets.mars",
          "astrology/natal.planets.jupiter",
          "astrology/natal.planets.uranus",
          "astrology/natal.planets.neptune",
          "astrology/natal.planets.pluto",
          "astrology/natal.aspects.1",
          "astrology/natal.aspects.2",
          "astrology/natal.aspects.3",
          "astrology/natal.aspects.4",
          "astrology/natal.aspects.5",
          "astrology/natal.aspects.6",
          "astrology/natal.aspects.7",
          "astrology/natal.aspects.8",
          "astrology/natal.aspects.9",
          "astrology/natal.aspects.11",
          "astrology/natal.aspects.12",
          "astrology/natal.aspects.13",
          "astrology/natal.aspects.14",
          "astrology/natal.aspects.15",
          "astrology/natal.aspects.16"
        ],
        "source_data_bytes": 3880,
        "source_data_summarized": false,
        "full_json_preserved": true,
        "page_limit": 20
      },
      "renderer": "weasyprint-66.0-pango",
      "sample_url": "/fixtures/apis/report-generation-api/natal-report.pdf"
    },
    {
      "mime_type": "image/png",
      "sha256": "b255ad6198b32877beb6df58e449c6b04ac92dd3298b4e32e6912b25f5b7e1c8",
      "pages": 1,
      "preview": false,
      "coverage": {
        "selection": "chart-only-v1",
        "full_json_preserved": true
      },
      "renderer": "original-svg-cairosvg-2.8.2",
      "sample_url": "/fixtures/apis/report-generation-api/natal-report.png"
    }
  ],
  "note": "The source operation ID is synthetic. Use a completed operation owned by your organization in a real request. Production queue and signed artifact URLs are not represented by these public sample links."
}

The source_operation_id in the example is synthetic. Replace it with a completed result owned by your organization. Public sample artifact URLs are permanent documentation files; production links are private and expire.

cURL request — use your own API key and a new idempotency key
curl --request POST 'https://api.celestackapi.com/v1/reports' \
+  --header 'Authorization: Bearer YOUR_API_KEY' \
+  --header 'Content-Type: application/json' \
+  --header 'Idempotency-Key: report-generation-api-example-001' \
+  --data '{
  "source_operation_id": "1299830cdfe3ed0bb78549f7be780e77",
  "format": "pdf",
  "locale": "en"
}'

Example computed 2026-11-17. Full fixture manifest, engine versions and SHA-256 checksums ↗

YOUR PRODUCT, YOUR EXPERIENCE

Ways to use it.

  • Downloadable customer readings
  • Chart images for your own application
  • Localized documents without implementing a PDF renderer

12 response locales

English, Ukrainian, Japanese, Spanish, French, German, Portuguese, Arabic, Italian, Hindi, Chinese and Korean.

Calculation values remain language-independent. Localized rule text is agent-authored; independent native-language review remains pending. Machine-readable field names stay stable.

KNOW THE CONVENTIONS

Limits and interpretation.

  • The sample PDF and PNG below are real local renderer outputs, not a live customer job. Their public sample links are not production signed URLs.
  • Reports are bounded summaries of long readings, with explicit coverage. Full numerical JSON is preserved; the PDF has a 20-page limit.
  • The source must still exist, belong to your organization and use the requested locale. Production artifacts expire after 24 hours.

Interpretive content is for symbolic reflection and entertainment. It is not a verified personal prediction or professional advice. Read the API conventions ↗

PREDICTABLE ACCESS

Choose your billing.

Both options include 50,000 credits per monthly allowance, resetting monthly. No trial and no automatic overage. Custom needs use a contact form.

5,000credits per UTC day
60requests per minute
5,000new operation attempts per UTC day
32 MiBmaximum stored JSON result

Saved results: 7-day retention, up to 128 MiB per organization on this initial shared deployment, with a 512 MiB shared retained-result limit. Capacity can return a temporary error; there are no automatic extra charges. Production artifacts have separate retention. All usage and resource limits ↗. Checkout availability is shown in your account.

DEVELOPER QUESTIONS

Frequently asked questions.

Can I see an actual PDF before paying?

Yes. The page includes a PDF preview and direct downloads of a real locally generated PDF and 1600×1600 PNG, both derived from the published synthetic natal fixture.

Is the report returned immediately?

No. POST /v1/reports returns a job reference. Poll the job URL or use a customer webhook, then follow the private artifact link in the completed result.

Can every numerical result fit into a PDF?

Long results are presented as bounded summaries with coverage notes. The original numerical JSON is unchanged. For non-chart PNGs, the renderer produces a clearly marked first-page preview.

What does access cost?

Access is USD 39.99 per month or USD 199 billed annually, with no trial. Both billing options provide 50,000 credits per monthly allowance. 25 credits per successful request or job. Daily credit, attempt, rate and resource limits apply. There are no automatic overage charges.

CONNECT THE BUILDING BLOCKS

Related APIs.

View every API