Tarot reading of the day (public, no key)

GET

/public/tarot/daily-reading

Code sample: cURL

request.sh

curl 'https://api.astroway.info/v1/public/tarot/daily-reading?lang=en'

▸ Спробувати GET /public/tarot/daily-reading

• Production

The Rider-Waite-Smith three-card spread of the day (the same cards for every caller on a date) read as a whole, in the requested language: each position in context, synthesis and advice. The same answer shape as POST /interpret/tarot, plus back (the card back). In a language other than English each position carries positionMeaningLocalized and each card suitLocalized and meaningLocalized (keywords and meaning of the side drawn); the long card texts are GET /public/tarot/texts by slug. Generated once per date and language and cached for a day, Cache-Control: public, max-age=3600.

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

deck

string

nullable

spread

object

slug

string

nullable

name

string

nullable

question

nullable

positions

Array<object>

nullable

object

index

number

nullable

position

string

nullable

positionMeaning

string

nullable

card

object

slug

string

nullable

name

string

nullable

reversed

boolean

nullable

reading

string

nullable

synthesis

string

nullable

advice

string

nullable

disclaimer

string

nullable

model

string

nullable

language

string

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-10-07",
    "deck": "rider-waite",
    "spread": {
      "slug": "three-card",
      "name": "Past / Present / Future"
    },
    "question": null,
    "positions": [
      {
        "index": 0,
        "position": "Past",
        "positionMeaning": "Forces from the past shaping the situation.",
        "card": {
          "slug": "the-star",
          "name": "The Star"
        },
        "reversed": false,
        "reading": "A period of renewed hope is behind this day..."
      }
    ],
    "synthesis": "Taken together, the cards...",
    "advice": "Give the plan one quiet hour today.",
    "disclaimer": "This is generated by AI for entertainment and self-reflection purposes only.",
    "model": "groq/llama-3.3-70b",
    "language": "en"
  },
  "_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"
  }
}