Skip to main content
Example
{
  "id": "sub_01HX9N5AB3...",
  "object": "submission",
  "assignment_id": "asg_01HX9...",
  "student_id": "usr_01HX9...",
  "content": { "text": "Lorentz invariance means that the laws of physics..." },
  "files": [
    { "id": "fil_01HX9...", "name": "essay.pdf", "size": 124300, "url": "https://..." }
  ],
  "grade_ai": 8.5,
  "grade_manual": null,
  "final_grade": null,
  "grading_rationale": "## Clarity (4/4)\nThe student opens with...",
  "grading_breakdown": [
    { "criterion": "clarity",  "score": 4, "max": 4 },
    { "criterion": "accuracy", "score": 3, "max": 4 },
    { "criterion": "sources",  "score": 1.5, "max": 2 }
  ],
  "grader_comments": null,
  "human_review_status": "pending",
  "ai_status": "ready",
  "evaluated_at": "2026-05-10T12:34:56Z",
  "uploaded_at": "2026-05-10T12:30:00Z"
}

​
Attributes

​
id
string
Prefix sub_.
​
assignment_id
string
​
student_id
string
​
files
File[]
​
grade_ai
number | null
​
grade_manual
number | null
​
final_grade
number | null
Convenience field: grade_manual ?? grade_ai. Null while human_review_status === "pending" if the assignment requires review.
​
grading_rationale
string | null
Markdown.
​
grading_breakdown
object[]
​
grader_comments
string | null
Markdown, human-written.
​
human_review_status
enum
pending | reviewed | off.
​
ai_status
enum
pending | ready | error.
​
evaluated_at
string | null
​
uploaded_at
string