Suits, values & card-code format

Code snippets

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

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

$ch = curl_init("https://api.oanor.com/cards-api/v1/meta");
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/cards-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "Standard 52-card deck engine (optionally with jokers and multiple decks). /v1/deck = create a shuffled deck (returns a deck_id); /v1/draw = draw cards — from a deck_id, or from a brand-new deck when no deck_id is given (handy for quick random cards); /v1/shuffle = reshuffle a deck. Each card includes its code, value, suit and a PNG + SVG image URL.",
        "suits": [
            "HEARTS",
            "DIAMONDS",
            "CLUBS",
            "SPADES"
        ],
        "source": "Deck of Cards (deckofcardsapi.com)",
        "values": [
            "ACE",
            "2",
            "3",
            "4",
            "5",
            "6",
            "7",
            "8",
            "9",
            "10",
            "JACK",
            "QUEEN",
            "KING"
        ],
        "endpoints": [
            "/v1/deck",
            "/v1/draw",
            "/v1/shuffle",
            "/v1/meta"
        ],
        "code_format": "two characters: value + suit initial, e.g. AS=Ace of Spades, 0H=10 of Hearts, KD=King of Diamonds, X1/X2=Jokers"
    },
    "meta": {
        "timestamp": "2026-05-31T14:57:46.565Z",
        "request_id": "a5c9cb34-c181-4ae3-b85d-46c312e99e4a"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}