Skip to content

Power Tarot Reading¶

Power Tarot Reading provides a single-card reading that gives insight into your personal energy, challenges, or guidance for the day.
The reading considers your name and date of birth and can be drawn either randomly or daily-seeded for consistent daily guidance.

Use the Power Tarot Reading to reflect, plan, or gain clarity on current life circumstances.

Endpoint¶

Method	Path
`GET`	`https://api.numerologyapi.com/api/v1/tarot/power`
`POST`	`https://api.numerologyapi.com/api/v1/tarot/power`

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 card 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/power?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/power?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.574376",
  "power_reading": {
    "card": "Three of Swords",
    "reversed": true,
    "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909609/Swords03_REVERSED_lkssru.png",
    "meaning": "Reversed, the Three of Swords suggests lingering sadness or resistance to let go. You're healing but may be stuck in the past. Be kind to yourself—grief is a process, not a destination."
  },
  "card_backcover": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909534/backcover_dgkxji.png",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "a7f1de69e7e1812e",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "tarot_power",
    "endpoint_description": "Determines your personal power tarot card and its significance.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:36:43.584917+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 based on your name, dob, and current date—giving consistent daily guidance.
reversed indicates the card is upside-down, which may alter interpretation.
image_url provides the card illustration, while card_backcover is used for the card’s reverse side.
Suitable for daily reflection, meditation, or decision-making guidance.