Skip to content
REST API

Get the flashcard review queue

GET
/sets/{setId}/review-queue

Returns the set's flashcards due now, decided by the server clock. New cards are limited to 50 per set per study day, which starts at 4am in the user's time zone. When nothing else is due, the queue includes the next learning card due within 20 minutes. Grade a card with POST /reviews, drop it from your local copy, and fetch the queue again when your copy runs out. When finished is true, fetch again at nextDueAt.

Required scopes: activity:view and sets:view

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

setId*string

Study set id, scoped to the key's user.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/sets/497f6eca-6276-4993-bfeb-53cbbbba6f08/review-queue"
{  "data": {    "cards": [      {        "cardId": "3e2d1c0b-9a8f-4e7d-8c6b-5a4f3e2d1c0b",        "termId": "2a1b0c9d-8e7f-4a6b-9c5d-4e3f2a1b0c9d",        "term": "tener (yo)",        "definition": "tuve",        "hints": [          "irregular stem tuv-"        ],        "imageUrl": null,        "queue": "review",        "due": "2026-01-15T09:30:00.000Z"      }    ],    "finished": false,    "nextDueAt": null,    "serverTime": "2026-02-01T12:00:00.000Z"  }}