exam_overview
Exam overview
Use this when a student asks what an English exam contains, how a task type is scored, how long a section is, what the score scale is, or where to start preparing. Returns the exam sections with task types, question counts and time limits, the writing and speaking scoring criteria (writing with word limits), and links to ScoreFluent guides. Do not use this to score or mark a student's answer; it only describes the exam.
ParametersexamrequiredtaskType
practice_question
Practice question
Use this when a student wants a real practice question for an English exam task, for example "give me a PTE Write Essay prompt" or "a TOEFL listening question". Returns one random published question (prompt, passage, options, word limit, and an audio link for listening tasks) and a link where the student can answer it with the real timer and scoring. It never returns answers or model responses. Do not use it to check an answer; it only serves questions. For PTE Read Aloud or Describe Image, use speak_practice instead: it serves the question with a recorder so the student can answer and be scored in the chat.
ParametersexamtaskTyperequired
score_writing
Score writing
Use this when a student pastes an essay or summary for a PTE, IELTS, TOEFL, LanguageCert, MET or CELPIP writing task and wants a score. Returns marks out of the exam task maximum, a score and one line of feedback for each marking criterion, and the top improvements. Pass the questionId from practice_question when the text answers one of our questions; otherwise pass the prompt the student wrote to. Pass exactly one of the two. Free up to a daily limit. This is the quick score: Personalised Tips on the site add sentence-level annotations and verified marks. When the student is signed in to ScoreFluent and the text answers one of our questions, the scored attempt is saved to their History.
ParametersexamrequiredtextrequiredprompttaskTyperequiredquestionId
start_diagnostic
Start a diagnostic
Use when a student does not know which exam to take (diagnostic) or knows the exam and wants a starting baseline (placement). Returns a link to a free test on the site; do not try to run the test in chat.
Parametersexam
check_read_aloud
Check a Read Aloud transcript
Use when a student has read a Read Aloud passage aloud and you have the transcript of what they said (for example from voice mode) but no audio. Compares the words said against the passage: omitted, inserted and substituted words and a word-accuracy percentage. CONTENT ONLY — pronunciation, fluency and prosody need a recording: offer speak_practice or the answer link for those.
ParametersquestionIdrequiredtranscriptrequired
speak_practice
Speaking practice
Use whenever a student asks for a PTE Read Aloud or Describe Image to practise, even without mentioning recording or scores. Lets them practise the speaking task and get pronunciation and fluency scores. Shows a recorder card; desktop web only today. Do not use for scoring text.
ParametersexamtaskType
recorder_start
Start a recording
Reserve a recording slot and get an upload URL. Called by the speaking recorder card only.
ParametersmimeTyperequiredquestionIdrequireddeviceTokenrequired
recorder_confirm
Submit a recording
Confirm the upload and queue it for scoring. Called by the speaking recorder card only.
ParametersattemptIdrequireddeviceTokenrequired
recorder_result
Recording result
Read the scoring status and scores for a recording. Called by the speaking recorder card only.
ParametersattemptIdrequireddeviceTokenrequired