---
title: "RWS: Birth Card"
method: POST
path: "/tarot/rider-waite/birth-card"
tags: ["Tarot: Rider-Waite-Smith"]
---

# RWS: Birth Card

`POST /tarot/rider-waite/birth-card`

## Request

- Base URL: `https://api.astroway.info/v1`
- URL: `https://api.astroway.info/v1/tarot/rider-waite/birth-card`
- Auth: API key in header `X-Api-Key`

Birth card from date per Mary Greer's method (m+d+y reduced).

## Query parameters

- `fields` string
- `precision` integer

## Request body

- TarotDate
  - `art` string: Card art set, e.g. rws-1909, rws-restored, rws-vector. GET /v1/tarot/decks lists the sets per deck.
  - `date` string, required

## Response `200`

Successful calculation

- object
  - `ok` boolean
  - `data` object
    - `date` string, nullable
    - `primary` object, nullable
      - `name` string, nullable
    - `secondary` object, nullable
      - `name` string, nullable

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key

## Changes

- **2026-10-06** `8a54b26dfec8`: 1 info
  - added the new optional request property `art`
- **2026-09-21** `b64222844186`: 2 info
  - added the new optional `query` request parameter `fields`
  - added the new optional `query` request parameter `precision`
- **2026-08-22** `5a17388652f3`: 1 breaking
  - added the new required request property `date`
- **2026-08-14** `994755209cea`: 2 info
  - api tag `Tarot: Rider-Waite-Smith` added
  - api tag `Tarot — Rider-Waite-Smith` removed

[Operation history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/tarot/rider-waite/birth-card/post.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/909c97d3c458?raw)