---
title: "RWS: Suit"
method: GET
path: "/tarot/rider-waite/suits/{suit}"
tags: ["Tarot: Rider-Waite-Smith"]
---

# RWS: Suit

`GET /tarot/rider-waite/suits/{suit}`

## Request

- Base URL: `https://api.astroway.info/v1`
- URL: `https://api.astroway.info/v1/tarot/rider-waite/suits/{suit}`
- Auth: API key in header `X-Api-Key`

All 14 cards of a suit (wands, cups, swords, or pentacles).

## Path parameters

- `suit` 'wands' | 'cups' | 'swords' | 'pentacles', required

## Query parameters

- `fields` string
- `precision` integer

## Response `200`

Successful calculation

- object
  - `ok` boolean
  - `data` object
    - `suit` string, nullable
    - `items` object[], nullable
      - `slug` string, nullable
      - `number` number, nullable
      - `name` string, nullable
      - `category` string, nullable
      - `suit` string, nullable
      - `rank` string, nullable
      - `element` string, nullable
      - `upright` object, nullable
        - `keywords` string[], nullable
        - `meaning` string, nullable
      - `reversed` object, nullable
        - `keywords` string[], nullable
        - `meaning` string, nullable
      - `astrology` string, nullable
      - `numerology` number, nullable
      - `yes` string, nullable
    - `count` number, nullable

## Other responses

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

## Changes

- **2026-09-21** `b64222844186`: 2 info
  - added the new optional `query` request parameter `fields`
  - added the new optional `query` request parameter `precision`
- **2026-08-23** `6828e5609564`: 3 info
  - added the optional property `data/count` to the response with the `200` status
  - added the optional property `data/items` to the response with the `200` status
  - added the optional property `data/suit` to the response with the `200` status
- **2026-08-14** `994755209cea`: 2 info
  - api tag `Tarot: Rider-Waite-Smith` added
  - api tag `Tarot — Rider-Waite-Smith` removed

[Operation history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/tarot/rider-waite/suits/:suit/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)