Create a deckOpen a new deck of playing cards and get back its id, which every later step uses to draw from it, shuffle it and sort it into piles. Shuffled by default. Ask for several decks at once for a Blackjack shoe, add the two Jokers, or name just the cards you want for a partial deck. The service keeps the deck for two weeks after it was last used. No account or API key required.
Draw cardsDraw one or more cards off the top of a deck. Each card comes with its code, name, suit, rank, colour and a picture of its face, and the names come joined into one line ready for a message. Leave the deck id blank to open a fresh shuffled deck and draw from it in the same step. If the deck runs out the cards that were left are drawn and the shortfall is reported, so a game can decide what to do next. No account or API key required.
Shuffle a deckShuffle a deck you already have rather than opening a new one, keeping its id. By default every card goes back into the deck and the whole thing is shuffled. Choose to shuffle only the remaining cards and anything already drawn or sitting in a pile stays where it is. No account or API key required.
Add cards to a pilePut cards that have been drawn into a named pile - a player's hand, a discard pile, the dealer's up-cards. Name a pile that does not exist yet and it is created. Chain the codes from a draw, or type them. Cards can be moved from pile to pile the same way. Piles only work on a single deck. No account or API key required.
List the cards in a pileSee which cards a pile holds, in order, without moving any of them - what is in a player's hand, or what has been discarded so far. Comes back with every card's details, the codes as a list and the names as one line. Piles only work on a single deck. No account or API key required.
Shuffle a pileShuffle the cards in one pile, leaving the deck and every other pile as they are - the way to turn a discard pile back into a draw pile. Piles only work on a single deck. No account or API key required.
Draw cards from a pileTake cards out of a pile: some number off the top, off the bottom or at random, or the particular cards you name. The cards come back with their details and leave the pile, ready to be added to another one. If the pile has fewer cards than asked for, the ones it has are drawn and the shortfall is reported. Piles only work on a single deck. No account or API key required.
Return cards to the deckPut cards back into the deck so they can be drawn again: everything that has been drawn, the whole of one pile, or just the cards you name. The way to end a round without opening a new deck. No account or API key required.
Look up a cardTurn a card code such as 'AS' or '0H' into the card's name, suit, rank, colour and the addresses of its pictures, plus the picture of the back of a card for anything shown face down. Nothing is drawn and no deck is needed: this is for showing a card whose code you already have. No account or API key required.
