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, es, de, fr, pt.

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-02-28T06:36:43.165542",
  "reading": [
    {
      "position": "past",
      "card": "Nine of Wands",
      "reversed": true,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909654/Wands09_REVERSED_c1lzc8.png",
      "meaning": "Reversed, the Nine of Wands suggests burnout, defensiveness, or giving up too soon. Reassess your limits—are you fighting the right battles or exhausting yourself unnecessarily?"
    },
    {
      "position": "present",
      "card": "Queen of Pentacles",
      "reversed": false,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909601/Pentacles13_gcz6tw.png",
      "meaning": "The Queen of Pentacles is nurturing, practical, and abundant. Upright, she embodies care for home, finances, and well-being. She balances work and family effortlessly and offers warmth and security to others."
    },
    {
      "position": "future",
      "card": "Page of Pentacles",
      "reversed": false,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909597/Pentacles11_hbj9js.png",
      "meaning": "The Page of Pentacles is a messenger of opportunity, learning, and ambition. Upright, it signifies a student mindset, practical planning, and the start of a new venture or career path. You're ready to invest in your goals."
    }
  ],
  "card_backcover": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909534/backcover_dgkxji.png",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "20bb36de5d26843f",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "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-02-28T07:36:43.169490+01:00",
    "data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "es",
      "de",
      "fr",
      "pt"
    ],
    "notes": ""
  }
}

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.