# Tarot Card Meanings API

> Tarot Card Meanings API. Retrieve the complete Rider-Waite-Smith tarot deck of 78 cards: 22 Major Arcana (numbered 0-21, representing life lessons,

- Capability page: https://roxyapi.com/apis/tarot-card-meanings-api
- Full domain: https://roxyapi.com/products/tarot-api
- OpenAPI spec: https://roxyapi.com/api/v2/tarot/openapi.json
- Remote MCP server: https://roxyapi.com/mcp/tarot

## Overview

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.

## Endpoints

- `GET /api/v2/tarot/cards` List all 78 tarot cards
- `GET /api/v2/tarot/cards/{id}` Get detailed tarot card information

## Example request

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

## Example response

```json
{
  "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"
    }
  ]
}
```

## Remote MCP

Every endpoint is a callable tool on the Remote MCP server at https://roxyapi.com/mcp/tarot over Streamable HTTP. Tool name for `GET /tarot/cards`: `get_tarot_cards`. `tools/list` is free; `tools/call` bills the same as REST.

## FAQ

### What does the Tarot Card Meanings API return?

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). 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: 1 request equals 1 quota unit, REST and MCP identical, with no credit weighting or per-token markup. Every plan includes all 12 domains, so the Tarot Card Meanings API is included at no extra cost.

### What lang values does the Tarot Card Meanings API accept?

The lang parameter accepts en, tr, de, es, hi, pt, fr, ru. Case-insensitive where it is a path value.

## Full reference

Fetch the OpenAPI spec at https://roxyapi.com/api/v2/tarot/openapi.json. Master agent manifest at https://roxyapi.com/llms.txt.