Skip to main content
This endpoint returns a paginated list of all PDF quizzes on the platform, including each quiz’s question PDF information and the complete list of student submissions associated with it.

​
Endpoint

GET /api/v3/quiz/pdf-quizzes

​
Required Role

Admin — you must authenticate with an admin-scoped Bearer token.

​
Required Headers

HeaderValue
AuthorizationBearer <token>
Acceptapplication/json

​
Query Parameters

​
per_page
integer
default:15
The maximum number of quiz records to return per page. Omit this parameter to use the default of 15.

​
Example Request

curl -X GET "https://app.example.com/api/v3/quiz/pdf-quizzes?per_page=15" \
  -H "Authorization: Bearer your-token" \
  -H "Accept: application/json"

​
Response

​
200 OK

{
  "data": [
    {
      "id": 1,
      "title": "Math Quiz PDF",
      "questions_pdf_url": "https://example.com/media/quiz-questions.pdf",
      "questions_count_of_quiz_pdf": 10,
      "total_grade_for_quiz_pdf": 100,
      "submissions": [
        {
          "id": 15,
          "student_name": "John Doe",
          "grade": 95,
          "total_grade": 100,
          "is_marked": 1,
          "pdf_answer_url": "https://example.com/media/answer-15.pdf"
        }
      ]
    }
  ],
  "links": {
    "first": "https://app.example.com/api/v3/quiz/pdf-quizzes?page=1",
    "last": "https://app.example.com/api/v3/quiz/pdf-quizzes?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "https://app.example.com/api/v3/quiz/pdf-quizzes",
    "per_page": 15,
    "to": 1,
    "total": 1
  }
}

​
Response Fields

​
data
array
An array of PDF quiz objects. Each object contains full quiz details and its associated student submissions.
​
meta
object
Pagination metadata for the response.
​
links
object
Cursor links for navigating between pages.

​
Error Responses

StatusMessageCause
403Unauthorized AccessThe token provided does not belong to an admin account.