> For the complete documentation index, see [llms.txt](https://synap.ac/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://synap.ac/docs/api/reference/exams/list-examquestionremarkcandidates.md).

# List ExamQuestionRemarkCandidates

Which questions of a sat exam version changed since its attempts were marked, and so need a re-mark, with the fields that changed and when a run last re-marked each one. Nothing is stored: each question is compared with one sampled response, which holds the marking it was marked against, so a re-mark run that applies the change also clears it. A completed attempt's response is preferred; an attempt not started yet speaks for a question no completed attempt drew, compared on its settings and options only. Attempts being sat are left out. Option keys are compared for single- and multiple-choice questions; other kinds are compared on their marking settings, the answer keys kept in their settings and their feedback. Covers the version and its dynamic variants. A question nobody drew, or under custom marking, which a re-mark never refreshes, has no row. One response speaks for every attempt, so a run that left some attempts untouched can read as clean. `meta.boundaries` reports the version's grade boundaries the same way, from a sampled attempt's grading snapshot. Writes nothing. Requires the override-marking grant on the exam. Not available (501) unless post-submission attempt management is enabled for the portal.

```json
{"openapi":"3.0.1","info":{"title":"Synap API","version":"3.0.0"},"tags":[{"name":"Exams","description":"Endpoints related to Exam creation and management."}],"servers":[{"url":"https://api.synap.ac/v3","description":"Production"},{"url":"https://api-stage.synap.ac/v3","description":"Staging"}],"security":[{"SessionAuth":[]},{"PATAuth":[]},{"AutomationAuth":[]},{"LegacySessionAuth":[]}],"components":{"securitySchemes":{"SessionAuth":{"type":"http","scheme":"bearer","description":"Authorize the request using a Session Token.","bearerFormat":"r:<token>"},"PATAuth":{"type":"http","scheme":"bearer","description":"Authorise the request using a personal access token.","bearerFormat":"p:"},"AutomationAuth":{"type":"http","scheme":"bearer","description":"Authorise the request with a short-lived token signed by the automations engine on behalf of a workflow owner.","bearerFormat":"a:<token>"},"LegacySessionAuth":{"type":"apiKey","description":"[Legacy] Authorize the request using a Session Token.","in":"header","name":"X-Syn-Session-Token"}},"schemas":{"ExamQuestionRemarkCandidate":{"type":"object","required":["id","type"],"properties":{"id":{"$ref":"#/components/schemas/ObjectId"},"type":{"type":"string","description":"Identifies the Resource.","enum":["ExamQuestionRemarkCandidate"]},"attributes":{"type":"object","required":["drifted","changedFields","marking","lastRemarkedAt","lastChangedFields","lastRemarkStatus"],"properties":{"drifted":{"type":"boolean","readOnly":true,"description":"Whether the question changed since its attempts were marked, so a re-mark would apply something; also true while the latest finished run left attempts failed."},"changedFields":{"type":"array","readOnly":true,"items":{"type":"string"},"description":"Dotted names of the fields that differ between a sampled response and the question as it stands, such as `marking.credit`, `options[1].isCorrect`, `feedback` or `settings.takeTest.numericAnswer.decimalPlaces`. Empty when the question has not drifted. While the latest finished run left attempts failed, what that run recorded, which can be empty (runs do not record answer-key settings)."},"marking":{"type":"object","readOnly":true,"required":["before","after"],"description":"Both sides as a re-mark run row records them, so a client can show each changed value. `changedFields` names what differs: read the values at those paths rather than comparing the two sides whole, as they also differ where nothing is compared, such as `maxPoints`, or the key and feedback a response not yet completed has not been given. `marking` reads null when the question sets none of its own, and a field it leaves unset is absent; the question then takes the test’s marking (a credit of 1 by default). Answer-key settings read from each side’s `settings.takeTest`.","properties":{"before":{"type":"object","properties":{"marking":{"type":"object","nullable":true,"description":"The question-level marking: credit, partial credit, penalty, mark scheme, strategy, score by choice and information for markers.","additionalProperties":true},"maxPoints":{"type":"number","nullable":true,"description":"The maximum the response was generated with, before any administrator override. Null on the live question, which has no computed maximum."},"feedback":{"type":"string","nullable":true},"options":{"type":"array","nullable":true,"description":"Per option, in the question’s order, for choice questions (phrase or image options). Null for every other kind.","items":{"type":"object","required":["index"],"properties":{"index":{"type":"integer"},"isCorrect":{"type":"boolean"},"credits":{"type":"number","nullable":true},"penalties":{"type":"number","nullable":true}}}},"definition":{"type":"array","nullable":true,"description":"The option definitions as serialised for a response, for the kinds `options` cannot index. Null for choice questions.","items":{"type":"object","additionalProperties":true}},"answerKey":{"type":"array","nullable":true,"description":"The answer key held in the options of the kinds `options` cannot index (matching, classification, choice matrix, bow-tie, image labelling, short answer, numeric answer, cloze), in one order-free form: from the response, the key it was last marked against. Null for other kinds and before completion; absent on runs recorded before it was kept. Named `answerKey` in `changedFields`.","items":{"type":"object","additionalProperties":true}},"settings":{"type":"object","required":["takeTest"],"description":"The answer-key settings this side holds, so a `settings.takeTest.*` path in `changedFields` reads its value here. Only the paths stored with a value on that side. An absent path is unset: a switch reads as off, `multiCorrectLimitType` as `any` and `imageHotspot.maximumClicks` as 1. Read only the paths `changedFields` names, as a path it does not name can be stored on one side and unset on the other. A response not yet completed has no true or false answer. Absent while the latest finished run left attempts failed, as runs do not record these.","properties":{"takeTest":{"type":"object","additionalProperties":true}}}},"required":["marking","maxPoints","feedback","options","definition","answerKey"],"description":"As the sampled response holds it, from when it was generated or last marked; while the latest finished run left attempts failed, as that run recorded it."},"after":{"type":"object","properties":{"marking":{"type":"object","nullable":true,"description":"The question-level marking: credit, partial credit, penalty, mark scheme, strategy, score by choice and information for markers.","additionalProperties":true},"maxPoints":{"type":"number","nullable":true,"description":"The maximum the response was generated with, before any administrator override. Null on the live question, which has no computed maximum."},"feedback":{"type":"string","nullable":true},"options":{"type":"array","nullable":true,"description":"Per option, in the question’s order, for choice questions (phrase or image options). Null for every other kind.","items":{"type":"object","required":["index"],"properties":{"index":{"type":"integer"},"isCorrect":{"type":"boolean"},"credits":{"type":"number","nullable":true},"penalties":{"type":"number","nullable":true}}}},"definition":{"type":"array","nullable":true,"description":"The option definitions as serialised for a response, for the kinds `options` cannot index. Null for choice questions.","items":{"type":"object","additionalProperties":true}},"answerKey":{"type":"array","nullable":true,"description":"The answer key held in the options of the kinds `options` cannot index (matching, classification, choice matrix, bow-tie, image labelling, short answer, numeric answer, cloze), in one order-free form: from the response, the key it was last marked against. Null for other kinds and before completion; absent on runs recorded before it was kept. Named `answerKey` in `changedFields`.","items":{"type":"object","additionalProperties":true}},"settings":{"type":"object","required":["takeTest"],"description":"The answer-key settings this side holds, so a `settings.takeTest.*` path in `changedFields` reads its value here. Only the paths stored with a value on that side. An absent path is unset: a switch reads as off, `multiCorrectLimitType` as `any` and `imageHotspot.maximumClicks` as 1. Read only the paths `changedFields` names, as a path it does not name can be stored on one side and unset on the other. A response not yet completed has no true or false answer. Absent while the latest finished run left attempts failed, as runs do not record these.","properties":{"takeTest":{"type":"object","additionalProperties":true}}}},"required":["marking","maxPoints","feedback","options","definition","answerKey"],"description":"The question as it stands; while the latest finished run left attempts failed, as that run recorded it."}}},"lastRemarkedAt":{"type":"string","format":"date-time","readOnly":true,"nullable":true,"description":"When a completed or partial re-mark run last covered the question. Null when none has."},"lastChangedFields":{"type":"array","readOnly":true,"items":{"type":"string"},"description":"What that run recorded as changed, in the same form as `changedFields`. Null when no run has, or it recorded nothing for the question.","nullable":true},"lastRemarkStatus":{"type":"string","enum":["completed","partial","failed",null],"readOnly":true,"nullable":true,"description":"How the latest finished run covering the question ended, a failed one included once it reached attempts, so it can be newer than `lastRemarkedAt`. When it failed some attempts, the question reads `drifted` even if the sampled response is up to date, and `changedFields` and `marking` are what that run recorded, until a later run covers the question. Null when no run has reached an attempt."}}},"relationships":{"type":"object","required":["question"],"properties":{"question":{"type":"object","description":"The question on the version; its id is the row id.","readOnly":true,"properties":{"data":{"type":"object","required":["id","type"],"nullable":true,"properties":{"id":{"$ref":"#/components/schemas/ObjectId"},"type":{"type":"string","description":"Identifies the Resource.","enum":["Question"]}}}}}}}}},"ObjectId":{"type":"string","description":"The primary key for each resource."},"BadRequestApiError":{"type":"object","description":"The request was invalid.","properties":{"id":{"type":"string","description":"Unique ID of this error occurrence."},"status":{"type":"string","description":"HTTP status code."},"code":{"type":"string","description":"Synap internal error code."},"title":{"type":"string"},"detail":{"type":"string"},"source":{"type":"object","properties":{"pointer":{"type":"string"},"parameter":{"type":"string"}}}}},"UnauthorizedApiError":{"type":"object","description":"Unauthorized request.","properties":{"id":{"type":"string","description":"Unique ID of this error occurrence."},"status":{"type":"string","description":"HTTP status code."},"code":{"type":"string","description":"Synap internal error code."},"title":{"type":"string"},"detail":{"type":"string"},"source":{"type":"object","properties":{"pointer":{"type":"string"},"parameter":{"type":"string"}}}}},"ForbiddenApiError":{"type":"object","description":"Forbidden request.","properties":{"id":{"type":"string","description":"Unique ID of this error occurrence."},"status":{"type":"string","description":"HTTP status code."},"code":{"type":"string","description":"Synap internal error code."},"title":{"type":"string"},"detail":{"type":"string"},"source":{"type":"object","properties":{"pointer":{"type":"string"},"parameter":{"type":"string"}}}}},"NotFoundApiError":{"type":"object","description":"The request resource could not be found.","properties":{"id":{"type":"string","description":"Unique ID of this error occurrence."},"status":{"type":"string","description":"HTTP status code."},"code":{"type":"string","description":"Synap internal error code."},"title":{"type":"string"},"detail":{"type":"string"},"source":{"type":"object","properties":{"pointer":{"type":"string"},"parameter":{"type":"string"}}}}},"ApiError":{"type":"object","description":"This is an error response structure. The id, status, code, title and detail will vary based on the error situation.","properties":{"id":{"type":"string","description":"Unique ID of this error occurrence."},"status":{"type":"string","description":"HTTP status code."},"code":{"type":"string","description":"Synap internal error code."},"title":{"type":"string"},"detail":{"type":"string"},"source":{"type":"object","properties":{"pointer":{"type":"string"},"parameter":{"type":"string"}}}}}}},"paths":{"/exam-question-remark-candidates":{"get":{"summary":"List ExamQuestionRemarkCandidates","description":"Which questions of a sat exam version changed since its attempts were marked, and so need a re-mark, with the fields that changed and when a run last re-marked each one. Nothing is stored: each question is compared with one sampled response, which holds the marking it was marked against, so a re-mark run that applies the change also clears it. A completed attempt's response is preferred; an attempt not started yet speaks for a question no completed attempt drew, compared on its settings and options only. Attempts being sat are left out. Option keys are compared for single- and multiple-choice questions; other kinds are compared on their marking settings, the answer keys kept in their settings and their feedback. Covers the version and its dynamic variants. A question nobody drew, or under custom marking, which a re-mark never refreshes, has no row. One response speaks for every attempt, so a run that left some attempts untouched can read as clean. `meta.boundaries` reports the version's grade boundaries the same way, from a sampled attempt's grading snapshot. Writes nothing. Requires the override-marking grant on the exam. Not available (501) unless post-submission attempt management is enabled for the portal.","tags":["Exams"],"parameters":[{"name":"filter","in":"query","style":"deepObject","explode":true,"required":true,"schema":{"type":"object","required":["exam","version"],"properties":{"exam":{"type":"string","minLength":1},"version":{"type":"string","minLength":1,"description":"A published version of the exam, by its number as the exam's versions list it. The draft is refused."}}}}],"responses":{"200":{"description":"Success","content":{"application/vnd.api+json":{"schema":{"required":["data"],"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ExamQuestionRemarkCandidate"}},"meta":{"type":"object","required":["boundaries"],"properties":{"boundaries":{"type":"object","required":["drifted","lastRemarkedAt"],"properties":{"drifted":{"type":"boolean","description":"Whether a run would re-grade a sampled attempt from the version's grading criteria and section grades. False for a version without grades or attempts, and where the run would hold the re-grade back because the new grades require a section the attempt never sat."},"lastRemarkedAt":{"type":"string","format":"date-time","nullable":true,"description":"When a finished run of any kind, one that only re-grades included, last covered the version. Null when none has."}}}}}}}}}},"400":{"description":"Bad Request","content":{"application/vnd.api+json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/BadRequestApiError"}}}}}}},"401":{"description":"Unauthorized","content":{"application/vnd.api+json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/UnauthorizedApiError"}}}}}}},"403":{"description":"Forbidden","content":{"application/vnd.api+json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/ForbiddenApiError"}}}}}}},"404":{"description":"Not Found","content":{"application/vnd.api+json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/NotFoundApiError"}}}}}}},"501":{"description":"Not enabled for this portal","content":{"application/vnd.api+json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/ApiError"}}}}}}}},"operationId":"examQuestionRemarkCandidates.findExamQuestionRemarkCandidates"}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://synap.ac/docs/api/reference/exams/list-examquestionremarkcandidates.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
