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.
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 for accessing private decks. Tokens are valid for 24 hours. 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"
}