---
title: "Major Arcana Cards"
method: GET
path: "/v1/tarot/major-arcana"
tags: ["Tarot"]
---

# Major Arcana Cards

`GET /v1/tarot/major-arcana`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/tarot/major-arcana`
- Auth: HTTP bearer

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

## Response `200`

Successful Response

- ApiResponseListTarotCardSchema
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` TarotCardSchema[], required: The endpoint response payload
    - `id` string, required: Unique slug identifier e.g. 'the-fool'
    - `name` string, required: Full card name e.g. 'The Fool'
    - `arcana_type` string, required: 'major' or 'minor'
    - `suit` string, nullable: Suit for minor arcana: wands, cups, swords, pentacles. Null for major arcana.
    - `number` integer, required: Card number. Major arcana: 0-21. Minor arcana: 1=Ace, 11=Page, 12=Knight, 13=Queen, 14=King.
    - `element` string, required: Elemental correspondence: fire, water, air, earth, spirit
    - `astrology_correspondence` string, required: Astrological planet or sign correspondence
    - `keywords_upright` string[], required: Upright keywords
    - `keywords_reversed` string[], required: Reversed keywords
    - `upright_meaning` string, required: Full upright interpretation
    - `reversed_meaning` string, required: Full reversed interpretation
    - `yes_no` string, required: Yes/No polarity: 'yes', 'no', or 'maybe'
    - `description` string, required: Visual description of the card imagery

## Other responses

- `401`: Authentication failed
- `403`: Authorization failed
- `404`: Resource not found
- `413`: Payload too large
- `422`: Validation error
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream provider error
- `503`: Service unavailable

---

[API](https://skmtc.dev/asterwise/apis/asterwise-api.md) · [All operations](https://skmtc.dev/asterwise/apis/asterwise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asterwise/apis/asterwise-api/revisions/3c4bbb1194e2?raw)