Get deck as JSON
Retrieve a deck with its full card list, zone assignments, and metadata as structured JSON.
Returns a deck with its full card list, zone assignments, and metadata. Public decks are accessible without a share token. Private decks require a valid share token passed as the token query parameter.
The API returns 404 for all failure cases — missing deck, private deck without a token, invalid token, and expired token. This prevents callers from inferring whether a given deck ID exists.
X-API-Key<token>
Your Sleeved API key. Format: slvd_live_<hex>. Contact Sleeved to obtain a key.
In: header
Path Parameters
deckIdstring
Deck identifier.
Query Parameters
token?string
Share token for private decks. Tokens are valid for 24 hours.
Response Body
curl -X GET "https://api.sleeved.gg/api/v1/decks/string?token=string"{
"data": {
"id": "deck_abc123",
"name": "Red Blitz Aggro",
"gameId": "digimon",
"ownerDisplayName": "CardShark99",
"cards": [
{
"cardId": "BT1-010",
"quantity": 4,
"zoneId": "main"
},
{
"cardId": "BT1-018",
"quantity": 3,
"zoneId": "main"
},
{
"cardId": "BT1-025",
"quantity": 2,
"zoneId": "main"
},
{
"cardId": "BT1-086",
"quantity": 4,
"zoneId": "egg"
}
],
"createdAt": "2025-08-20T14:00:00.000Z",
"updatedAt": "2025-09-03T11:45:00.000Z"
}
}{
"error": "API key required"
}{
"error": "Deck not found or not public"
}{
"error": "Rate limit exceeded"
}{
"error": "Internal server error"
}