---
title: "Tarot: Decks and Card Art"
method: GET
path: "/tarot/decks"
tags: ["Tarot: Rider-Waite-Smith"]
---

# Tarot: Decks and Card Art

`GET /tarot/decks`

Every deck with its spreads and the public-domain card art sets you can pick with `art` on any tarot route: id, artist, year, source, a preview image, the card back, and any card a set has no picture for.

## Query parameters

- `fields` string
- `precision` integer

## Response `200`

Successful calculation

- 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

## Other responses

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

## 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

[Change history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/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/da6d49943f9e?raw)