Skip to content

3-Cards Tarot Reading

The 3-Cards Tarot Reading provides insight into your Past, Present, and Future.
It draws three cards that reflect influences, challenges, and guidance, personalized using your name and date of birth.

Use this reading to gain clarity, reflect on patterns, and prepare for upcoming cycles.

Endpoint

Method Path
GET https://the-numerology-api.p.rapidapi.com/tarot/reading
POST https://the-numerology-api.p.rapidapi.com/tarot/reading

Required Headers

x-rapidapi-key: YOUR_RAPIDAPI_KEY
x-rapidapi-host: the-numerology-api.p.rapidapi.com
Content-Type: application/json   (POST only)

Get your key from RapidAPI.

Parameters

Param Type Required Description
name string Yes Your full name. Used to personalize the reading.
dob string Yes Date of birth in YYYY-MM-DD format.
mode string No random (default) or daily. Daily mode seeds the draw to ensure same cards for the same day.

Example Requests

GET Request

curl --request GET \
  --url "https://the-numerology-api.p.rapidapi.com/tarot/reading?name=Alice&dob=1988-07-20&mode=random" \
  --header "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  --header "x-rapidapi-host: the-numerology-api.p.rapidapi.com"

POST Request (JSON Body)

curl --request POST \
  --url "https://the-numerology-api.p.rapidapi.com/tarot/reading" \
  --header "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  --header "x-rapidapi-host: the-numerology-api.p.rapidapi.com" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Alice",
    "dob": "1988-07-20",
    "mode": "daily"
  }'

Response Example

{
  "status": "success",
  "mode": "random",
  "name": "alice",
  "dob": "1988-07-20",
  "timestamp": "2025-10-31T09:23:00.822399",
  "reading": [
    {
      "position": "past",
      "card": "The High Priestess",
      "reversed": true,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909489/02-TheHighPriestess_REVERSED_ybggyg.png",
      "meaning": "In reverse, The High Priestess indicates blocked intuition, secrets being withheld, or a disconnection from your inner self. You may be ignoring your instincts or struggling to see the truth. This card suggests it’s time to quiet the noise and turn inward to regain clarity. Be wary of deception—whether from others or self-delusion. Reconnect with your inner wisdom before making important decisions."
    },
    {
      "position": "present",
      "card": "Eight of Swords",
      "reversed": true,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909620/Swords08_REVERSED_kyqbdb.png",
      "meaning": "Reversed, the Eight of Swords signals release and breaking free from limiting beliefs. You're beginning to see through illusions and reclaim your power. Mental clarity is returning—trust it."
    },
    {
      "position": "future",
      "card": "Ten of Swords",
      "reversed": true,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909624/Swords10_REVERSED_xlrg81.png",
      "meaning": "Reversed, the Ten of Swords suggests recovery and resilience. You're ready to rise from a difficult time, stronger and wiser. Let go of the past and embrace your next chapter."
    }
  ],
  "card_backcover": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909534/backcover_dgkxji.png"
}

View on RapidAPI

Note

  • mode=daily seeds the card draws based on your name, dob, and current date—giving consistent daily guidance.
  • Each card’s reversed status may change its interpretation.
  • image_url provides the card illustration; card_backcover is the generic reverse card.
  • Cards are returned in Past → Present → Future order.