Get All Quizzes

Retrieve all quizzes within a specific namespace.

---

Overview

This endpoint returns a list of all quizzes available in the specified namespace. Results can be paginated, filtered, and sorted.

Method: GET
Endpoint:
/api/v1/namespaces/:namespaceId/quizzes

Requires administrative authentication.

---

Request

Headers

x-api-key: {your_api_key}  # Required
Accept: application/json

Path Parameters

Parameter	Type	Required	Description
namespaceId	string	✅	Namespace unique ID

Query Parameters

Parameter	Type	Required	Description
pageId	string	❌	Pagination token
pageSize	number	❌	Number of results per page
sortBy	string	❌	Field to sort by
sortOrder	string	❌	Sort direction (asc/desc)
query	string	❌	Search term to filter quizzes
filters	object	❌	Additional filtering options

---

Response

{
  "quizzes": [
    {
      "id": "sample-quiz",
      "name": "sample-quiz",
      "primaryColor": "#9b8163",
      "createdOn": 1626101719367,
      "start": 1626246000000,
      "end": 1626417959999,
      "questions": [... ],
      "anonymous": false,
      "status": "queued",
      "disableEmailing": false,
      "userErrorCount": 0,
      "userCount": 4,
      "csvErrors": [],
      "csvStatus": "done",
      "emailedOn": null,
      "wasReminded": false
    },
    {... }
  ],
  "nextPageId": null,
  "prevPageId": null
}

---

Error Responses

• 500 Internal Server Error – If the namespace does not exist

{
  "error": "namespace does not exist"
}

---

Authorization Requirements

This endpoint requires authentication with one of the following permissions:

• System administrator
• Namespace administrator