---
title: "Yes/No Tarot Reading"
method: POST
path: "/v1/tarot/spread/yes-no"
tags: ["Tarot"]
---

# Yes/No Tarot Reading

`POST /v1/tarot/spread/yes-no`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/tarot/spread/yes-no`
- Auth: HTTP bearer

Draw one card for a yes/no answer. Answer logic: yes-polarity card upright = 'yes' (strong). Yes-polarity card reversed = 'maybe' (leaning). No-polarity card upright = 'no' (strong). No-polarity card reversed = 'maybe' (leaning). Maybe-polarity card = 'maybe' (unclear). Reversed cards are enabled by default for this spread.

## Request body

- YesNoRequest
  - `allow_reversed` boolean: If true, reversed cards return 'maybe' instead of their base yes/no answer.
  - `question` string, nullable: The yes/no question being asked.

## Response `200`

Successful Response

- ApiResponseYesNoResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` YesNoResponse, required
    - `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
    - `answer` string, required: 'yes', 'no', or 'maybe'
    - `confidence` string, required: 'strong' = card directly says yes/no. 'leaning' = reversed card. 'unclear' = maybe card.
    - `question` string, nullable
    - `active_meaning` string, required

## 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)