Deck of Cards API

Base URL

https://deckofcardsapi.com/api/deck

Authentication

No key required.

Rate limit

No published limit.

Pricing

Free.

CORS

Enabled — callable directly from browser JavaScript

Official docs

Read the docs

Every request below was executed against the live API on 19 Aug 2026, and the response shown is the real body it returned — not an illustration.

curl 'https://deckofcardsapi.com/api/deck/new/shuffle/?deck_count=1'

const res = await fetch("https://deckofcardsapi.com/api/deck/new/shuffle/?deck_count=1");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get("https://deckofcardsapi.com/api/deck/new/shuffle/?deck_count=1", timeout=20)
res.raise_for_status()
print(res.json())

{
  "success": true,
  "deck_id": "xiyuflcig0a4",
  "remaining": 52,
  "shuffled": true
}

deck_idstring

Identifier used for all subsequent operations on this deck.

remaininginteger

Cards left undealt — the API tracks this for you.

shuffledboolean

Whether the deck has been shuffled.

cards[].codestring

Short card code such as AS for ace of spades.

cards[].imagestring

PNG image URL for the card face.

cards[].value / suitstring

Card value and suit as readable strings.

• Build blackjack, poker or solitaire with server-tracked deck state
• Create card-based teaching demos without implementing shuffling
• Manage player hands and discard piles using named piles
• Render real card images without sourcing your own artwork

If Deck of Cards does not fit, these game & anime apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.