---
title: "List the user's flashcard decks; with updated_since, changes and tombstones since then"
method: GET
path: "/revise/decks"
tags: ["revise"]
---

# List the user's flashcard decks; with updated_since, changes and tombstones since then

`GET /revise/decks`

## Request

- Base URL: `https://api.focusbear.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.focusbear.io/revise/decks`
- Auth: HTTP bearer

## Query parameters

- `updated_since` string

## Response `200`

- ReviseDeckListResponseDto
  - `items` ReviseDeckResponseDto[], required
    - `id` string, required
    - `name` string, required
    - `note_id` string, nullable, required
    - `project_id` string, nullable, required
    - `card_count` number, required: Live cards in the deck
    - `due_count` number, required: Live cards due for review now, plus imported cards never reviewed
    - `created_at` string, required
    - `updated_at` string, required
    - `deleted_at` string, nullable, required
  - `server_time` string, required: Use as the next updated_since watermark (minus a safety overlap)

---

[API](https://skmtc.dev/focusbear/apis/focusbear-api.md) - [All operations](https://skmtc.dev/focusbear/apis/focusbear-api/llms.txt) - [OpenAPI document](https://skmtc.dev/focusbear/apis/focusbear-api/revisions/3a83a3b9a811?raw)