---
title: "Generate Tarot Reading (PDF or HTML)"
method: POST
path: "/reports/tarot"
tags: ["Reports"]
---

# Generate Tarot Reading (PDF or HTML)

`POST /reports/tarot`

Render a tarot reading PDF. Default spread `three-card` (Past/Present/Future from Rider-Waite-Smith deck). Available spreads: single-card, three-card, celtic-cross, horseshoe, relationship, year-ahead, decision, chakra, career, love-triangle. Pass `seed` for reproducibility (deterministic mulberry32 RNG); omit to use a daily seed. Set `allowReversed: false` to draw upright cards only.

## Request body

- TarotReport
  - `spread` string
  - `seed` integer, nullable
  - `name` string
  - `allowReversed` boolean
  - `language` 'uk' | 'en' | 'de' | 'ru' | 'pl' | 'es' | 'pt' | 'hi' | 'fr' | 'ko' | 'it' | 'ja' | 'id' | 'tr' | 'nl' | 'ro' | 'cs' | 'vi' | 'ar' | 'el' | 'hu'
  - `whitelabel` union
    - boolean
    - object
      - `companyName` string
      - `companyUrl` string, uri
      - `companyEmail` string, email
      - `companyMobile` string
      - `companyBio` string
      - `logoUrl` string, uri
      - `frontImage` string, uri
      - `textPrimaryColor` string
      - `textSecondaryColor` string
      - `backgroundColor` string
      - `themeColor` string — Accent colour, used for section heading text and inline emphasis.
      - `headingColor` string — Colour of the divider rule under each section heading (not the heading text, which is themeColor).
      - `footerText` string
      - `fontPairing` 'serif-sans' | 'sans-serif' | 'serif-only' | 'sans-only' | 'system'
      - `reportName` string

## Response `200`

Successful calculation

- object
  - `ok` boolean
  - `data` object
    - `url` string, nullable
    - `storage_key` string, nullable
    - `byte_length` number, nullable
    - `page_count` number, nullable
    - `duration_ms` number, nullable
    - `expires_at` string, nullable

## Other responses

- `400` — Validation error
- `401` — Missing or invalid API key

---

[API](https://skmtc.net/astroway/apis/astroway-calculation-api.md) · [All operations](https://skmtc.net/astroway/apis/astroway-calculation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/astroway/astroway-calculation-api/revisions/529d7d36d7d6/schema)