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.
POST /v1/reports50,000 credits per monthly allowance · no trial · no automatic overage charges. Plan details ↗
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.
Original zodiac charts from calculated positions
Multi-script PDF shaping across the 12 supported locales
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
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.


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.
{
"source_operation_id": "1299830cdfe3ed0bb78549f7be780e77",
"format": "pdf",
"locale": "en"
}{
"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 ↗
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.
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 ↗
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.
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.
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.