> ## Documentation Index > Fetch the complete documentation index at: https://docs.astrom8.com/llms.txt > Use this file to discover all available pages before exploring further. # BaZi and Saju PDF report ## OpenAPI ````yaml /openapi.public.json post /api/v3/reports/bazi/pdf openapi: 3.1.0 info: title: AstroM8 Public API version: 1.1.0 description: >- Astrology calculations, reports, customer delivery, and enterprise workflows. Each operation declares whether it uses an API key or a customer session bearer token. servers: - url: https://api.astrom8.com description: Production security: [] tags: - name: Western description: Natal, relationship, return, progression, and transit calculations. - name: Vedic description: Lahiri sidereal Vedic calculations, matching, timing, and remedies. - name: Thai Astrology description: Thai calendar, auspicious timing, lunar, festival, and wheel tools. - name: Chinese & Korean description: BaZi, Qi Men Dun Jia, and Saju calculations. - name: Horoscopes description: Published daily and range horoscope content. - name: Reports description: Branded report generation and asynchronous job polling. - name: Tarot & Numerology description: Tarot spreads and Pythagorean numerology. - name: Uranian description: Uranian charts, midpoints, and planetary pictures. - name: Developer workflow description: Preflight capability eligibility and credit estimates. - name: Customer reports description: Session-authenticated report jobs and reusable brand profiles. - name: Customer delivery description: Session-authenticated webhooks and scheduled horoscope delivery. - name: Cultural Intelligence description: >- Enterprise API-key workflows for encrypted profiles, teams, and campaign content. paths: /api/v3/reports/bazi/pdf: post: tags: - Reports summary: BaZi and Saju PDF report requestBody: required: true content: application/json: schema: type: object required: - birth_subject properties: birth_subject: $ref: '#/components/schemas/BirthSubjectInput' system: type: string enum: - bazi - saju default: bazi gender: type: string enum: - male - female - unknown default: unknown name: type: string maxLength: 120 locale: type: string enum: - th - en default: th branding: $ref: '#/components/schemas/PdfBranding' async: type: boolean default: false description: >- When true, returns 202 with a job_id immediately instead of holding the connection; poll GET /api/v3/jobs/{id} for the result. Credits are charged at enqueue and refunded automatically if the job fails. responses: '200': description: PDF generated and uploaded; signed URL valid for 24 hours. content: application/json: schema: $ref: '#/components/schemas/PdfReportResponse' '202': description: Job accepted (async=true). Poll the job endpoint for the result. content: application/json: schema: type: object properties: job_id: type: string examples: - job_a1b2c3d4e5f60718293a4b5c status: type: string enum: - queued poll: type: string examples: - /api/v3/jobs/job_a1b2c3d4e5f60718293a4b5c required: - job_id - status - poll '400': description: Invalid input (e.g. out-of-range birth data). content: application/json: schema: $ref: '#/components/schemas/JsonError' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '403': description: Tier locked — endpoint requires pro tier. content: application/json: schema: $ref: '#/components/schemas/JsonError' '503': description: >- PDF pipeline or LLM provider temporarily unavailable (Chromium launch failure, R2 misconfigured, or interpretation provider down). content: application/json: schema: $ref: '#/components/schemas/JsonError' security: - ApiKeyAuth: [] components: schemas: BirthSubjectInput: type: object required: - date - time - latitude - longitude - timezoneOffsetMinutes properties: ayanamsa: type: string enum: - lahiri default: lahiri date: type: string format: date examples: - '1992-04-15' time: type: string pattern: ^\d{2}:\d{2}(:\d{2})?$ examples: - '08:30:00' latitude: type: number minimum: -90 maximum: 90 longitude: type: number minimum: -180 maximum: 180 timezoneOffsetMinutes: type: integer minimum: -840 maximum: 840 PdfBranding: allOf: - $ref: '#/components/schemas/WhiteLabelBrandFields' - type: object description: >- Visual white-label branding rendered into the PDF (logo, color) in addition to the LLM voice controls. properties: logo_url: type: string format: uri maxLength: 500 description: Must be an https URL. primary_color: type: string pattern: ^#[0-9a-fA-F]{6}$ examples: - '#7c3aed' contact_email: type: string format: email maxLength: 200 description: Shown in the report footer, e.g. "hello@moonpath.app". contact_phone: type: string maxLength: 40 description: >- Shown in the report footer. Free-form — international phone formats vary. examples: - +66 2 123 4567 contact_url: type: string format: uri maxLength: 300 description: >- Must be an https URL. Shown in the footer in place of the default astrom8.com link. examples: - https://moonpath.app PdfReportResponse: type: object required: - pdf_url - expires_at properties: pdf_url: type: string format: uri expires_at: type: string format: date-time JsonError: type: object required: - error - message properties: error: type: string description: >- Stable slug (e.g. unauthorized, payment_required, internal_server_error). message: type: string description: Human-readable message safe for clients. code: type: string description: Optional provider-specific code. request_id: type: string description: Correlation id when middleware sets it. WhiteLabelBrandFields: type: object description: >- Optional white-label AI voice controls for endpoints that generate LLM interpretation text. properties: brand_name: type: string minLength: 1 maxLength: 60 examples: - Moon & Co tone: type: string enum: - professional - casual - mystical - playful - formal audience: type: string enum: - consumer - employee - manager - customer - community safety_mode: type: string enum: - default - workplace - financial_wellness - entertainment responses: Unauthorized: description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/JsonError' example: error: unauthorized message: Invalid API key code: '401' request_id: 01HQXYZ... PaymentRequired: description: >- Insufficient credits (checked before work where applicable; deduction is atomic) content: application/json: schema: $ref: '#/components/schemas/JsonError' example: error: payment_required message: Insufficient credits for this request code: '402' request_id: 01HQXYZ... securitySchemes: ApiKeyAuth: type: http scheme: bearer description: Use the raw API key as the Bearer token, or send X-API-Key instead. ````