: List cards in a pile

API: deckofcardsapi.com:deck-of-cards
Endpoint: /deck/{deck_id}/pile/{pile_name}/list/
Response format: application/json
Auth: unknown
Method: GET
Last Status: 200
Latency: 576ms

Description

Returns the cards stored in a specific pile with their full details including code, value, suit, and image URLs. Use this to check what cards have been added to a pile.

From spec: Returns all cards currently in the specified pile

Usage Tips

- Creates the pile if it doesn't exist (returns empty) - Pile names are arbitrary strings defined by the client - Common use: tracking discarded cards or player hands

Parameters (2)

deck_id (string, path, required)

The deck ID

pile_name (string, path, required)

Name of the pile

Examples (1)

List all cards in the player1 pile probe-gate

Demonstrates listing cards that have been added to a named pile

curl 'https://deckofcardsapi.com/api/deck/wa025949x0ez/pile/player1/list/'
import requests

resp = requests.get("https://deckofcardsapi.com/api/deck/wa025949x0ez/pile/player1/list/")
data = resp.json()
import zingu_apis

api = zingu_apis.api("deckofcardsapi")
result = api.fetch("deck/{deck_id}/pile/{pile_name}/list/")

for item in result:
    print(item)
const resp = await fetch("https://deckofcardsapi.com/api/deck/wa025949x0ez/pile/player1/list/");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 00:59:39.165019 200 576ms
2026-04-15 03:33:44.785766 200 274ms
2026-04-14 01:18:55.854954 200 534ms
2026-04-12 16:15:29.982557 200 636ms
2026-04-10 00:36:07.197496 200 534ms
2026-04-09 03:25:12.114991 200 205ms