---
title: "Card of the Day"
method: GET
path: "/v1/tarot/card-of-the-day"
tags: ["Tarot"]
---

# Card of the Day

`GET /v1/tarot/card-of-the-day`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/tarot/card-of-the-day`
- Auth: HTTP bearer

Returns a deterministic daily tarot card. The same card is returned for all requests on the same date — seeded by SHA-256 hash of the date string. Optionally provide a date (YYYY-MM-DD) to get the card for any day. "Today" is the current date in UTC unless you pass `timezone` (the caller's IANA zone, e.g. Asia/Kolkata) or an explicit `date`.

## Query parameters

- `date` string, nullable: Date in YYYY-MM-DD format. Defaults to today (UTC, or in `timezone`). Overrides timezone.
- `allow_reversed` boolean: If true, the card may appear reversed (also deterministic by date).
- `timezone` string, nullable: IANA time zone (or ±HH:MM) whose current date is "today", e.g. Asia/Kolkata. Default: UTC.

## Response `200`

Successful Response

- ApiResponseCardOfDayResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` CardOfDayResponse, required
    - `date` string, required: Date for this card in YYYY-MM-DD format
    - `card` TarotCardSchema, required
      - `id` string, required: Unique slug identifier e.g. 'the-fool'
      - `name` string, required: Full card name e.g. 'The Fool'
      - `arcana_type` string, required: 'major' or 'minor'
      - `suit` string, nullable: Suit for minor arcana: wands, cups, swords, pentacles. Null for major arcana.
      - `number` integer, required: Card number. Major arcana: 0-21. Minor arcana: 1=Ace, 11=Page, 12=Knight, 13=Queen, 14=King.
      - `element` string, required: Elemental correspondence: fire, water, air, earth, spirit
      - `astrology_correspondence` string, required: Astrological planet or sign correspondence
      - `keywords_upright` string[], required: Upright keywords
      - `keywords_reversed` string[], required: Reversed keywords
      - `upright_meaning` string, required: Full upright interpretation
      - `reversed_meaning` string, required: Full reversed interpretation
      - `yes_no` string, required: Yes/No polarity: 'yes', 'no', or 'maybe'
      - `description` string, required: Visual description of the card imagery
    - `is_reversed` boolean, required
    - `active_meaning` string, required
    - `active_keywords` string[], required
    - `timezone` string, nullable: Time zone whose current date was taken as today: the timezone you passed, or 'UTC'. Absent when you passed an explicit date.

## Other responses

- `401`: Authentication failed
- `403`: Authorization failed
- `404`: Resource not found
- `413`: Payload too large
- `422`: Validation error
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream provider error
- `503`: Service unavailable

---

[API](https://skmtc.dev/asterwise/apis/asterwise-api.md) · [All operations](https://skmtc.dev/asterwise/apis/asterwise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asterwise/apis/asterwise-api/revisions/3c4bbb1194e2?raw)