Solar Return PDF Report
Build a birthday-season report around a solved solar return. Your users receive natal and return charts, a precise UTC return instant and a structured look at the year’s symbolic themes.
100 credits per completed PDF · up to 500 from a full monthly allowance · 12 languages.
$39.99/month or $299/year. View plan details

What your users receive.
- Exact solar-longitude return in the chosen calendar year
- Natal and solar-return charts and position tables
- Return houses and localized planetary reflections
- Return-to-natal aspects 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.
POST /v1/report-catalog/solar-return/jobs- HTTP 202 returns
job_id,request_idand the status URL. - Poll
GET /v1/jobs/{job_id}every 5–15 seconds. - When status is
completed, useresult.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/solar-return/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
},
"year": 2026,
"house_system": "placidus"
},
"locale": "en",
"subject": "Alex Morgan"
}'Calculation conventions.
- The return chart uses the birth location and selected house system.
- The requested year is a UTC calendar year. This template uses ten major bodies and concentrates on the return chart and natal comparison.
Interpretations are original symbolic reflections. The JSON preserves source IDs and calculated facts for your own presentation and review.