Tarot Card Meanings API

Retrieve the complete Rider-Waite-Smith tarot deck of 78 cards: 22 Major Arcana (numbered 0-21, representing life lessons, spiritual themes, and karmic influences like The Fool, Death, The Tower) plus 56 Minor Arcana (4 suits × 14 cards each for daily situations and practical matters). Filter by arcana type (major for spiritual guidance, minor for everyday concerns), suit (cups for emotions and relationships, wands for creativity and passion, swords for intellect and conflict, pentacles for material wealth and finances), or card number (Ace=1 for new beginnings, 2-10 for progression, Page=11 for messages, Knight=12 for action, Queen=13 for mastery, King=14 for authority). Returns lightweight basic card data - use GET /cards/:id for full upright and reversed interpretations with keywords. Perfect for building tarot reference libraries, card databases, learning applications, or browsing the complete traditional deck used by professional tarot readers worldwide.

Request

GET /api/v2/tarot/cards

Response

Structured JSON with documented fields, verified against NASA JPL Horizons across 828 gold-standard tests. Not hallucinated text.

{
  "total": 0,
  "limit": 0,
  "offset": 0,
  "cards": [
    {
      "id": "fool",
      "name": "The Fool",
      "arcana": "major",
      "number": 0,
      "imageUrl": "https://roxyapi.com/img/tarot/major/fool.jpg"
    }
  ]
}

Supported options

Call it in your language in seconds.

Every snippet is generated from the live OpenAPI spec, so method names, parameters, and fields always match production.

import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.tarot.listCards()

from roxy_sdk import create_roxy

roxy = create_roxy("YOUR_API_KEY")
result = roxy.tarot.list_cards()

use function RoxyAPI\Sdk\createRoxy;

$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->tarot->listCards();

using RoxyApi;

var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.Tarot.Cards.GetAsync();

import roxyapi "github.com/RoxyAPI/sdk-go"

roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.Tarot.ListCards(ctx, nil)

curl "https://roxyapi.com/api/v2/tarot/cards" \
  -H "X-API-Key: YOUR_KEY"

More Tarot Card Meanings endpoints

The Tarot Card Meanings API bundles these related endpoints under one key.

Remote MCP for AI agents

Every Tarot endpoint is a callable tool on the Remote MCP server over Streamable HTTP. No local setup, no Docker. Claude, ChatGPT, Cursor, and any MCP client auto-discover the tools and ground their answers in verified data.

claude mcp add --transport http \
  roxy-tarot https://roxyapi.com/mcp/tarot \
  --header "X-API-Key: YOUR_KEY"

Tool name for GET /tarot/cards: get_tarot_cards. Full MCP setup guide

What you can build

Drop-in UI components

Render Tarot Card Meanings API responses without building charts yourself. These open source, framework-agnostic web components take the typed response and draw it, in React, Vue, Svelte, Angular, plain HTML, and WordPress.

Related capabilities

Tarot Card Meanings API FAQ