SleevedSleeved Docs

List public decks

Paginate through a game's public decks with minimal per-deck summaries. Requires the decks:browse:public scope.

Requires the decks:browse:public API key scope — contact Sleeved to have it added to your key. Legacy keys do not receive this scope automatically.

Each result is a minimal summary (id, gameId, createdAt, updatedAt) with no deck name, owner identity, card contents, or engagement counters. Use POST /decks/details to fetch full contents for decks returned here.

Pass updatedSince to switch into incremental-sync mode: ordering flips to ascending so a delta crawl can walk forward through time from the last-seen updatedAt.

GET
/decks/public
X-API-Key<token>

Your Sleeved API key. Format: slvd_live_<hex>. Contact Sleeved to obtain a key.

In: header

Query Parameters

gameIdstring

Game slug to list public decks for. See the API overview for the current game allowlist.

limit?integer

Page size, clamped to the range 1–50.

Default20
Range1 <= value <= 50
startAfter?string

Opaque cursor from a previous page's nextCursor. Do not construct or parse this value — see the pagination contract.

sort?string

Sort field. updatedSince is only valid when sort=updatedAt (the default) — combining it with any other sort value returns 400.

Default"updatedAt"
Value in"updatedAt" | "copyCount" | "viewCount" | "likeCount" | "createdAt"
updatedSince?string

ISO 8601 timestamp. Returns only decks with updatedAt >= updatedSince (inclusive boundary) and flips ordering to ascending. Requires sort=updatedAt (default) — any other sort value combined with updatedSince returns 400.

Formatdate-time

Response Body

curl -X GET "https://api.sleeved.gg/v1/decks/public?gameId=chrono-core&limit=20&startAfter=string&sort=updatedAt&updatedSince=2026-06-01T00%3A00%3A00.000Z"
{
  "data": {
    "decks": [
      {
        "id": "00000000-0000-4000-8000-000000000001",
        "gameId": "chrono-core",
        "createdAt": "2026-05-10T12:00:00.000Z",
        "updatedAt": "2026-06-18T09:30:00.000Z"
      },
      {
        "id": "00000000-0000-4000-8000-000000000002",
        "gameId": "chrono-core",
        "createdAt": "2026-04-02T08:15:00.000Z",
        "updatedAt": "2026-06-15T17:45:00.000Z"
      }
    ],
    "nextCursor": "eyJ2IjoiMyIsImlkIjoiMDAwMDAwMDAtMDAwMC00MDAwLTgwMDAtMDAwMDAwMDAwMDAyIn0=",
    "hasMore": true,
    "totalCount": 137
  }
}

{
  "error": "gameId query parameter is required"
}

{
  "error": "API key required"
}

{
  "error": "Insufficient scope"
}
{
  "error": "Rate limit exceeded"
}
{
  "error": "Internal server error"
}