---
title: "List decks"
method: GET
path: "/decks"
---

# List decks

`GET /decks`

## Request

- Base URL: `https://fluidrecall.com/api/v1`
- URL: `https://fluidrecall.com/api/v1/decks`
- Auth: one of:
  - HTTP bearer
  - HTTP dpop

Routine read. Returns deck names, card counts, newCardsPerDay (null only when the deck still inherits the account fallback), effectiveNewCardsPerDay (the number the daily queue uses), and archivedAt (null while the deck is drilled). Archived decks are omitted unless includeArchived=true. Never prompts or answers. Call this when you need to pick a deck id.

## Query parameters

- `includeArchived` boolean

## Response `200`

Decks for this token.

- object
  - `decks` object[], required

## Other responses

- `401`: Missing or wrong token.

---

[API](https://skmtc.dev/fluidrecall/apis/fluid-recall.md) · [All operations](https://skmtc.dev/fluidrecall/apis/fluid-recall/llms.txt) · [OpenAPI document](https://skmtc.dev/fluidrecall/apis/fluid-recall/revisions/7bf2563c3d2a?raw)