: Create and shuffle a new deck

API: deckofcardsapi.com:deck-of-cards
Endpoint: /deck/new/shuffle/
Response format: text/plain
Auth: unknown
Method: GET
Last Status: 200
Latency: 661ms

Description

Creates a new deck of cards and shuffles it. Can create multiple decks by specifying deck_count.

Parameters (2)

cards (string, query, optional)

Comma-separated list of card codes for a partial deck (e.g., AS,2S,KS). Leave empty for full 52-card deck.

deck_count (integer, query, optional, default: 1)

Number of decks to use (default: 1). Blackjack typically uses 6 decks.

Constraints: {'minimum': 1}

Examples (2)

Create and shuffle a new deck openapi-spec
curl 'https://deckofcardsapi.com/api/deck/new/shuffle/?cards=AS%2C2S%2CKS%2CAD%2C2D%2CKD%2CAC%2C2C%2CKC%2CAH%2C2H%2CKH'
import requests

resp = requests.get(
    "https://deckofcardsapi.com/api/deck/new/shuffle/",
    params={
        'cards': 'AS,2S,KS,AD,2D,KD,AC,2C,KC,AH,2H,KH',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("deckofcardsapi")
result = api.fetch("deck/new/shuffle/", cards="AS,2S,KS,AD,2D,KD,AC,2C,KC,AH,2H,KH")

for item in result:
    print(item)
const resp = await fetch("https://deckofcardsapi.com/api/deck/new/shuffle/?cards=AS%2C2S%2CKS%2CAD%2C2D%2CKD%2CAC%2C2C%2CKC%2CAH%2C2H%2CKH");
const data = await resp.json();
Create and shuffle a new deck probe-gate
curl 'https://deckofcardsapi.com/api/deck/new/shuffle/?deck_count=1&cards=AS%2C2S%2CKS%2CAD%2C2D%2CKD%2CAC%2C2C%2CKC%2CAH%2C2H%2CKH'
import requests

resp = requests.get(
    "https://deckofcardsapi.com/api/deck/new/shuffle/",
    params={
        'deck_count': '1',
        'cards': 'AS,2S,KS,AD,2D,KD,AC,2C,KC,AH,2H,KH',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("deckofcardsapi")
result = api.fetch("deck/new/shuffle/", deck_count=1, cards="AS,2S,KS,AD,2D,KD,AC,2C,KC,AH,2H,KH")

for item in result:
    print(item)
const resp = await fetch("https://deckofcardsapi.com/api/deck/new/shuffle/?deck_count=1&cards=AS%2C2S%2CKS%2CAD%2C2D%2CKD%2CAC%2C2C%2CKC%2CAH%2C2H%2CKH");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 02:45:50.710201 200 661ms
2026-04-16 01:21:13.796078 200 659ms
2026-04-15 01:50:39.207451 200 246ms
2026-04-15 00:09:02.437154 200 282ms
2026-04-14 03:30:29.610776 200 727ms
2026-04-14 00:41:13.831747 200 255ms
2026-04-12 15:38:30.450107 200 508ms
2026-04-12 14:02:08.900234 200 510ms
2026-04-10 01:55:52.112381 200 181ms
2026-04-10 01:30:30.925760 200 234ms
2026-04-09 02:13:20.973466 200 448ms
2026-04-09 01:36:00.828944 200 490ms
2026-03-27T00:01:21.815411 200 448ms