GET/v1/tarot/major-arcana

Major Arcana Cards

Returns all 22 Major Arcana cards (The Fool through The World). Major Arcana represent archetypal life themes and major life events.

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
• Single Tarot Card
• All Tarot Cards

Request

GET·application/json

curl

curl -X GET "https://api.asterwise.com/v1/tarot/major-arcana" \
  -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_major_arcana()
    print(result)

TypeScript

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

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

const result = await tarotMajorArcana({
  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 20 more items"
  ]
}