Memojin
Log in

Study sessions and statistics

The study sessions of the account (status, space, cards seen and correct) and its statistics: mastered memocards, study time and success rate.

api.memojin.com/v1 · Contract 1.0.0-beta.2 · Beta

Sections · Sessions and statistics
On this page
  1. The StudySession object
  2. The LearningStats object
  3. List the study sessions
  4. Retrieve the learning statistics

The learning record of the account the key acts for, read-only: its review and practice sessions, with their counters, and its statistics (mastered memocards, study time, success rate over 30 days, completed sessions). No data of another account, students of a space included, is exposed.

The StudySession object

A study session (review or practice) of the account.

FieldTypeDescription
idalways presentstring (uuid)Study session identifier (UUID).
typealways presentstringKind of session: review, training, srs_daily, exam_preparation, exam_simulation… New values may appear.
statusalways presentstringplanned, in_progress, paused, completed or abandoned.
spaceIdalways presentstring | nullSpace of the session, or null.
startedAtalways presentstring (date-time) | nullStart instant, or null.
completedAtalways presentstring (date-time) | nullEnd instant, or null while not completed.
createdAtalways presentstring (date-time)Creation instant (ISO 8601, UTC).
cardsTotalalways presentintegerCards in the session.
cardsCompletedalways presentintegerCards answered.
cardsCorrectalways presentintegerCards answered correctly.
StudySession
{
  "id": "5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f",
  "type": "review",
  "status": "completed",
  "spaceId": null,
  "startedAt": "2026-10-03T18:00:00.000Z",
  "completedAt": "2026-10-03T18:14:00.000Z",
  "createdAt": "2026-10-03T17:59:00.000Z",
  "cardsTotal": 20,
  "cardsCompleted": 20,
  "cardsCorrect": 17
}

The LearningStats object

Learning statistics of the account the key acts for.

FieldTypeDescription
masteredMemocardsalways presentintegerMemocards the account has mastered.
studyTimeMinutesalways presentintegerTotal study time, in minutes (pauses excluded).
successRatealways presentnumberfrom 0 to 100Share of correct answers over the last 30 days, in percent (0 to 100).
sessionsCompletedalways presentintegerStudy sessions completed.
LearningStats
{
  "masteredMemocards": 148,
  "studyTimeMinutes": 1260,
  "successRate": 78,
  "sessionsCompleted": 64
}

List the study sessions

GET/v1/study-sessionsScope study-sessions:read

Review and practice sessions of the account the API key acts for, most recent first, with their counters, paginated.

Parameters

FieldInTypeDescription
statusoptionalquery"planned" | "in_progress" | "paused" | "completed" | "abandoned"Only the sessions in this status.
spaceIdoptionalquerystring (uuid)Only the sessions of this space.
limitoptionalqueryintegerfrom 1 to 100 · default 20Number of items per page, 1 to 100 (default 20).
cursoroptionalquerystringat most 200 charactersOpaque cursor: the nextCursor of the previous page. Keep the same limit from one page to the next.

Response 200

A page of study sessions — A page of StudySession { data, nextCursor, hasMore }

Errors

HTTPMeaning
400validation_error or invalid_cursor
401invalid_api_key or revoked_api_key
403insufficient_scope, account_suspended, live_not_enabled or forbidden
406not_acceptable — the Accept header excludes application/json
429rate_limited or test_quota_exceeded — see the Retry-After and RateLimit-* headers
500internal_error
503unavailable — see the Retry-After header
Request
curl "https://api.memojin.com/v1/study-sessions?limit=20" \
  -H "Authorization: Bearer $MEMOJIN_API_KEY"
Response 200
{
  "data": [
    {
      "id": "5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f",
      "type": "review",
      "status": "completed",
      "spaceId": null,
      "startedAt": "2026-10-03T18:00:00.000Z",
      "completedAt": "2026-10-03T18:14:00.000Z",
      "createdAt": "2026-10-03T17:59:00.000Z",
      "cardsTotal": 20,
      "cardsCompleted": 20,
      "cardsCorrect": 17
    }
  ],
  "nextCursor": null,
  "hasMore": false
}

Retrieve the learning statistics

GET/v1/learning-statsScope learning-stats:read

Mastered memocards, study time, success rate over 30 days and completed sessions of the account the API key acts for.

Response 200

The statistics — A LearningStats object

Errors

HTTPMeaning
401invalid_api_key or revoked_api_key
403insufficient_scope, account_suspended, live_not_enabled or forbidden
406not_acceptable — the Accept header excludes application/json
429rate_limited or test_quota_exceeded — see the Retry-After and RateLimit-* headers
500internal_error
503unavailable — see the Retry-After header
Request
curl "https://api.memojin.com/v1/learning-stats" \
  -H "Authorization: Bearer $MEMOJIN_API_KEY"
Response 200
{
  "masteredMemocards": 148,
  "studyTimeMinutes": 1260,
  "successRate": 78,
  "sessionsCompleted": 64
}