Skip to content
RoxyAPI
Get API Key

Retrieve the complete Rider-Waite-Smith tarot deck of 78 cards. The 22 Major Arcana (numbered 0-21) carry life lessons, spiritual themes, and karmic influences like The Fool, Death, The Tower; the 56 Minor Arcana (4 suits × 14 cards each) cover 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

Parameters

ParameterTypeDescription
lang
query, optional
string enumResponse language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default en.
limit
query, optional
integerMaximum items to return per page. Range: 1-100, default 20. Default 20.
offset
query, optional
integerNumber of items to skip for pagination. Default 0. Default 0.
arcana
query, optional
string enumFilter by arcana type. Major arcana (0-21) represents life lessons and spiritual themes. Minor arcana (Ace-King in 4 suits) represents daily situations and practical matters.
suit
query, optional
string enumFilter minor arcana by suit. Cups=emotions/relationships, Wands=creativity/passion, Swords=intellect/conflict, Pentacles=material/finances. Only applies to minor arcana cards.
number
query, optional
integerFilter by card number. Major Arcana: 0 (The Fool) through 21 (The World). Minor Arcana: 1 (Ace) through 14 (King). Combine with arcana or suit filters for precise results.

Response

Structured JSON with documented fields, covered by 15,481 automated tests per deploy, 3,683 of them gold-standard tests verified against NASA JPL Horizons. Not hallucinated text.

200 OK
{
  "total": 78,
  "limit": 20,
  "offset": 0,
  "cards": [
    {
      "id": "fool",
      "name": "The Fool",
      "arcana": "major",
      "number": 0,
      "imageUrl": "https://roxyapi.com/img/tarot/major/fool.jpg"
    },
    {
      "id": "magician",
      "name": "The Magician",
      "arcana": "major",
      "number": 1,
      "imageUrl": "https://roxyapi.com/img/tarot/major/magician.jpg"
    },
    {
      "id": "high-priestess",
      "name": "The High Priestess",
      "arcana": "major",
      "number": 2,
      "imageUrl": "https://roxyapi.com/img/tarot/major/high-priestess.jpg"
    },
    {
      "id": "empress",
      "name": "The Empress",
      "arcana": "major",
      "number": 3,
      "imageUrl": "https://roxyapi.com/img/tarot/major/empress.jpg"
    },
    {
      "id": "emperor",
      "name": "The Emperor",
      "arcana": "major",
      "number": 4,
      "imageUrl": "https://roxyapi.com/img/tarot/major/emperor.jpg"
    },
    {
      "id": "hierophant",
      "name": "The Hierophant",
      "arcana": "major",
      "number": 5,
      "imageUrl": "https://roxyapi.com/img/tarot/major/hierophant.jpg"
    },
    {
      "id": "lovers",
      "name": "The Lovers",
      "arcana": "major",
      "number": 6,
      "imageUrl": "https://roxyapi.com/img/tarot/major/lovers.jpg"
    },
    {
      "id": "chariot",
      "name": "The Chariot",
      "arcana": "major",
      "number": 7,
      "imageUrl": "https://roxyapi.com/img/tarot/major/chariot.jpg"
    },
    {
      "id": "strength",
      "name": "Strength",
      "arcana": "major",
      "number": 8,
      "imageUrl": "https://roxyapi.com/img/tarot/major/strength.jpg"
    },
    {
      "id": "hermit",
      "name": "The Hermit",
      "arcana": "major",
      "number": 9,
      "imageUrl": "https://roxyapi.com/img/tarot/major/hermit.jpg"
    },
    {
      "id": "wheel-of-fortune",
      "name": "Wheel of Fortune",
      "arcana": "major",
      "number": 10,
      "imageUrl": "https://roxyapi.com/img/tarot/major/wheel-of-fortune.jpg"
    },
    {
      "id": "justice",
      "name": "Justice",
      "arcana": "major",
      "number": 11,
      "imageUrl": "https://roxyapi.com/img/tarot/major/justice.jpg"
    },
    {
      "id": "hanged-man",
      "name": "The Hanged Man",
      "arcana": "major",
      "number": 12,
      "imageUrl": "https://roxyapi.com/img/tarot/major/hanged-man.jpg"
    },
    {
      "id": "death",
      "name": "Death",
      "arcana": "major",
      "number": 13,
      "imageUrl": "https://roxyapi.com/img/tarot/major/death.jpg"
    },
    {
      "id": "temperance",
      "name": "Temperance",
      "arcana": "major",
      "number": 14,
      "imageUrl": "https://roxyapi.com/img/tarot/major/temperance.jpg"
    },
    {
      "id": "devil",
      "name": "The Devil",
      "arcana": "major",
      "number": 15,
      "imageUrl": "https://roxyapi.com/img/tarot/major/devil.jpg"
    },
    {
      "id": "tower",
      "name": "The Tower",
      "arcana": "major",
      "number": 16,
      "imageUrl": "https://roxyapi.com/img/tarot/major/tower.jpg"
    },
    {
      "id": "star",
      "name": "The Star",
      "arcana": "major",
      "number": 17,
      "imageUrl": "https://roxyapi.com/img/tarot/major/star.jpg"
    },
    {
      "id": "moon",
      "name": "The Moon",
      "arcana": "major",
      "number": 18,
      "imageUrl": "https://roxyapi.com/img/tarot/major/moon.jpg"
    },
    {
      "id": "sun",
      "name": "The Sun",
      "arcana": "major",
      "number": 19,
      "imageUrl": "https://roxyapi.com/img/tarot/major/sun.jpg"
    }
  ]
}

Response fields

FieldTypeDescription
total
required
numberTotal number of tarot cards matching the applied filters. 78 for the full deck, 22 for Major Arcana, 56 for Minor Arcana, 14 per suit.
limit
required
numberMaximum items returned per page.
offset
required
numberNumber of items skipped from the start of the result set.
cards
required
array of objectArray of tarot cards with basic metadata. Use GET /cards/{id} for full upright and reversed interpretations.
cards[].id
required
stringUnique card identifier in kebab-case, with no leading article on Major Arcana (e.g. fool, star, ace-of-cups, queen-of-swords). This is the canonical form, whatever spelling was requested.
cards[].name
required
stringDisplay name of the tarot card as it appears in the Rider-Waite-Smith tradition.
cards[].arcana
required
string enumWhether this card belongs to the Major Arcana (22 trump cards representing major life themes) or Minor Arcana (56 suit cards for daily situations).
cards[].suit
optional
string enumSuit of the card (Minor Arcana only). Cups=emotions, Wands=creativity, Swords=intellect, Pentacles=material. Null for Major Arcana cards.
cards[].number
required
numberCard number within its arcana. Major Arcana: 0 (Fool) through 21 (World). Minor Arcana: 1 (Ace) through 14 (King).
cards[].imageUrl
required
stringURL to the tarot card artwork image in the Rider-Waite-Smith style.

Supported options

lang

entrdeeshiptfrruzh-Hanszh-Hant

arcana

majorminor

suit

cupswandsswordspentacles

Call it in your language.

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

TypeScript
import { createRoxy } from '@roxyapi/sdk'

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

Install: npm install @roxyapi/sdk

Prefer to try before you write code? Run this Tarot endpoint live in the API playground and inspect a real production response.

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 Code / Cursor
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

  • Build tarot reading apps with authentic Rider-Waite-Smith interpretations: upright and reversed meanings for all 78 cards with domain-specific guidance for love, career, health, and spiritual growth
  • Add daily tarot features to wellness and self-discovery platforms: one consistent personalized card per user each day, with shareable results
  • Build AI tarot chatbots with MCP: your OpenAI, Claude, or Gemini agent auto-discovers tarot endpoints and delivers conversational readings with zero integration code
  • Power career and life coaching platforms with Celtic Cross (10-card), SWOT career spreads, and yes/no oracle readings for decision-making and guidance features
  • Create relationship and dating app features with love spreads analyzing emotional dynamics, compatibility, challenges, and partnership potential
  • Ship fortune-telling and divination platforms combining tarot with astrology, numerology, dreams, and I-Ching for comprehensive spiritual guidance under one API key

No-code widgets and drop-in UI components.

This is what your visitors see. Paste one snippet into Wix, Squarespace, or WordPress and the Tarot Card Meanings API reading appears on your site, with no code and no backend. Developers install the same components from npm for Next.js, React, Vue, Svelte, Angular, or plain HTML. MIT licensed and included in every plan.

MIT licensedFramework agnosticThemeable via CSS variablesnpm or CDN
Show all Tarot Card Meanings UI componentsShow fewer Tarot Card Meanings UI components
ElementRenders
<roxy-tarot-card>Single card with upright and reversed flip
<roxy-tarot-catalog>Deck gallery tiles with card art, name, and arcana and suit; a pick opens the card in place

Component preview

The real component, running on sample data.

Loading the component...

Related capabilities

Tarot Card Meanings API FAQ

What does the Tarot Card Meanings API return?

Retrieve the complete Rider-Waite-Smith tarot deck of 78 cards. Every response is structured JSON with documented fields, not free text, so you map it straight into your product.

How do I authenticate with the Tarot Card Meanings API?

Pass your key in the X-API-Key header on every request. Keys are delivered instantly at checkout with no approval queue. Use a secret sk key server side, or mint a publishable pk key locked to your origins for browser and no-code use.

Does the Tarot Card Meanings API support multiple languages?

Yes. Append the lang query parameter to any endpoint for responses in English, German, Spanish, French, Hindi, Portuguese, Russian and Turkish. The translated payload includes the full interpretation text, not just field labels.

Is the Tarot Card Meanings API available over Remote MCP for AI agents?

Yes. Every endpoint is exposed as a callable tool on the Remote MCP server at https://roxyapi.com/mcp/tarot over Streamable HTTP, so Claude, ChatGPT, Cursor, and any MCP client auto-discover it with no local setup or Docker.

How is the Tarot Card Meanings API billed?

Flat pricing: every data endpoint is one request, REST and MCP identical, with no credit weighting or per-token markup. Every plan includes all 18+ domains, so the Tarot Card Meanings API is included at no extra cost.

What arcana values does the Tarot Card Meanings API accept?

The arcana parameter accepts major, minor. Case-insensitive where it is a path value.

Start using Tarot Card Meanings API today.

Tarot readings a user can share and reopen unchanged, every card read upright and reversed for love, career and health.

All 18+ domains included with every plan. Every endpoint, MCP server, SDK, and templates.

Plans from $39/mo, starting at $1.80 per domain on annual billing. No credit card required for testing.

View Pricing & Get API Key