Single Tarot Card

Returns full data for a single card by its slug ID. Example IDs: 'the-fool', 'ace-of-wands', 'king-of-cups', 'the-world', 'ten-of-swords'.

Endpoint

GET /v1/tarot/cards/{card_id}

Request parameters

Field	Type	Required	Description
card_id	string	Yes

Example request

curl

curl -X GET "https://api.asterwise.com/v1/tarot/cards/the-fool" \
  -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_card(card_id="the-fool")
    print(result)

TypeScript

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

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

const result = await tarotCard({
  client,
  path: {
      "card_id": "the-fool"
  },
});

console.log(result.data);

Example response

{
  "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…"
  }
}

Response fields

Field	Type	Description
success	boolean	True if the request succeeded
message	string	Human-readable status message
data	object
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

Code	Description	Reference
authentication_failed	Missing or invalid API key.	authentication_failed
ephemeris_unavailable	Upstream ephemeris service error.	ephemeris_unavailable
insufficient_tier	API key tier does not include this endpoint.	insufficient_tier
internal_error	Unexpected server error.	internal_error
ip_rate_limit_exceeded	Too many requests in a short window.	ip_rate_limit_exceeded
payload_too_large	Request body exceeds the size limit.	payload_too_large
resource_not_found	Referenced resource was not found.	resource_not_found
validation_error	Request body failed schema validation.	validation_error

Related endpoints

• Tarot Cards by Suit
• Major Arcana Cards
• All Tarot Cards