---
title: "Tarot card texts (public, no key)"
method: GET
path: "/public/tarot/texts"
tags: ["Public"]
---

# Tarot card texts (public, no key)

`GET /public/tarot/texts`

## Request

- Base URL: `https://api.astroway.info/v1`
- URL: `https://api.astroway.info/v1/public/tarot/texts`
- Auth: none required

Long-form readings for the 78 Rider-Waite-Smith cards: a three-paragraph `description` (the imagery, the upright meaning, the reversed meaning), and for `upright` and `reversed` one text each on `love`, `career`, `finance`, `health` and `spirit`, plus `name` and up to five `keywords` per side. `cards` is a comma-separated list of slugs (as in GET /public/tarot/decks); omit it for all 78; an unknown slug is a 400 `INVALID_CARD`. Our own prose. A language without its table yet answers English text with `textLocalized: false`; names and keywords are localised either way. Static data, `Cache-Control: public, max-age=604800`.

## Query parameters

- `cards` string
- `lang` string
- `fields` string
- `precision` integer

## Headers

- `Accept-Language` string

## Response `200`

OK

- object
  - `ok` boolean
  - `data` object
    - `lang` string, nullable
    - `textLocalized` boolean, nullable
    - `cards` object, nullable
      - `9-of-swords` object, nullable
        - `name` string, nullable
        - `keywords` object, nullable
          - `upright` string[], nullable
          - `reversed` string[], nullable
        - `description` string, nullable
        - `upright` object, nullable
          - `love` string, nullable
          - `career` string, nullable
          - `finance` string, nullable
          - `health` string, nullable
          - `spirit` string, nullable
        - `reversed` object, nullable
          - `love` string, nullable
          - `career` string, nullable
          - `finance` string, nullable
          - `health` string, nullable
          - `spirit` string, nullable
  - `_footer` string: Free-tier watermark, present on every public response. Keys on a paid plan do not receive it.

## Other responses

- `400`: Invalid sign or date

## Changes

- **2026-10-07** `da6d49943f9e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/public/tarot/texts/get.md)

---

[API](https://skmtc.dev/astroway/apis/astroway-calculation-api.md) · [All operations](https://skmtc.dev/astroway/apis/astroway-calculation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/astroway/apis/astroway-calculation-api/revisions/593d763ba9a5?raw)