GET/v1/tarot/cards

All Tarot Cards

Returns the complete 78-card Rider-Waite-Smith deck with full metadata. Each card includes id, name, arcana type, suit, element, astrological correspondence, upright and reversed meanings, keywords, yes/no polarity, and visual description. Use this endpoint to populate card databases, build card browsers, or reference individual card data.

Request parameters

No fields documented in the OpenAPI schema.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

array[object]

The endpoint response payload

data[].id

string

Unique slug identifier e.g. 'the-fool'

data[].name

string

Full card name e.g. 'The Fool'

data[].arcana_type

string

'major' or 'minor'

data[].suit

string | null

Suit for minor arcana: wands, cups, swords, pentacles. Null for major arcana.

data[].number

integer

Card number. Major arcana: 0-21. Minor arcana: 1=Ace, 11=Page, 12=Knight, 13=Queen, 14=King.

data[].element

string

Elemental correspondence: fire, water, air, earth, spirit

data[].astrology_correspondence

string

Astrological planet or sign correspondence

data[].keywords_upright

array[string]

Upright keywords

data[].keywords_reversed

array[string]

Reversed keywords

data[].upright_meaning

string

Full upright interpretation

data[].reversed_meaning

string

Full reversed interpretation

data[].yes_no

string

Yes/No polarity: 'yes', 'no', or 'maybe'

data[].description

string

Visual description of the card imagery

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

API key tier does not include this endpoint.

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

• Tarot Cards by Suit
• Major Arcana Cards
• Single Tarot Card

Request

GET·application/json

curl

curl -X GET "https://api.asterwise.com/v1/tarot/cards" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import asterwise
from asterwise.api.tarot_api import TarotApi

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

with asterwise.ApiClient(configuration) as client:
    api = TarotApi(client)
    result = api.tarot_cards()
    print(result)

TypeScript

import { createClient, createConfig, tarotCards } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await tarotCards({
  client,
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": [
    {
      "id": "the-fool",
      "name": "The Fool",
      "arcana_type": "major",
      "suit": null,
      "number": 0,
      "element": "air",
      "astrology_correspondence": "Uranus",
      "keywords_upright": [
        "beginnings",
        "innocence",
        "... and 3 more items"
      ],
      "keywords_reversed": [
        "recklessness",
        "naivety",
        "... and 3 more items"
      ],
      "upright_meaning": "The Fool signals new beginnings, unlimited potential, and a leap of faith. A journey is starting — approach it with open…",
      "reversed_meaning": "Reversed, The Fool warns of recklessness or naivety. A leap may be premature. Important details are being overlooked. Pa…",
      "yes_no": "yes",
      "description": "A young figure stands at a cliff's edge, knapsack over one shoulder, gazing skyward. A white dog leaps at his heels. Mou…"
    },
    {
      "id": "the-magician",
      "name": "The Magician",
      "arcana_type": "major",
      "suit": null,
      "number": 1,
      "element": "air",
      "astrology_correspondence": "Mercury",
      "keywords_upright": [
        "willpower",
        "skill",
        "... and 3 more items"
      ],
      "keywords_reversed": [
        "manipulation",
        "trickery",
        "... and 3 more items"
      ],
      "upright_meaning": "The Magician represents the power to manifest desires through focused will and skill. All the tools are available — use…",
      "reversed_meaning": "Reversed, The Magician warns of manipulation, misdirection, or wasted talent. Skills may be used deceptively, or potenti…",
      "yes_no": "yes",
      "description": "A robed figure stands before a table bearing all four suit symbols. One hand raises a wand toward heaven; the other poin…"
    },
    "... and 76 more items"
  ]
}