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://api.numerologyapi.com/api/v1/tarot/reading
POST https://api.numerologyapi.com/api/v1/tarot/reading

Required Headers

X-API-Key: YOUR_API_KEY
Content-Type: application/json   (POST only)
Host: api.numerologyapi.com

You can also authenticate with Authorization: Bearer YOUR_API_KEY.

Create and manage API keys in the Numerology API dashboard.

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.

Add the optional lang query parameter to localize responses. Supported values: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh.

Example Requests

GET Request

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/tarot/reading?name=John+Doe&dob=1992-07-16&mode=random&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

POST Request (JSON Body)

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/tarot/reading?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "name": "John Doe",
  "dob": "1992-07-16",
  "mode": "random"
}'
Response Example 
{
  "status": "success",
  "mode": "random",
  "name": "john doe",
  "dob": "1992-07-16",
  "timestamp": "2026-08-18T00:05:59.013552",
  "reading": [
    {
      "position": "past",
      "card": "Wheel of Fortune",
      "reversed": false,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909507/10-WheelOfFortune_fokxki.png",
      "meaning": "The Wheel of Fortune represents fate, cycles, and unexpected change. Upright, it signals a turning point—often in your favor—and encourages you to embrace life’s ups and downs with faith. This card highlights karma, luck, and the interconnectedness of all things. Trust the universe’s rhythm and stay adaptable."
    },
    {
      "position": "present",
      "card": "The Devil",
      "reversed": false,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909534/15-TheDevil_ztmvio.png",
      "meaning": "The Devil card highlights temptation, addiction, and material bondage. Upright, it reveals areas where you feel trapped or powerless—often by your own desires or fears. It challenges you to confront unhealthy attachments and reclaim your autonomy. Awareness is the first step toward liberation."
    },
    {
      "position": "future",
      "card": "Six of Pentacles",
      "reversed": true,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909583/Pentacles06_REVERSED_ccxi5g.png",
      "meaning": "Reversed, the Six of Pentacles may indicate inequality, strings attached to help, or financial imbalance. Beware of hidden motives or unhealthy dependencies in relationships or money matters."
    }
  ],
  "card_backcover": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909534/backcover_dgkxji.png",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "e7d2f5dafe249067",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "1.0.2",
    "endpoint_name": "tarot_reading",
    "endpoint_description": "Generates a tarot card reading with interpretations and guidance.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-08-18T01:05:59.033692+01:00",
    "data_source": "Internal Engine",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "fr",
      "es",
      "de",
      "pt",
      "ja",
      "hi",
      "ar",
      "ru",
      "tr",
      "it",
      "pl",
      "nl",
      "id",
      "ko",
      "th",
      "ro",
      "ur",
      "gu",
      "bn",
      "vi",
      "ta",
      "te",
      "mr",
      "pa",
      "zh"
    ],
    "notes": ""
  }
}

Open Dashboard

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.