Card reviews

A card review is the event happening when a user reviews a card variant and gives a grade. Reviews are the raw history the spaced repetition algorithm learns from.

Card reviews are read-only in the API. They are created when you review cards in Recall.

Endpoints

GET   /v1/card_reviews       # List all card reviews
GET   /v1/card_reviews/:id   # Get a card review

The card review object

{
  "id": "review_8sK2mPqW3xYz",
  "object": "card_review",
  "card": "card_lBsPlNZe4356",
  "card_variant": "variant_pQ3nRb7KcxT2",
  "created_at": "2025-12-01T15:03:22Z",
  "grade": 3,
}
id string

Unique identifier for the card review.

object string, value is "card_review"

The type of the object.

card nullable stringExpandable

The ID of the card that was reviewed. When card is included in expand, this is a card object instead. Reviews are kept when cards are deleted: null if the card no longer exists.

card_variant nullable stringExpandable

The ID of the card variant that was reviewed. When card_variant is included in expand, this is a card variant object instead. null when the review can no longer be tied to a variant: its card or card layout was deleted, or the review predates card layouts in Recall.

created_at string

The date and time the review happened. RFC 3339–formatted UTC datetime.

grade enum

The grade given during the review, as an integer between 1 and 4.

1
Forgot.
2
Hard.
3
Good.
4
Easy.

List all card reviews

curl "https://api.recall.cards/v1/card_reviews?card=card_lBsPlNZe4356" \
  -u YOUR_API_KEY:

Returns card reviews ordered by created_at, newest first.

card string

Filter the reviews by the ID of the card that was reviewed.

card_variant string

Filter the reviews by the ID of the card variant that was reviewed.

deck string

Filter the reviews by the ID of the deck their card belongs to. Reviews of deleted cards belong to no deck and are not included.

limit optional, default is 10

The maximum number of card reviews to return, ranging between 1 and 100.

starting_after optional

A cursor to use in pagination. starting_after is a card review ID that defines your place in the list. For example, if you make a card review list request and receive 100 reviews, ending with review_2sdInOpM83eo, your subsequent call can include starting_after=review_2sdInOpM83eo to fetch the next page of the list.

ending_before optional

A cursor to use in pagination. Similarly to starting_after, ending_before is a card review ID that allows you to fetch card reviews in the previous page of the list.

Returns

{
  "object": "list",
  "has_more": true,
  "data": [
    // Card review objects, newest first
  ],
}
object string, value is "list"

The type of object returned.

data array

An array containing the card review objects, newest first.

has_more boolean

Whether or not there are more elements available after this set. If false, this set comprises the end of the list.

Get a card review

curl https://api.recall.cards/v1/card_reviews/review_8sK2mPqW3xYz \
  -u YOUR_API_KEY:

There are no parameters for this endpoint.

Returns

Returns the card review object.