---
title: "Page through cards; with updated_since, changes and tombstones since then"
method: GET
path: "/revise/cards"
tags: ["revise"]
---

# Page through cards; with updated_since, changes and tombstones since then

`GET /revise/cards`

## 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/cards`
- Auth: HTTP bearer

## Query parameters

- `updated_since` string
- `deck_id` string, uuid
- `cursor` string
- `limit` number

## Response `200`

- ReviseCardPageResponseDto
  - `items` ReviseCardResponseDto[], required
    - `id` string, required
    - `deck_id` string, nullable, required
    - `front` string, required
    - `back` string, required
    - `source_type` 'manual' | 'note' | 'pdf' | 'anki' | 'algoapp' | 'file', required
    - `source_note_id` string, nullable, required
    - `source_label` string, nullable, required
    - `created_by` 'user' | 'ai', required
    - `needs_rewrite` boolean, required
    - `rewrite_flagged_at` string, nullable, required
    - `rewrite_resolved_at` string, nullable, required
    - `state` 'learning' | 'review' | 'relearning', required
    - `step` number, nullable, required
    - `stability` number, nullable, required
    - `difficulty` number, nullable, required
    - `due_at` string, required
    - `last_reviewed_at` string, nullable, required
    - `first_reviewed_at` string, nullable, required
    - `review_count` number, required
    - `lapse_count` number, required
    - `is_new` boolean, required: Never reviewed
    - `preview_due_at` RevisePreviewDueAtDto, required
      - `no_idea` string, required
      - `again` string, required
      - `hard` string, required
      - `good` string, required
      - `easy` string, required
    - `created_at` string, required
    - `updated_at` string, required
    - `deleted_at` string, nullable, required
  - `next_cursor` string, nullable, required: Pass back as cursor; null on the last page
  - `server_time` string, required: Keep from the first page as the next updated_since watermark

---

[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)
