POST/v1/tarot/spread/celtic-cross

Celtic Cross Spread

Full 10-card Celtic Cross spread — traditional ten-position tarot spread. Positions: present, challenge, root, past, possible outcome, near future, self, external influences, hopes and fears, final outcome. Returns each card with its spread position, position meaning, and active interpretation for the drawn orientation.

Request parameters

allow_reversedoptional

boolean

If true, each card has a 50% chance of appearing reversed.

questionoptional

string | null

Optional question or intention for the reading.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.spread_type

string

Spread type: 'three_card' or 'celtic_cross'

data.positions

array[object]

data.positions[].card

object

data.positions[].card.id

string

Unique slug identifier e.g. 'the-fool'

data.positions[].card.name

string

Full card name e.g. 'The Fool'

data.positions[].card.arcana_type

string

'major' or 'minor'

data.positions[].card.suit

string | null

Suit for minor arcana: wands, cups, swords, pentacles. Null for major arcana.

data.positions[].card.number

integer

Card number. Major arcana: 0-21. Minor arcana: 1=Ace, 11=Page, 12=Knight, 13=Queen, 14=King.

data.positions[].card.element

string

Elemental correspondence: fire, water, air, earth, spirit

data.positions[].card.astrology_correspondence

string

Astrological planet or sign correspondence

data.positions[].card.keywords_upright

array[string]

Upright keywords

data.positions[].card.keywords_reversed

array[string]

Reversed keywords

data.positions[].card.upright_meaning

string

Full upright interpretation

data.positions[].card.reversed_meaning

string

Full reversed interpretation

data.positions[].card.yes_no

string

Yes/No polarity: 'yes', 'no', or 'maybe'

data.positions[].card.description

string

Visual description of the card imagery

data.positions[].is_reversed

boolean

True if the card was drawn in reversed orientation

data.positions[].position

string | null

Spread position name e.g. 'past', 'present', 'outcome'

data.positions[].position_meaning

string | null

What this spread position represents

data.positions[].active_meaning

string

The meaning to apply — upright_meaning when is_reversed=False, reversed_meaning when True

data.positions[].active_keywords

array[string]

Active keywords for this orientation

data.question

string | null

The question posed, if provided

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

Reserved; product endpoints are not feature-gated by plan (quota differs by tier).

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

• Three-Card Spread
• Yes/No Tarot Reading

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/tarot/spread/celtic-cross" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"allow_reversed":true,"question":"What is unfolding in my career?"}'

Python

import asterwise
from asterwise.api.tarot_api import TarotApi
from asterwise.models.spread_request import SpreadRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = SpreadRequest(
    allow_reversed=True,
    question="What is unfolding in my career?",
)

with asterwise.ApiClient(configuration) as client:
    api = TarotApi(client)
    result = api.tarot_celtic_cross(spread_request=request)
    print(result)

TypeScript

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

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

const result = await tarotCelticCross({
  client,
  body: {
      "allow_reversed": true,
      "question": "What is unfolding in my career?"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "spread_type": "celtic_cross",
    "positions": [
      {
        "card": {
          "id": "nine-of-cups",
          "name": "Nine of Cups",
          "arcana_type": "minor",
          "suit": "cups",
          "number": 9,
          "element": "water",
          "astrology_correspondence": "Jupiter in Pisces",
          "keywords_upright": [
            "contentment",
            "satisfaction",
            "... and 3 more items"
          ],
          "keywords_reversed": [
            "inner happiness",
            "materialism",
            "... and 2 more items"
          ],
          "upright_meaning": "The Nine of Cups — the Wish Card — signals emotional contentment and the fulfilment of desires. Satisfaction and pleasur…",
          "reversed_meaning": "Reversed, the Nine of Cups warns that outer satisfaction masks inner emptiness. True contentment comes from within, not…",
          "yes_no": "yes",
          "description": "A self-satisfied man sits before a curved display of nine cups on a cloth-covered table. His arms are crossed, his expre…"
        },
        "is_reversed": true,
        "position": "present",
        "position_meaning": "The present — the central issue or situation",
        "active_meaning": "Reversed, the Nine of Cups warns that outer satisfaction masks inner emptiness. True contentment comes from within, not…",
        "active_keywords": [
          "inner happiness",
          "materialism",
          "... and 2 more items"
        ]
      },
      {
        "card": {
          "id": "five-of-wands",
          "name": "Five of Wands",
          "arcana_type": "minor",
          "suit": "wands",
          "number": 5,
          "element": "fire",
          "astrology_correspondence": "Saturn in Leo",
          "keywords_upright": [
            "conflict",
            "competition",
            "... and 3 more items"
          ],
          "keywords_reversed": [
            "avoiding conflict",
            "respecting differences",
            "... and 1 more item"
          ],
          "upright_meaning": "The Five of Wands represents conflict, competition, and differing viewpoints creating friction. The challenge may be ext…",
          "reversed_meaning": "Reversed, the Five of Wands suggests tension releasing, conflict being avoided, or finally finding common ground after a…",
          "yes_no": "maybe",
          "description": "Five young men brandish wands at one another in apparent conflict. Their expressions and postures vary. The scene looks…"
        },
        "is_reversed": true,
        "position": "challenge",
        "position_meaning": "The challenge — what crosses or complicates the situation",
        "active_meaning": "Reversed, the Five of Wands suggests tension releasing, conflict being avoided, or finally finding common ground after a…",
        "active_keywords": [
          "avoiding conflict",
          "respecting differences",
          "... and 1 more item"
        ]
      },
      "... and 8 more items"
    ],
    "question": "What is unfolding in my career?"
  }
}