Answer feedback

Warm, specific feedback on up to 20 learners' own-words answers, without marks.

Price1 credit (10p) per answer
Typical time10 s to 2 min
Scopelearning:write
Runs asA background job

Try it

Run answer feedback in the sandbox

No key and nothing to pay. The sandbox returns a realistic example in a couple of seconds; no AI runs and no data is kept.

Queued202 and a job id, straight away
ProcessingPoll, stream or wait for a webhook
SucceededResult and files on the job

Every AI request runs as a background job, so nothing times out.

For each answer: a verdict (confident, nearly_there or keep_going), a short message and next_step, the key points covered (with the learner's exact words as evidence) and missing, any issues with a correction, an optional follow_up_question and a model_answer. Give expected answers or source_text to judge against your material; otherwise answers are judged against accepted knowledge of the topic. This is formative feedback: no marks are proposed and official_result is always false.

Requires learning:write. Costs 1 credit per answer. Send a unique Idempotency-Key; reuse it with the identical body when retrying. Returns 202 with a job: poll GET /jobs/{job_id}, stream GET /jobs/{job_id}/events, or use a signed webhook.

Answer feedback

POST/v1/answers/feedback

Scope learning:write

Headers

Answer feedback: headers
Field	Details
`Idempotency-Key`	stringRequiredA unique key per new operation; reuse it with the identical body when retrying.
`EduMark-Version`	enumAPI version. Defaults to the latest.One of `2026-10-21`

Request body

Answer feedback: request body
Field	Details
`items`	array of AnswerItemRequiredUp to 20 answers to check.1 to 20 items
`id`items[].id	string, optionalYour id for this answer, echoed back. Defaults to its position ("1", "2", …).Up to 100 charactersPattern `^[A-Za-z0-9_.:-]+$`
`question`items[].question	stringRequiredThe question the learner answered.Up to 4,000 characters
`answer`items[].answer	stringRequiredThe learner's answer, in their own words.Up to 12,000 characters
`expected`items[].expected	string, optionalA model answer or the points you expect. Feedback is then judged against it.Up to 6,000 characters
`topic`	string, optionalWhat the questions are about.Up to 200 characters
`source_text`	string, optionalTeaching text the answers should agree with (at most 10,000 words).Up to 120,000 characters
`standard`	enumHow strictly to judge. beginner: the main idea in everyday words is enough. intermediate: correct in substance. expert: accurate and precise, with the right terms.One of `beginner`, `intermediate`, `expert`Default `"intermediate"`
`language`	enumThe language to write feedback in.One of `English`, `Welsh`, `Irish`, `Gaelic`, `French`, `Spanish`, `German`, `Italian`, `Portuguese`, `Dutch`, `Polish`, `Arabic`, `Urdu`, `Hindi`, `Punjabi`, `Bengali`, `Chinese`, `Mandarin`, `Cantonese`, `Japanese`, `Korean`, `Russian`, `Turkish`, `Greek`, `Swedish`, `Norwegian`, `Danish`, `Finnish`, `Romanian`, `Hungarian`, `Czech`, `Ukrainian`, `Farsi`, `Persian`, `Hebrew`, `Swahili`, `Somali`, `Tamil`, `Gujarati`, `Vietnamese`, `Thai`, `Indonesian`, `Malay`, `Tagalog`, `Latin`Default `"English"`

Responses

Status	Meaning
202	Successful Response
400	Request rejected. Inspect error.code and request_id; failed work is not billed.
401	Request rejected. Inspect error.code and request_id; failed work is not billed.
402	Request rejected. Inspect error.code and request_id; failed work is not billed.
403	Request rejected. Inspect error.code and request_id; failed work is not billed.
404	Request rejected. Inspect error.code and request_id; failed work is not billed.
409	Request rejected. Inspect error.code and request_id; failed work is not billed.
410	Request rejected. Inspect error.code and request_id; failed work is not billed.
413	Request rejected. Inspect error.code and request_id; failed work is not billed.
415	Request rejected. Inspect error.code and request_id; failed work is not billed.
422	Validation Error
429	Request rejected. Inspect error.code and request_id; failed work is not billed.
503	Request rejected. Inspect error.code and request_id; failed work is not billed.

Request

curl -X POST 'https://api.edumark.ai/v1/answers/feedback' \
  -H "Authorization: Bearer $EDUMARK_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "topic": "Photosynthesis",
  "standard": "intermediate",
  "items": [
    {
      "id": "a1",
      "question": "What is photosynthesis?",
      "answer": "Plants use light to make food."
    }
  ]
}'

# Then poll until the job finishes (wait poll_after_seconds between calls)
curl 'https://api.edumark.ai/v1/jobs/job_01JB7Q8M4X2V9R' \
  -H "Authorization: Bearer $EDUMARK_API_KEY"

Queued202 and a job id, straight away
ProcessingPoll, stream or wait for a webhook
SucceededResult and files on the job

Every AI request runs as a background job, so nothing times out.

Response 202JSON

{
  "id": "job_0123456789abcdef0123456789abcdef01234567",
  "product": "answer_feedback",
  "status": "queued",
  "poll_after_seconds": 2,
  "credits": 1,
  "result_available": false
}

Finished job: resultJSON

{
  "status": "completed",
  "official_result": false,
  "standard": "intermediate",
  "language": "English",
  "answer_count": 1,
  "summary": {
    "confident": 0,
    "nearly_there": 1,
    "keep_going": 0,
    "not_checkable": 0
  },
  "feedback": [
    {
      "id": "a1",
      "status": "checked",
      "verdict": "nearly_there",
      "message": "You're right that plants use light to make food. Add what goes in and what comes out to make it complete.",
      "next_step": "Name the two things a plant takes in and the two things it makes.",
      "covered": [
        {
          "point": "Plants use light energy",
          "essential": true,
          "evidence": [
            "use light"
          ]
        }
      ],
      "missing": [
        {
          "point": "Carbon dioxide and water are turned into glucose and oxygen",
          "essential": true
        }
      ],
      "issues": [],
      "follow_up_question": "If a plant had light but no carbon dioxide, what could it not make?",
      "model_answer": "Photosynthesis is how plants use light energy to turn carbon dioxide and water into glucose, releasing oxygen."
    }
  ],
  "warnings": [],
  "provenance": {
    "engine": "edumark_study",
    "sandbox": true
  }
}

Files and errors

Product errors

ANSWER_IDS_NOT_UNIQUEHTTP 422. Give every answer a different id, or leave the ids out.
INPUT_TOO_LARGEHTTP 422. Questions, answers and expected answers together support at most 10,000 words.
MODEL_RESULT_INVALIDOn the finished job. The generated material did not pass EduMark's checks. No charge was applied.
PROCESSING_UNAVAILABLEOn the finished job. Processing could not complete safely. No complete result was issued.