---
title: "Tarot decks and card art (public, no key)"
method: GET
path: "/public/tarot/decks"
tags: ["Public"]
---

# Tarot decks and card art (public, no key)

`GET /public/tarot/decks`

## Request

- Base URL: `https://api.astroway.info/v1`
- URL: `https://api.astroway.info/v1/public/tarot/decks`
- Auth: none required

Every deck with its spreads and the public-domain card art sets: id, artist, year, licence, source, a preview image, the card back, and any card a set has no picture for. The same answer as GET /tarot/decks. Cached for a day.

## Query parameters

- `fields` string
- `precision` integer

## Response `200`

OK

- object
  - `ok` boolean
  - `data` object
    - `items` object[], nullable
      - `deck` string, nullable
      - `name` string, nullable
      - `cards` number, nullable
      - `spreads` object[], nullable
        - `slug` string, nullable
        - `name` string, nullable
        - `cardCount` number, nullable
      - `art` object[], nullable
        - `id` string, nullable
        - `name` string, nullable
        - `artist` string, nullable
        - `year` string, nullable
        - `licence` string, nullable
        - `source` string, nullable
        - `note` string, nullable
        - `preview` object, nullable
          - `url` string, nullable
          - `url2x` string, nullable
          - `urlSmall` string, nullable
          - `width` number, nullable
          - `height` number, nullable
          - `art` string, nullable
        - `back` object, nullable
          - `url` string, nullable
          - `url2x` string, nullable
          - `urlSmall` string, nullable
          - `width` number, nullable
          - `height` number, nullable
          - `art` string, nullable
        - `missing` unknown[], nullable
          - unknown
  - `_footer` string: Free-tier watermark, present on every public response. Keys on a paid plan do not receive it.

## Other responses

- `400`: Invalid sign or date

## Changes

- **2026-10-07** `da6d49943f9e`: 2 info
  - added the optional property `data/items/items/art/items/back/urlSmall` to the response with the `200` status
  - added the optional property `data/items/items/art/items/preview/urlSmall` to the response with the `200` status
- **2026-10-06** `8a54b26dfec8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/public/tarot/decks/get.md)

---

[API](https://skmtc.dev/astroway/apis/astroway-calculation-api.md) · [All operations](https://skmtc.dev/astroway/apis/astroway-calculation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/astroway/apis/astroway-calculation-api/revisions/593d763ba9a5?raw)