Skip to content
AstroWay/api v2.325.2 · docs
all systems operational

RWS: Shadow Card

POST
/tarot/rider-waite/shadow-card
request.sh
curl -X POST https://api.astroway.info/v1/tarot/rider-waite/shadow-card \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{ "date": "1990-05-15" }'

Shadow card pair (mirror in major arcana of personality card).

fields
string

Comma-separated dotted paths, relative to data, to keep in the response. A path is applied to every element of an array, so planets.name means the name of each planet. Paths that match nothing come back in _fields_unmatched; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer.

Example
planets.name,planets.longitude
precision
integer
<= 15

Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute.

Example
4
Idempotency-Key
string
>= 1 characters <= 255 characters /^[\x21-\x7E]+$/

Unique per logical operation, kept across retries. For 24 hours from the first request, a repeat with the same key, method, path, body and query string returns the stored response with Idempotent-Replayed: true and costs 0 credits. The same key with a different body or query string is a 409 IDEMPOTENCY_KEY_REUSED; a repeat while the first is still running is a 409 IDEMPOTENCY_IN_PROGRESS. Only 2xx responses are kept. See /idempotency/.

Example
01HXY2A7ZM0ABCDEF
Media type application/json
object
art

Card art set, e.g. rws-1909, rws-restored, rws-vector. GET /v1/tarot/decks lists the sets per deck.

string
<= 40 characters
date required
string
/^\d{4}-\d{2}-\d{2}$/
Example
{
"date": "1990-05-15"
}

Successful calculation

Media type application/json
object
ok
boolean
data
object
date
string
nullable
personalityCard
object
number
number
nullable
name
string
nullable
upright
object
keywords
Array<string>
nullable
meaning
string
nullable
reversed
object
keywords
Array<string>
nullable
meaning
string
nullable
astrology
string
nullable
numerology
number
nullable
yes
string
nullable
slug
string
nullable
category
string
nullable
shadowCard
object
number
number
nullable
name
string
nullable
upright
object
keywords
Array<string>
nullable
meaning
string
nullable
reversed
object
keywords
Array<string>
nullable
meaning
string
nullable
astrology
string
nullable
numerology
number
nullable
yes
string
nullable
slug
string
nullable
category
string
nullable
Example
{
"ok": true,
"data": {
"date": "1990-05-15",
"personalityCard": {
"number": 3,
"name": "The Empress",
"upright": {
"keywords": [
"fertility"
],
"meaning": "Creative and material abundance; embodied feminine power."
},
"reversed": {
"keywords": [
"dependence"
],
"meaning": "Over-nurturing or creative blockage."
},
"astrology": "Venus",
"numerology": 3,
"yes": "yes",
"slug": "the-empress",
"category": "major"
},
"shadowCard": {
"number": 18,
"name": "The Moon",
"upright": {
"keywords": [
"illusion"
],
"meaning": "Things are not as they appear; trust intuition through fog."
},
"reversed": {
"keywords": [
"repressed fears"
],
"meaning": "Confusion lifting; suppressed fears surfacing."
},
"astrology": "Pisces",
"numerology": 18,
"yes": "maybe",
"slug": "the-moon",
"category": "major"
}
}
}

Validation error

Media type application/json
Example
{
"ok": false,
"error": {
"code": "INVALID_INPUT",
"message": "Validation failed: date: Date must be YYYY-MM-DD",
"details": [
{
"path": "date",
"message": "Date must be YYYY-MM-DD"
}
]
}
}

Missing or invalid API key

Media type application/json
Example
{
"ok": false,
"error": {
"code": "INVALID_API_KEY",
"message": "Invalid API key"
}
}