Generate Report — Unified Dispatcher (V2)
POST
/reports/generate
curl -X POST https://api.astroway.info/v1/reports/generate \ -H "X-Api-Key: aw_live_..." \ -H "Content-Type: application/json" \ -d '{ "report_type": "natal", "chart": { "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 }, "language": "uk", "whitelabel": { "companyName": "Acme", "themeColor": "#ff5500", "reportName": "My Cosmic Map" } }'const res = await fetch('https://api.astroway.info/v1/reports/generate', { method: 'POST', headers: { 'X-Api-Key': process.env.ASTROWAY_API_KEY, 'Content-Type': 'application/json', }, body: JSON.stringify({ "report_type": "natal", "chart": { "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 }, "language": "uk", "whitelabel": { "companyName": "Acme", "themeColor": "#ff5500", "reportName": "My Cosmic Map" } }),});const { ok, data, error } = await res.json();if (!ok) throw new Error(error.message);console.log(data);import os, requests
r = requests.post( 'https://api.astroway.info/v1/reports/generate', headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'}, json={ 'report_type': "natal", 'chart': { 'date': "1990-05-15", 'time': "14:30:00", 'timezoneOffset': 3, 'latitude': 50.45, 'longitude': 30.52 }, 'language': "uk", 'whitelabel': { 'companyName': "Acme", 'themeColor': "#ff5500", 'reportName': "My Cosmic Map" } },)result = r.json()if not result['ok']: raise RuntimeError(result['error']['message'])print(result['data'])<?phpuse GuzzleHttp\Client;
$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);$r = $client->post('reports/generate', [ 'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')], 'json' => [ 'report_type' => 'natal', 'chart' => [ 'date' => '1990-05-15', 'time' => '14:30:00', 'timezoneOffset' => 3, 'latitude' => 50.45, 'longitude' => 30.52, ], 'language' => 'uk', 'whitelabel' => [ 'companyName' => 'Acme', 'themeColor' => '#ff5500', 'reportName' => 'My Cosmic Map', ], ],]);$result = json_decode($r->getBody(), true);if (!$result['ok']) throw new \RuntimeException($result['error']['message']);print_r($result['data']);Single endpoint over the 12 type-specific renderers — pass report_type (“natal” | “transit-yearly” | “synastry” | “business” | “career” | “love” | “money” | “child” | “lal-kitab” | “human-design” | “tarot” | “vedic-kundli”) plus the renderer-specific inputs. SDK ergonomics: one method instead of 12. Required fields vary by type — chart for most, chart1+chart2 for synastry, seed for tarot (chart optional).
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ” Media type application/json
object
report_type required
string
chart
Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss). Defaults to lat/lon/tz=0 if omitted; pass real values for accurate computation.
object
date required
string
time required
string
timezoneOffset
number
latitude
number
longitude
number
houseSystem
string
name
string
city
string
zodiacType
string
ayanamsaId
number
cosmogram
boolean
key additional
chart1
Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss). Defaults to lat/lon/tz=0 if omitted; pass real values for accurate computation.
object
date required
string
time required
string
timezoneOffset
number
latitude
number
longitude
number
houseSystem
string
name
string
city
string
zodiacType
string
ayanamsaId
number
cosmogram
boolean
key additional
chart2
Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss). Defaults to lat/lon/tz=0 if omitted; pass real values for accurate computation.
object
date required
string
time required
string
timezoneOffset
number
latitude
number
longitude
number
houseSystem
string
name
string
city
string
zodiacType
string
ayanamsaId
number
cosmogram
boolean
key additional
year
integer
spread
string
seed
integer
name
string
allowReversed
boolean
language
string
whitelabel
Any of:
boolean
object
companyName
string
companyUrl
string format: uri
companyEmail
string format: email
companyMobile
string
companyBio
string
logoUrl
string format: uri
frontImage
string format: uri
textPrimaryColor
string
textSecondaryColor
string
backgroundColor
string
themeColor
string
headingColor
string
footerText
string
fontPairing
string
reportName
string
Example
{ "report_type": "natal", "chart": { "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 }, "language": "uk", "whitelabel": { "companyName": "Acme", "themeColor": "#ff5500", "reportName": "My Cosmic Map" }}Responses
Section titled “ Responses ”Successful calculation
Media type application/json
object
ok
boolean
data
object
url
string
storage_key
string
byte_length
number
page_count
number
duration_ms
number
expires_at
string
Example
{ "ok": true, "data": { "url": "https://api.astroway.info/reports/abc.pdf", "storage_key": "reports/abc.pdf", "byte_length": 145000, "page_count": 1, "duration_ms": 4100, "expires_at": "2026-05-16T07:00:00Z" }}Validation error
Media type application/json
Example
{ "ok": false, "error": { "code": "INVALID_INPUT", "message": "Validation failed: date: Date must be YYYY-MM-DD", "details": [ { "path": "date", "message": "Date must be YYYY-MM-DD" } ] }}Missing or invalid API key
Media type application/json
Example
{ "ok": false, "error": { "code": "INVALID_API_KEY", "message": "Invalid API key" }} Корисно?
Дякуємо за фідбек.