Skip to content

Exercise Types

The POST /exercises/evaluate endpoint supports 9 exercise types across 5 areas.

Areas

areaDescription
listeningListening comprehension
readingReading comprehension
writingFree writing
vocabularyVocabulary and contextual usage
grammarGrammar exercises

Any type can be combined with any area.

Types & Strategies

typecorrectAnswercontentStrategyScore
multiple_choiceRequired (string)NoCase-insensitive + trim0 or 10
fill_blankRequired (string or string[])NoLowercase + trim, multiple alternatives0 or 10
completeRequired (string or string[])NoSame as fill_blank0 or 10
open_answerOptional (string)NoLevenshtein >= 0.8 or minimum length0-10
drag_and_dropNoYesCorrect items / total0-10
matchNoYesCorrect pairs / total0-10
word_searchNoYesFound words / total0-10
crosswordNoYesCorrect answers / total, case-insensitive0-10
listening_multiple_choiceNo (in content)YesCorrect answers by question id / total0-10

Types requiring content return 400 if the field is missing.

By Type