Deck of Cards

About Deck of Cards

Deck of Cards API is a web API for creating and manipulating standard 52-card decks programmatically. It supports creating new or shuffled decks (with an optional deck_count parameter for multi-deck use, and an optional jokers_enabled parameter to include jokers), drawing a specified number of cards, reshuffling remaining cards, and building partial decks from a specified list of card codes. Each deck is tracked by a deck_id, and decks are discarded if unused for two weeks.

The API also supports piles: named groupings of cards that can be created on the fly for purposes such as discards or player hands. Cards can be added to piles, listed, shuffled, drawn from the top, bottom, or at random, and returned to the main deck or between piles. Responses are returned in JSON and include card data such as code, value, suit, and image URLs (PNG and SVG) for each card, plus a back-of-card image endpoint.

This API is suited for developers building card game applications or simulations, such as blackjack or other games requiring deck and hand management, who need a backend to handle deck state, shuffling, and card draws without implementing that logic themselves.

Key features

• Shuffle and draw from single or multiple decks (deck_count parameter)
• Draw cards by count directly from a new or existing deck
• Reshuffle full or remaining cards in a deck
• Create partial decks with specific card codes
• Manage named piles for hands, discards, or other groupings with add, shuffle, list, and draw (top, bottom, or random)
• Return drawn cards or pile cards back to the main deck

Frequently asked questions