List cards due at asOf
Routine read. Returns prompts only. answerIncluded is always false. Each due card includes deckNote and cardNote. Coaching notes are instructions for how an agent should quiz and coach. They are not the answer, not graded content, and not the quiz prompt. A deck note applies to every card in that deck. A card note is optional and additive with the deck note. Retrieve responses (listDue, upcoming-new, inventory, getCard, reveal, and agent session start/next/grade) include deckNote and cardNote so one call carries coaching context. Scripture / dictation: The learner needs every word remembered correctly, but often answers via dictation where punctuation gets messy. They set a deck note instructing the agent to check every word exactly, but not fail on punctuation differences, and to include that reason when coaching. This is only an example — notes can be any coaching preference for how agents should quiz/coach for that deck (or a specific card). Call this at the start of a drill. Do not decide for yourself which cards are due. due is ordered learning, then review, then new. learning is a short step already underway, including a miss. new has never been reviewed. Drill in that order. Do not start a new card while a learning card is still listed. Retired cards are omitted. The new queue is capped at each deck's newCardsPerDay for the study day (the integer stored on the deck, or the account fallback only when that field is null). A new deck has no silent default of 20. Learning and review cards are not capped. newCards in the response reports remainingToday, waiting, dayStart, and nextDayStart. Do not pass newCardMode=extra unless the person asks to keep going. extra then adds up to extraNew new cards after the prescribed ones. Those reviews still count as introductions today. limit is the page size (default 10, max 25), not the daily cap.
Request
- Base URL: https://fluidrecall.com/api/v1
- URL: https://fluidrecall.com/api/v1/due
- Auth: one of:
- HTTP bearer
- HTTP dpop
Query parameters
UTC ISO-8601 timestamp ending in Z
Defaults to the server clock. Pass an explicit UTC instant for a deterministic queue.
daily, the default, stops the new queue at today's allowance. extra adds cards past that allowance. Do not send extra unless the person asks to keep going.
Required when newCardMode is extra. How many new cards to add past the daily allowance. Ignored, and rejected, when the mode is daily.
Response
Due prompts, ordered learning, then review, then prescribed new cards, then any requested extras.
Changes
No recorded changes to this operation across all 1 revision of this API.