Card Deck Shuffler API
OnlineCredit Usage:1 per callRefreshed 1 month ago
avg: 134ms|p50: 129ms|p75: 137ms|p90: 147ms|p99: 166ms
Overview
To use Card Deck Shuffler, you need an API key. You can get one by creating a free account and visiting your dashboard.
GET Endpoint
URL
https://api.apiverve.com/v1/carddeckshufflerExample
How to call the Card Deck Shuffler API in different programming languages.
cURL Request
curl -X GET \
"https://api.apiverve.com/v1/carddeckshuffler?decks=1&jokers=false&method=fisher-yates" \
-H "X-API-Key: your_api_key_here"JavaScript (Fetch API)
const response = await fetch('https://api.apiverve.com/v1/carddeckshuffler?decks=1&jokers=false&method=fisher-yates', {
method: 'GET',
headers: {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);Python (Requests)
import requests
headers = {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
response = requests.get('https://api.apiverve.com/v1/carddeckshuffler?decks=1&jokers=false&method=fisher-yates', headers=headers)
data = response.json()
print(data)Go (net/http)
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/carddeckshuffler?decks=1&jokers=false&method=fisher-yates", nil)
req.Header.Set("X-API-Key", "your_api_key_here")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}Example Response
{
"status": "ok",
"error": null,
"data": {
"total_cards": 52,
"decks_used": 1,
"includes_jokers": false,
"shuffle_method": "fisher-yates",
"cards": [
{
"rank": "8",
"suit": "Spades",
"card": "8 of Spades",
"short": "8â™ "
},
{
"rank": "2",
"suit": "Spades",
"card": "2 of Spades",
"short": "2â™ "
},
{
"rank": "Queen",
"suit": "Hearts",
"card": "Queen of Hearts",
"short": "Q♥"
},
{
"rank": "7",
"suit": "Clubs",
"card": "7 of Clubs",
"short": "7♣"
},
{
"rank": "Queen",
"suit": "Spades",
"card": "Queen of Spades",
"short": "Qâ™ "
},
{
"rank": "King",
"suit": "Hearts",
"card": "King of Hearts",
"short": "K♥"
},
{
"rank": "6",
"suit": "Spades",
"card": "6 of Spades",
"short": "6â™ "
},
{
"rank": "Queen",
"suit": "Diamonds",
"card": "Queen of Diamonds",
"short": "Q♦"
},
{
"rank": "King",
"suit": "Diamonds",
"card": "King of Diamonds",
"short": "K♦"
},
{
"rank": "4",
"suit": "Hearts",
"card": "4 of Hearts",
"short": "4♥"
},
{
"rank": "7",
"suit": "Hearts",
"card": "7 of Hearts",
"short": "7♥"
},
{
"rank": "8",
"suit": "Clubs",
"card": "8 of Clubs",
"short": "8♣"
},
{
"rank": "4",
"suit": "Spades",
"card": "4 of Spades",
"short": "4â™ "
},
{
"rank": "9",
"suit": "Hearts",
"card": "9 of Hearts",
"short": "9♥"
},
{
"rank": "Ace",
"suit": "Diamonds",
"card": "Ace of Diamonds",
"short": "A♦"
},
{
"rank": "Jack",
"suit": "Diamonds",
"card": "Jack of Diamonds",
"short": "J♦"
},
{
"rank": "Jack",
"suit": "Hearts",
"card": "Jack of Hearts",
"short": "J♥"
},
{
"rank": "2",
"suit": "Clubs",
"card": "2 of Clubs",
"short": "2♣"
},
{
"rank": "Jack",
"suit": "Clubs",
"card": "Jack of Clubs",
"short": "J♣"
},
{
"rank": "Queen",
"suit": "Clubs",
"card": "Queen of Clubs",
"short": "Q♣"
},
{
"rank": "9",
"suit": "Spades",
"card": "9 of Spades",
"short": "9â™ "
},
{
"rank": "8",
"suit": "Diamonds",
"card": "8 of Diamonds",
"short": "8♦"
},
{
"rank": "10",
"suit": "Spades",
"card": "10 of Spades",
"short": "10â™ "
},
{
"rank": "9",
"suit": "Clubs",
"card": "9 of Clubs",
"short": "9♣"
},
{
"rank": "4",
"suit": "Clubs",
"card": "4 of Clubs",
"short": "4♣"
},
{
"rank": "Ace",
"suit": "Clubs",
"card": "Ace of Clubs",
"short": "A♣"
},
{
"rank": "7",
"suit": "Diamonds",
"card": "7 of Diamonds",
"short": "7♦"
},
{
"rank": "7",
"suit": "Spades",
"card": "7 of Spades",
"short": "7â™ "
},
{
"rank": "5",
"suit": "Diamonds",
"card": "5 of Diamonds",
"short": "5♦"
},
{
"rank": "10",
"suit": "Clubs",
"card": "10 of Clubs",
"short": "10♣"
},
{
"rank": "10",
"suit": "Diamonds",
"card": "10 of Diamonds",
"short": "10♦"
},
{
"rank": "6",
"suit": "Hearts",
"card": "6 of Hearts",
"short": "6♥"
},
{
"rank": "King",
"suit": "Spades",
"card": "King of Spades",
"short": "Kâ™ "
},
{
"rank": "Jack",
"suit": "Spades",
"card": "Jack of Spades",
"short": "Jâ™ "
},
{
"rank": "Ace",
"suit": "Hearts",
"card": "Ace of Hearts",
"short": "A♥"
},
{
"rank": "5",
"suit": "Hearts",
"card": "5 of Hearts",
"short": "5♥"
},
{
"rank": "King",
"suit": "Clubs",
"card": "King of Clubs",
"short": "K♣"
},
{
"rank": "10",
"suit": "Hearts",
"card": "10 of Hearts",
"short": "10♥"
},
{
"rank": "2",
"suit": "Diamonds",
"card": "2 of Diamonds",
"short": "2♦"
},
{
"rank": "Ace",
"suit": "Spades",
"card": "Ace of Spades",
"short": "Aâ™ "
},
{
"rank": "3",
"suit": "Clubs",
"card": "3 of Clubs",
"short": "3♣"
},
{
"rank": "5",
"suit": "Clubs",
"card": "5 of Clubs",
"short": "5♣"
},
{
"rank": "8",
"suit": "Hearts",
"card": "8 of Hearts",
"short": "8♥"
},
{
"rank": "3",
"suit": "Spades",
"card": "3 of Spades",
"short": "3â™ "
},
{
"rank": "6",
"suit": "Clubs",
"card": "6 of Clubs",
"short": "6♣"
},
{
"rank": "4",
"suit": "Diamonds",
"card": "4 of Diamonds",
"short": "4♦"
},
{
"rank": "2",
"suit": "Hearts",
"card": "2 of Hearts",
"short": "2♥"
},
{
"rank": "3",
"suit": "Diamonds",
"card": "3 of Diamonds",
"short": "3♦"
},
{
"rank": "9",
"suit": "Diamonds",
"card": "9 of Diamonds",
"short": "9♦"
},
{
"rank": "5",
"suit": "Spades",
"card": "5 of Spades",
"short": "5â™ "
},
{
"rank": "3",
"suit": "Hearts",
"card": "3 of Hearts",
"short": "3♥"
},
{
"rank": "6",
"suit": "Diamonds",
"card": "6 of Diamonds",
"short": "6♦"
}
],
"top_card": {
"rank": "8",
"suit": "Spades",
"card": "8 of Spades",
"short": "8â™ "
},
"bottom_card": {
"rank": "6",
"suit": "Diamonds",
"card": "6 of Diamonds",
"short": "6♦"
},
"sample_hand": [
{
"rank": "8",
"suit": "Spades",
"card": "8 of Spades",
"short": "8â™ "
},
{
"rank": "2",
"suit": "Spades",
"card": "2 of Spades",
"short": "2â™ "
},
{
"rank": "Queen",
"suit": "Hearts",
"card": "Queen of Hearts",
"short": "Q♥"
},
{
"rank": "7",
"suit": "Clubs",
"card": "7 of Clubs",
"short": "7♣"
},
{
"rank": "Queen",
"suit": "Spades",
"card": "Queen of Spades",
"short": "Qâ™ "
}
]
}
}Authentication
The Card Deck Shuffler API requires authentication via API key. Include your API key in the request header:
Required Header
X-API-Key: your_api_key_hereInteractive API Playground
Test the Card Deck Shuffler API directly in your browser with live requests and responses.
Try Card Deck Shuffler APIView details and test in the API marketplace
Parameters
The following parameters are available for the Card Deck Shuffler API:
Shuffle Card Deck
| Parameter | Type | Required | Description | Default | Example |
|---|---|---|---|---|---|
decks | integer | optional | Number of decks to shuffle Range: 1 - 10 | ||
jokers | boolean | optional | Include jokers in the deck | - | - |
method | string | optional | Shuffling method Supported values: fisher-yatesriffle |
Response
The Card Deck Shuffler API returns responses in JSON, XML, YAML, and CSV formats. The JSON response is shown in the Example section above; alternative formats below.
Other Response Formats
XML Response
200 OK
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>ok</status>
<error xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<data>
<total_cards>52</total_cards>
<decks_used>1</decks_used>
<includes_jokers>false</includes_jokers>
<shuffle_method>fisher-yates</shuffle_method>
<cards>
<card>
<rank>8</rank>
<suit>Spades</suit>
<card>8 of Spades</card>
<short>8â™ </short>
</card>
<card>
<rank>2</rank>
<suit>Spades</suit>
<card>2 of Spades</card>
<short>2â™ </short>
</card>
<card>
<rank>Queen</rank>
<suit>Hearts</suit>
<card>Queen of Hearts</card>
<short>Q♥</short>
</card>
<card>
<rank>7</rank>
<suit>Clubs</suit>
<card>7 of Clubs</card>
<short>7♣</short>
</card>
<card>
<rank>Queen</rank>
<suit>Spades</suit>
<card>Queen of Spades</card>
<short>Qâ™ </short>
</card>
<card>
<rank>King</rank>
<suit>Hearts</suit>
<card>King of Hearts</card>
<short>K♥</short>
</card>
<card>
<rank>6</rank>
<suit>Spades</suit>
<card>6 of Spades</card>
<short>6â™ </short>
</card>
<card>
<rank>Queen</rank>
<suit>Diamonds</suit>
<card>Queen of Diamonds</card>
<short>Q♦</short>
</card>
<card>
<rank>King</rank>
<suit>Diamonds</suit>
<card>King of Diamonds</card>
<short>K♦</short>
</card>
<card>
<rank>4</rank>
<suit>Hearts</suit>
<card>4 of Hearts</card>
<short>4♥</short>
</card>
<card>
<rank>7</rank>
<suit>Hearts</suit>
<card>7 of Hearts</card>
<short>7♥</short>
</card>
<card>
<rank>8</rank>
<suit>Clubs</suit>
<card>8 of Clubs</card>
<short>8♣</short>
</card>
<card>
<rank>4</rank>
<suit>Spades</suit>
<card>4 of Spades</card>
<short>4â™ </short>
</card>
<card>
<rank>9</rank>
<suit>Hearts</suit>
<card>9 of Hearts</card>
<short>9♥</short>
</card>
<card>
<rank>Ace</rank>
<suit>Diamonds</suit>
<card>Ace of Diamonds</card>
<short>A♦</short>
</card>
<card>
<rank>Jack</rank>
<suit>Diamonds</suit>
<card>Jack of Diamonds</card>
<short>J♦</short>
</card>
<card>
<rank>Jack</rank>
<suit>Hearts</suit>
<card>Jack of Hearts</card>
<short>J♥</short>
</card>
<card>
<rank>2</rank>
<suit>Clubs</suit>
<card>2 of Clubs</card>
<short>2♣</short>
</card>
<card>
<rank>Jack</rank>
<suit>Clubs</suit>
<card>Jack of Clubs</card>
<short>J♣</short>
</card>
<card>
<rank>Queen</rank>
<suit>Clubs</suit>
<card>Queen of Clubs</card>
<short>Q♣</short>
</card>
<card>
<rank>9</rank>
<suit>Spades</suit>
<card>9 of Spades</card>
<short>9â™ </short>
</card>
<card>
<rank>8</rank>
<suit>Diamonds</suit>
<card>8 of Diamonds</card>
<short>8♦</short>
</card>
<card>
<rank>10</rank>
<suit>Spades</suit>
<card>10 of Spades</card>
<short>10â™ </short>
</card>
<card>
<rank>9</rank>
<suit>Clubs</suit>
<card>9 of Clubs</card>
<short>9♣</short>
</card>
<card>
<rank>4</rank>
<suit>Clubs</suit>
<card>4 of Clubs</card>
<short>4♣</short>
</card>
<card>
<rank>Ace</rank>
<suit>Clubs</suit>
<card>Ace of Clubs</card>
<short>A♣</short>
</card>
<card>
<rank>7</rank>
<suit>Diamonds</suit>
<card>7 of Diamonds</card>
<short>7♦</short>
</card>
<card>
<rank>7</rank>
<suit>Spades</suit>
<card>7 of Spades</card>
<short>7â™ </short>
</card>
<card>
<rank>5</rank>
<suit>Diamonds</suit>
<card>5 of Diamonds</card>
<short>5♦</short>
</card>
<card>
<rank>10</rank>
<suit>Clubs</suit>
<card>10 of Clubs</card>
<short>10♣</short>
</card>
<card>
<rank>10</rank>
<suit>Diamonds</suit>
<card>10 of Diamonds</card>
<short>10♦</short>
</card>
<card>
<rank>6</rank>
<suit>Hearts</suit>
<card>6 of Hearts</card>
<short>6♥</short>
</card>
<card>
<rank>King</rank>
<suit>Spades</suit>
<card>King of Spades</card>
<short>Kâ™ </short>
</card>
<card>
<rank>Jack</rank>
<suit>Spades</suit>
<card>Jack of Spades</card>
<short>Jâ™ </short>
</card>
<card>
<rank>Ace</rank>
<suit>Hearts</suit>
<card>Ace of Hearts</card>
<short>A♥</short>
</card>
<card>
<rank>5</rank>
<suit>Hearts</suit>
<card>5 of Hearts</card>
<short>5♥</short>
</card>
<card>
<rank>King</rank>
<suit>Clubs</suit>
<card>King of Clubs</card>
<short>K♣</short>
</card>
<card>
<rank>10</rank>
<suit>Hearts</suit>
<card>10 of Hearts</card>
<short>10♥</short>
</card>
<card>
<rank>2</rank>
<suit>Diamonds</suit>
<card>2 of Diamonds</card>
<short>2♦</short>
</card>
<card>
<rank>Ace</rank>
<suit>Spades</suit>
<card>Ace of Spades</card>
<short>Aâ™ </short>
</card>
<card>
<rank>3</rank>
<suit>Clubs</suit>
<card>3 of Clubs</card>
<short>3♣</short>
</card>
<card>
<rank>5</rank>
<suit>Clubs</suit>
<card>5 of Clubs</card>
<short>5♣</short>
</card>
<card>
<rank>8</rank>
<suit>Hearts</suit>
<card>8 of Hearts</card>
<short>8♥</short>
</card>
<card>
<rank>3</rank>
<suit>Spades</suit>
<card>3 of Spades</card>
<short>3â™ </short>
</card>
<card>
<rank>6</rank>
<suit>Clubs</suit>
<card>6 of Clubs</card>
<short>6♣</short>
</card>
<card>
<rank>4</rank>
<suit>Diamonds</suit>
<card>4 of Diamonds</card>
<short>4♦</short>
</card>
<card>
<rank>2</rank>
<suit>Hearts</suit>
<card>2 of Hearts</card>
<short>2♥</short>
</card>
<card>
<rank>3</rank>
<suit>Diamonds</suit>
<card>3 of Diamonds</card>
<short>3♦</short>
</card>
<card>
<rank>9</rank>
<suit>Diamonds</suit>
<card>9 of Diamonds</card>
<short>9♦</short>
</card>
<card>
<rank>5</rank>
<suit>Spades</suit>
<card>5 of Spades</card>
<short>5â™ </short>
</card>
<card>
<rank>3</rank>
<suit>Hearts</suit>
<card>3 of Hearts</card>
<short>3♥</short>
</card>
<card>
<rank>6</rank>
<suit>Diamonds</suit>
<card>6 of Diamonds</card>
<short>6♦</short>
</card>
</cards>
<top_card>
<rank>8</rank>
<suit>Spades</suit>
<card>8 of Spades</card>
<short>8â™ </short>
</top_card>
<bottom_card>
<rank>6</rank>
<suit>Diamonds</suit>
<card>6 of Diamonds</card>
<short>6♦</short>
</bottom_card>
<sample_hand>
<item>
<rank>8</rank>
<suit>Spades</suit>
<card>8 of Spades</card>
<short>8â™ </short>
</item>
<item>
<rank>2</rank>
<suit>Spades</suit>
<card>2 of Spades</card>
<short>2â™ </short>
</item>
<item>
<rank>Queen</rank>
<suit>Hearts</suit>
<card>Queen of Hearts</card>
<short>Q♥</short>
</item>
<item>
<rank>7</rank>
<suit>Clubs</suit>
<card>7 of Clubs</card>
<short>7♣</short>
</item>
<item>
<rank>Queen</rank>
<suit>Spades</suit>
<card>Queen of Spades</card>
<short>Qâ™ </short>
</item>
</sample_hand>
</data>
</response>
YAML Response
200 OK
status: ok
error: null
data:
total_cards: 52
decks_used: 1
includes_jokers: false
shuffle_method: fisher-yates
cards:
- rank: '8'
suit: Spades
card: 8 of Spades
short: 8â™
- rank: '2'
suit: Spades
card: 2 of Spades
short: 2â™
- rank: Queen
suit: Hearts
card: Queen of Hearts
short: Q♥
- rank: '7'
suit: Clubs
card: 7 of Clubs
short: 7♣
- rank: Queen
suit: Spades
card: Queen of Spades
short: Qâ™
- rank: King
suit: Hearts
card: King of Hearts
short: K♥
- rank: '6'
suit: Spades
card: 6 of Spades
short: 6â™
- rank: Queen
suit: Diamonds
card: Queen of Diamonds
short: Q♦
- rank: King
suit: Diamonds
card: King of Diamonds
short: K♦
- rank: '4'
suit: Hearts
card: 4 of Hearts
short: 4♥
- rank: '7'
suit: Hearts
card: 7 of Hearts
short: 7♥
- rank: '8'
suit: Clubs
card: 8 of Clubs
short: 8♣
- rank: '4'
suit: Spades
card: 4 of Spades
short: 4â™
- rank: '9'
suit: Hearts
card: 9 of Hearts
short: 9♥
- rank: Ace
suit: Diamonds
card: Ace of Diamonds
short: A♦
- rank: Jack
suit: Diamonds
card: Jack of Diamonds
short: J♦
- rank: Jack
suit: Hearts
card: Jack of Hearts
short: J♥
- rank: '2'
suit: Clubs
card: 2 of Clubs
short: 2♣
- rank: Jack
suit: Clubs
card: Jack of Clubs
short: J♣
- rank: Queen
suit: Clubs
card: Queen of Clubs
short: Q♣
- rank: '9'
suit: Spades
card: 9 of Spades
short: 9â™
- rank: '8'
suit: Diamonds
card: 8 of Diamonds
short: 8♦
- rank: '10'
suit: Spades
card: 10 of Spades
short: 10â™
- rank: '9'
suit: Clubs
card: 9 of Clubs
short: 9♣
- rank: '4'
suit: Clubs
card: 4 of Clubs
short: 4♣
- rank: Ace
suit: Clubs
card: Ace of Clubs
short: A♣
- rank: '7'
suit: Diamonds
card: 7 of Diamonds
short: 7♦
- rank: '7'
suit: Spades
card: 7 of Spades
short: 7â™
- rank: '5'
suit: Diamonds
card: 5 of Diamonds
short: 5♦
- rank: '10'
suit: Clubs
card: 10 of Clubs
short: 10♣
- rank: '10'
suit: Diamonds
card: 10 of Diamonds
short: 10♦
- rank: '6'
suit: Hearts
card: 6 of Hearts
short: 6♥
- rank: King
suit: Spades
card: King of Spades
short: Kâ™
- rank: Jack
suit: Spades
card: Jack of Spades
short: Jâ™
- rank: Ace
suit: Hearts
card: Ace of Hearts
short: A♥
- rank: '5'
suit: Hearts
card: 5 of Hearts
short: 5♥
- rank: King
suit: Clubs
card: King of Clubs
short: K♣
- rank: '10'
suit: Hearts
card: 10 of Hearts
short: 10♥
- rank: '2'
suit: Diamonds
card: 2 of Diamonds
short: 2♦
- rank: Ace
suit: Spades
card: Ace of Spades
short: Aâ™
- rank: '3'
suit: Clubs
card: 3 of Clubs
short: 3♣
- rank: '5'
suit: Clubs
card: 5 of Clubs
short: 5♣
- rank: '8'
suit: Hearts
card: 8 of Hearts
short: 8♥
- rank: '3'
suit: Spades
card: 3 of Spades
short: 3â™
- rank: '6'
suit: Clubs
card: 6 of Clubs
short: 6♣
- rank: '4'
suit: Diamonds
card: 4 of Diamonds
short: 4♦
- rank: '2'
suit: Hearts
card: 2 of Hearts
short: 2♥
- rank: '3'
suit: Diamonds
card: 3 of Diamonds
short: 3♦
- rank: '9'
suit: Diamonds
card: 9 of Diamonds
short: 9♦
- rank: '5'
suit: Spades
card: 5 of Spades
short: 5â™
- rank: '3'
suit: Hearts
card: 3 of Hearts
short: 3♥
- rank: '6'
suit: Diamonds
card: 6 of Diamonds
short: 6♦
top_card:
rank: '8'
suit: Spades
card: 8 of Spades
short: 8â™
bottom_card:
rank: '6'
suit: Diamonds
card: 6 of Diamonds
short: 6♦
sample_hand:
- rank: '8'
suit: Spades
card: 8 of Spades
short: 8â™
- rank: '2'
suit: Spades
card: 2 of Spades
short: 2â™
- rank: Queen
suit: Hearts
card: Queen of Hearts
short: Q♥
- rank: '7'
suit: Clubs
card: 7 of Clubs
short: 7♣
- rank: Queen
suit: Spades
card: Queen of Spades
short: Qâ™
CSV Response
200 OK
| key | value |
|---|---|
| total_cards | 52 |
| decks_used | 1 |
| includes_jokers | false |
| shuffle_method | fisher-yates |
| cards | [{rank:8,suit:Spades,card:8 of Spades,short:8♠},{rank:2,suit:Spades,card:2 of Spades,short:2♠},{rank:Queen,suit:Hearts,card:Queen of Hearts,short:Q♥},{rank:7,suit:Clubs,card:7 of Clubs,short:7♣},{rank:Queen,suit:Spades,card:Queen of Spades,short:Q♠},{rank:King,suit:Hearts,card:King of Hearts,short:K♥},{rank:6,suit:Spades,card:6 of Spades,short:6♠},{rank:Queen,suit:Diamonds,card:Queen of Diamonds,short:Q♦},{rank:King,suit:Diamonds,card:King of Diamonds,short:K♦},{rank:4,suit:Hearts,card:4 of Hearts,short:4♥},{rank:7,suit:Hearts,card:7 of Hearts,short:7♥},{rank:8,suit:Clubs,card:8 of Clubs,short:8♣},{rank:4,suit:Spades,card:4 of Spades,short:4♠},{rank:9,suit:Hearts,card:9 of Hearts,short:9♥},{rank:Ace,suit:Diamonds,card:Ace of Diamonds,short:A♦},{rank:Jack,suit:Diamonds,card:Jack of Diamonds,short:J♦},{rank:Jack,suit:Hearts,card:Jack of Hearts,short:J♥},{rank:2,suit:Clubs,card:2 of Clubs,short:2♣},{rank:Jack,suit:Clubs,card:Jack of Clubs,short:J♣},{rank:Queen,suit:Clubs,card:Queen of Clubs,short:Q♣},{rank:9,suit:Spades,card:9 of Spades,short:9♠},{rank:8,suit:Diamonds,card:8 of Diamonds,short:8♦},{rank:10,suit:Spades,card:10 of Spades,short:10♠},{rank:9,suit:Clubs,card:9 of Clubs,short:9♣},{rank:4,suit:Clubs,card:4 of Clubs,short:4♣},{rank:Ace,suit:Clubs,card:Ace of Clubs,short:A♣},{rank:7,suit:Diamonds,card:7 of Diamonds,short:7♦},{rank:7,suit:Spades,card:7 of Spades,short:7♠},{rank:5,suit:Diamonds,card:5 of Diamonds,short:5♦},{rank:10,suit:Clubs,card:10 of Clubs,short:10♣},{rank:10,suit:Diamonds,card:10 of Diamonds,short:10♦},{rank:6,suit:Hearts,card:6 of Hearts,short:6♥},{rank:King,suit:Spades,card:King of Spades,short:K♠},{rank:Jack,suit:Spades,card:Jack of Spades,short:J♠},{rank:Ace,suit:Hearts,card:Ace of Hearts,short:A♥},{rank:5,suit:Hearts,card:5 of Hearts,short:5♥},{rank:King,suit:Clubs,card:King of Clubs,short:K♣},{rank:10,suit:Hearts,card:10 of Hearts,short:10♥},{rank:2,suit:Diamonds,card:2 of Diamonds,short:2♦},{rank:Ace,suit:Spades,card:Ace of Spades,short:A♠},{rank:3,suit:Clubs,card:3 of Clubs,short:3♣},{rank:5,suit:Clubs,card:5 of Clubs,short:5♣},{rank:8,suit:Hearts,card:8 of Hearts,short:8♥},{rank:3,suit:Spades,card:3 of Spades,short:3♠},{rank:6,suit:Clubs,card:6 of Clubs,short:6♣},{rank:4,suit:Diamonds,card:4 of Diamonds,short:4♦},{rank:2,suit:Hearts,card:2 of Hearts,short:2♥},{rank:3,suit:Diamonds,card:3 of Diamonds,short:3♦},{rank:9,suit:Diamonds,card:9 of Diamonds,short:9♦},{rank:5,suit:Spades,card:5 of Spades,short:5♠},{rank:3,suit:Hearts,card:3 of Hearts,short:3♥},{rank:6,suit:Diamonds,card:6 of Diamonds,short:6♦}] |
| top_card | {rank:8,suit:Spades,card:8 of Spades,short:8â™ } |
| bottom_card | {rank:6,suit:Diamonds,card:6 of Diamonds,short:6♦} |
| sample_hand | [{rank:8,suit:Spades,card:8 of Spades,short:8♠},{rank:2,suit:Spades,card:2 of Spades,short:2♠},{rank:Queen,suit:Hearts,card:Queen of Hearts,short:Q♥},{rank:7,suit:Clubs,card:7 of Clubs,short:7♣},{rank:Queen,suit:Spades,card:Queen of Spades,short:Q♠}] |
Response Structure
All API responses follow a consistent structure with the following fields:
| Field | Type | Description | Example |
|---|---|---|---|
status | string | Indicates whether the request was successful ("ok") or failed ("error") | ok |
error | string | null | Contains error message if status is "error", otherwise null | null |
data | object | null | Contains the API response data if successful, otherwise null | {...} |
Learn more about response formats →
Response Data Fields
When the request is successful, the data object contains the following fields:
Response fields marked with Premium are available exclusively on paid plans.View pricing
| Field | Type | Sample Value | Description |
|---|---|---|---|
total_cards | number | Total number of cards in the shuffled deck | |
decks_used | number | Number of decks combined for this shuffle | |
includes_jokers | boolean | Whether jokers are included in this deck | |
shuffle_method | string | Shuffling algorithm used for randomization | |
| [ ] Array items: | array[52] | Complete shuffled deck with all card details | |
â”” rank | string | Card rank value like Ace, King, or number | |
â”” suit | string | Card suit: Spades, Hearts, Diamonds, or Clubs | |
â”” card | string | Full card name like King of Hearts | |
â”” short | string | Abbreviated card notation with suit symbols | |
top_card | object | First card in the shuffled deck sequence | |
â”” rank | string | Top card rank value | |
â”” suit | string | Top card suit | |
â”” card | string | Top card full name | |
â”” short | string | Top card abbreviated notation | |
bottom_cardPremium | object | Last card in the shuffled deck sequence | |
â”” rank | string | Bottom card rank value | |
â”” suit | string | Bottom card suit | |
â”” card | string | Bottom card full name | |
â”” short | string | Bottom card abbreviated notation | |
| [ ] Array items: | array[5] | First five cards as example hand from deck |
Headers
Only X-API-Key is required. Optional headers include Accept for response format negotiation (JSON, XML, or YAML), User-Agent, and X-Request-ID for request tracing. See all request headers →
GraphQL AccessALPHA
Access Card Deck Shuffler through GraphQL to combine it with other API calls in a single request. Query only the card deck shuffler data you need with precise field selection, and orchestrate complex data fetching workflows.
Test Card Deck Shuffler in the GraphQL Explorer to confirm availability and experiment with queries.
Credit Cost: Each API called in your GraphQL query consumes its standard credit cost.
GraphQL Endpoint
POST https://api.apiverve.com/v1/graphqlGraphQL Query Example
query {
carddeckshuffler(
input: {
decks: 1
jokers: "value"
method: "fisher-yates"
}
) {
total_cards
decks_used
includes_jokers
shuffle_method
cards
top_card {
rank
suit
card
short
}
bottom_card {
rank
suit
card
short
}
sample_hand
}
}Note: Authentication is handled via the x-api-key header in your GraphQL request, not as a query parameter.
CORS Support
The Card Deck Shuffler API accepts cross-origin requests from any origin, so it can be called directly from browser-based applications without a proxy. See CORS support →
Rate Limiting
Card Deck Shuffler requests are throttled per minute on the Free plan and unthrottled on paid plans. Exceeding the limit returns 429 Too Many Requests; rate-limit usage is reported in the X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset response headers. See per-plan limits and best practices →
Error Codes
The Card Deck Shuffler API uses standard HTTP status codes — 200 on success, 400 for invalid parameters, 401 for missing or invalid keys, 403 for insufficient credits, 429 for rate-limit exhaustion, and 500/503 for server-side issues. Each error response includes an X-Request-ID header you can quote when contacting support. See full error handling guide →
SDKs for Card Deck Shuffler
Official Card Deck Shuffler packages on npm, PyPI, NuGet, and JitPack — plus a Postman collection and an OpenAPI spec. See the SDK guide →
No-Code Integrations
Card Deck Shuffler works with Zapier, Make, Pipedream, n8n, and Power Automate using the same API key. See setup guides →
Frequently Asked Questions
How do I get an API key for Card Deck Shuffler?
Sign up for a free account at dashboard.apiverve.com. Your API key will be automatically generated and available in your dashboard. The same key works for Card Deck Shuffler and all other APIVerve APIs. The free plan includes 1,000 credits plus a 500 credit bonus.
How many credits does Card Deck Shuffler cost?
Each successful Card Deck Shuffler API call consumes credits based on plan tier. Check the pricing section above for the exact credit cost. Failed requests and errors don't consume credits, so you only pay for successful card deck shuffler lookups.
Can I use Card Deck Shuffler in production?
The free plan is for testing and development only. For production use of Card Deck Shuffler, upgrade to a paid plan (Starter, Pro, or Mega) which includes commercial use rights, no attribution requirements, and guaranteed uptime SLAs. All paid plans are production-ready.
Can I use Card Deck Shuffler from a browser?
Yes! The Card Deck Shuffler API supports CORS with wildcard configuration, so you can call it directly from browser-based JavaScript without needing a proxy server. See the CORS section above for details.
What happens if I exceed my Card Deck Shuffler credit limit?
When you reach your monthly credit limit, Card Deck Shuffler API requests will return an error until you upgrade your plan or wait for the next billing cycle. You'll receive notifications at 80% and 95% usage to give you time to upgrade if needed.
People who used this also used...
Based on your interest in Card Deck Shuffler, you might also like these APIs:
