Draw random cards for a reading

Code-Snippets

curl "https://api.oanor.com/tarot-api/v1/draw" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/tarot-api/v1/draw", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/tarot-api/v1/draw");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/tarot-api/v1/draw",
    headers={"x-oanor-key": "oanor_test_..."}
)

Beispiel-Response

Echte Antwort dieses Endpoints, erfasst beim letzten Health-Check.

{
    "data": {
        "cards": [
            {
                "id": "cu06",
                "name": "Six of Cups",
                "suit": "cups",
                "type": "minor-arcana",
                "value": "six",
                "value_int": 6,
                "description": "Children in an old garden, their cups filled with flowers.",
                "meaning_upright": "A card of the past and of memories, looking back, as--for example--on childhood; happiness, enjoyment, but coming rather from the past; things that have vanished. Another reading reverses this, giving new relations, new knowledge, new environment, and then the children are disporting in an unfamiliar precinct.",
                "meaning_reversed": "The future, renewal, that which will come to pass presently."
            },
            {
                "id": "pe03",
                "name": "Three of Pentacles",
                "suit": "pentacles",
                "type": "minor-arcana",
                "value": "three",
                "value_int": 3,
                "description": "A sculptor at his work in a monastery. Compare the design which illustrates the Eight of Pentacles. The apprentice or amateur therein has received his reward and is now at work in earnest.",
                "meaning_upright": "Métier, trade, skilled labour; usually, however, regarded as a card of nobility, aristocracy, renown, glory.",
                "meaning_reversed": "Mediocrity, in work and otherwise, puerility, pettiness, weakness."
            },
            {
                "id": "wa08",
                "name": "Eight of Wands",
                "suit": "wands",
                "type": "minor-arcana",
                "value": "eight",
                "value_int": 8,
                "description": "The card represents motion through the immovable-a flight of wands through an open country; but they draw to the term of their course. That which they signify is at hand; it may be even on the threshold.",
                "meaning_upright": "Activity in undertakings, the path of such activity, swiftness, as that of an express messenger; great haste, great hope, speed towards an end which promises assured felicity; generally, that which is on the move; also the arrows of love.",
                "meaning_reversed": "Arrows of jealousy, internal dispute, stingings of conscience, quarrels; and domestic disputes for persons who are married."
            }
        ],
        "drawn": 3
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:27.614Z",
        "request_id": "4f5f40d6-221f-4b97-9c7b-0a0dd70f7674"
    },
    "status": "ok",
    "message": "Cards drawn",
    "success": true
}