Results report

One assignment's results as an Excel sheet, CSV or PDF, with the gaps shown.

PriceFree
Typical time2 s to 30 s
Scopereports:read
Runs asA background job

Try it

Run results report 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.

The same file as "Download grade report" in EduMark: one row per learner who handed in work, with their approved result. Learners without a result yet are listed so nothing is missed. Names stay hidden for anonymous marking until results are released. Free. Download the file from GET /jobs/{job_id}/files/results.xlsx (or .csv / .pdf).

Requires reports:read. Free. 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.

Results report

POST/v1/reports/results

Scope reports:read

Headers

Results report: 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

Results report: request body
Field	Details
`assignment_id`	stringRequiredThe assignment (GET /v1/assignments).Up to 200 charactersPattern `^[A-Za-z0-9][A-Za-z0-9._:-]{0,199}$`
`format`	enumOne of `xlsx`, `csv`, `pdf`Default `"xlsx"`
`columns`	array of enum, optionalColumns to include, in the report's own order. Default: learner, learner ID, grade, criteria, marker, submitted.1 to 11 items
`hide_names`	booleanReplace names with Learner 1, Learner 2…Default `false`

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/reports/results' \
  -H "Authorization: Bearer $EDUMARK_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "assignment_id": "assignment_8f3c2a91",
  "format": "csv",
  "columns": [
    "learner",
    "grade",
    "score",
    "feedback"
  ]
}'

# 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": "reports_results",
  "status": "queued",
  "poll_after_seconds": 2,
  "credits": 0,
  "result_available": false
}

Finished job: resultJSON

{
  "report": "results",
  "assignment_id": "assignment_8f3c2a91",
  "title": "Respiration essay",
  "format": "csv",
  "columns": [
    "learner",
    "grade",
    "score",
    "feedback"
  ],
  "rows": 3,
  "submitted": 3,
  "with_result": 2,
  "missing": 1,
  "hidden": 0,
  "truncated": false,
  "check": "1 of 3 learners who submitted have no result yet.",
  "file": {
    "name": "results.csv",
    "mime_type": "text/csv; charset=utf-8",
    "size_bytes": 2048
  },
  "note": null
}