Get deck
Retrieve a deck in a specified format. This endpoint is unauthenticated — no API key required.
This endpoint does not require an API key — it is unauthenticated so that Tabletop Simulator and similar tools can fetch decks directly without credential management.
Public decks are accessible directly. Private decks require a valid share token passed via the ?token= query parameter (tokens are valid for 24 hours).
Three formats are available: json (default) returns a structured deck object, text returns a plain-text export in the game's native format, and ga-tts returns enriched card data for Grand Archive Tabletop Simulator integration.
Note: if {deckId} is already a public deck, its content is returned directly regardless of any ?token= value passed — a mismatched or wrong token is never checked in that case. The generic 404 behavior described on the Private Deck Links and Share Tokens pages only applies when the target deck is itself private.
Path Parameters
Deck identifier (UUID v4).
uuidQuery Parameters
Response format.
json(default) — structured deck object asapplication/jsontext— rawtext/plain; format varies by game. Digimon, Gundam, and Chrono Core use{qty} {name} ({cardId})per line with optional// Zoneheaders; Grand Archive uses the Omnidex format with asideboardseparator line.ga-tts— Grand Archive only. Returns enriched card data grouped by zone (main,material,references,sideboard) with full card metadata and GA API image URLs for Tabletop Simulator consumption.
"json""json" | "text" | "ga-tts"Share token or private deck link for accessing private decks. Accepts either a share token (valid for 24 hours) or a pd_-prefixed private deck link (non-expiring, see Private Deck Links). Not required for public decks.
Response Body
curl -X GET "https://api.sleeved.gg/v1/decks/00000000-0000-4000-8000-000000000001?format=json&token="{
"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": "digi-egg"
}
],
"createdAt": "2025-08-20T14:00:00.000Z",
"updatedAt": "2025-09-03T11:45:00.000Z"
}
}{
"error": "Unknown format. Supported: json, text, ga-tts"
}{
"error": "Deck not found or not public"
}{
"error": "Rate limit exceeded"
}{
"error": "Internal server error"
}