Tarot Card of the Day (public, no key)

GET

/public/tarot/daily

Code sample: cURL

request.sh

curl 'https://api.astroway.info/v1/public/tarot/daily'

▸ Try it GET /public/tarot/daily

• Production

Deterministic Rider-Waite-Smith single card, seeded by date: the same date always yields the same card. No AI. _footer watermark. localized follows ?lang= / Accept-Language and carries, keyed by slug, the card name and suit, upright and reversed with keywords and meaning, plus positions (same order and index as the spread), and spread.name, in 21 languages: uk en ru de pl es pt fr it nl cs ro hu el tr ar hi ja ko vi id. nameLocalized says the name is in that language; textLocalized (per card and for the spread) says the same for the prose. The English fields beside it are the stable identifiers and never change.

Parameters

Query Parameters

date

string format: date

Calendar date YYYY-MM-DD (UTC). Defaults to today.

lang

string

Example

en

Language for this call, overriding Accept-Language. The canonical per-call form: a page that renders in one language passes it here rather than reconfiguring its client. Unknown or inactive codes fall back to uk.

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

Header Parameters

Accept-Language

string

BCP-47 language (e.g. uk, en, de). Set it once on your HTTP client as its default; for a single call, ?lang= overrides it. Unknown or inactive codes fall back to uk.

Responses

200

OK

Media type application/json

object

ok

boolean

data

object

date

string

nullable

spread

object

slug

string

nullable

name

string

nullable

cardCount

number

nullable

seed

number

nullable

drawn

Array<object>

nullable

object

position

object

index

number

nullable

name

string

nullable

meaning

string

nullable

card

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

reversed

boolean

nullable

localized

object

cards

object

the-devil

object

name

string

nullable

suit

string

nullable

nameLocalized

boolean

nullable

upright

object

keywords

Array<string>

nullable

meaning

string

nullable

reversed

object

keywords

Array<string>

nullable

meaning

string

nullable

textLocalized

boolean

nullable

positions

Array<object>

nullable

object

index

number

nullable

name

string

nullable

meaning

string

nullable

spread

object

name

string

nullable

textLocalized

boolean

nullable

_footer

Free-tier watermark, present on every public response. Keys on a paid plan do not receive it.

string

Example

{
  "ok": true,
  "data": {
    "date": "2026-08-21",
    "spread": {
      "slug": "single-card",
      "name": "Single Card",
      "cardCount": 1
    },
    "seed": 20260821,
    "drawn": [
      {
        "position": {
          "index": 0,
          "name": "The Card",
          "meaning": "The essential answer or theme."
        },
        "card": {
          "number": 15,
          "name": "The Devil",
          "upright": {
            "keywords": [
              "attachment",
              "addiction",
              "shadow",
              "materialism"
            ],
            "meaning": "Bondage by attachment or shadow content; see what holds you."
          },
          "reversed": {
            "keywords": [
              "breaking free",
              "release",
              "detachment"
            ],
            "meaning": "Breaking free of an attachment or addiction."
          },
          "astrology": "Capricorn",
          "numerology": 15,
          "yes": "no",
          "slug": "the-devil",
          "category": "major"
        },
        "reversed": true
      }
    ],
    "localized": {
      "cards": {
        "the-devil": {
          "name": "Диявол",
          "suit": "Старший Аркан",
          "nameLocalized": true,
          "upright": {
            "keywords": [
              "прив'язаність",
              "залежність",
              "тінь",
              "матеріалізм"
            ],
            "meaning": "Кайдани прив'язаності або тіньового змісту; побач, що тебе тримає."
          },
          "reversed": {
            "keywords": [
              "звільнення",
              "вивільнення",
              "відстороненість"
            ],
            "meaning": "Звільнення від прив'язаності або залежності."
          },
          "textLocalized": true
        }
      },
      "positions": [
        {
          "index": 0,
          "name": "Карта",
          "meaning": "Суть відповіді або головна тема."
        }
      ],
      "spread": {
        "name": "Одна карта"
      },
      "textLocalized": true
    }
  },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

400

Invalid sign or date

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_SIGN",
    "message": "sign must be one of the 12 zodiac signs"
  }
}