Submit

This endpoint allows a student to upload their completed PDF answer sheet for a quiz. You must submit the file within the allowed quiz duration — the server calculates the deadline from the start_at timestamp and the duration value you provide.

Endpoint

POST /api/v3/quiz/submit-pdf

Required Role

Authenticated student — you must authenticate with a student-scoped Bearer token and be enrolled in the course.

Required Headers

Header	Value
`Authorization`	`Bearer <student-token>`
`Accept`	`application/json`
`Content-Type`	`multipart/form-data`

Request Parameters

file/PDF

required

The student’s completed answer sheet as a PDF file. The server rejects any file that is not a valid PDF.

integer

required

The ID of the course this quiz belongs to.

integer

required

The ID of the quiz the student is submitting answers for.

integer

The ID of the class, if this course is divided into classes. Omit if not applicable.

numeric

required

The maximum allowed duration for this quiz, in minutes. The server uses this value together with start_at to verify the submission is on time.

datetime

required

The timestamp recording when the student began the quiz (e.g. 2026-06-30T09:00:00). Combined with duration, this defines the submission deadline.

Example Request

curl -X POST https://app.example.com/api/v3/quiz/submit-pdf \
  -H "Authorization: Bearer your-student-token" \
  -H "Accept: application/json" \
  -F "file=@/path/to/answers.pdf" \
  -F "course_id=5" \
  -F "quiz_id=1" \
  -F "duration=60" \
  -F "start_at=2026-06-30T09:00:00"

Response

200 OK

{
  "status": true,
  "message": "Submitted successfully"
}

Error Responses

Status	Message	Cause
`422`	Invalid Data	The uploaded file is not a PDF, or a required field is missing.
`404`	Not Found / Course Not Found	The specified `quiz_id` or `course_id` does not exist.
`403`	Quiz duration expired	The submission arrived after the allowed duration window closed.
`403`	Pay first to access the course	The student is not enrolled in or has not paid for the course.

422 Validation Error Example

{
  "message": "Invalid Data",
  "errors": {
    "file": ["The file must be a file of type: pdf."]
  }
}

The server verifies that your submission arrives within the allowed time window. It adds duration minutes to the start_at timestamp to calculate the deadline — if that deadline has passed at the moment the request is received, the submission is rejected with a 403 Quiz duration expired error. Ensure the start_at value you send accurately reflects when the student opened the quiz.

homework

quizzes

course

Endpoint

Required Role

Required Headers

Request Parameters

Example Request

Response

200 OK

Error Responses

422 Validation Error Example

​Endpoint

​Required Role

​Required Headers

​Request Parameters

​Example Request

​Response

​200 OK

​Error Responses

​422 Validation Error Example

Endpoint

Required Role

Required Headers

Request Parameters

Example Request

Response

200 OK

Error Responses

422 Validation Error Example