API Reference

Questions API

Retrieve questions for a specific quiz or browse questions across all published quizzes by category, difficulty, type, and tags.

The Question Object

A question belongs to a quiz and contains the question text, answer options, and metadata such as difficulty and ordering.

Attribute	Type	Description
`id`	string	Unique identifier for the question
`quizId`	string	ID of the parent quiz
`text`	string	The question text displayed to the user
`type`	string	One of: `MULTIPLE_CHOICE`, `TRUE_FALSE`, `OPEN_ENDED`
`difficulty`	string	One of: `EASY`, `MEDIUM`, `HARD`, `EXPERT`
`category`	string \| null	Category of the parent quiz
`explanation`	string \| null	Optional explanation shown after answering
`answers`	object[]	Array of answer objects with `id`, `text`, and `isCorrect` fields

GET/api/v1/questions?quiz_id=...

Get Quiz Questions

Returns all questions for a specific quiz in order. Pass a quiz_id to retrieve the ordered list of questions belonging to that quiz. Each question now includes the parent quiz category.

Query Parameters

Parameter	Type	Default	Description
`quiz_id`Required	string	-	The ID of the quiz to fetch questions for
`include_answers`	string	false	Set to `"true"` to include the answers array with each question

Example Request

bash

curl -X GET "https://quizapi.io/api/v1/questions?quiz_id=quiz_abc123&include_answers=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

json

{
  "success": true,
  "data": [
    {
      "id": "ques_xyz789",
      "quizId": "quiz_abc123",
      "text": "What is the typeof null in JavaScript?",
      "type": "MULTIPLE_CHOICE",
      "difficulty": "MEDIUM",
      "explanation": "typeof null returns 'object' due to a legacy bug.",
      "category": "Programming",
      "answers": [
        { "id": "ans_1", "text": "null", "isCorrect": false },
        { "id": "ans_2", "text": "object", "isCorrect": true },
        { "id": "ans_3", "text": "undefined", "isCorrect": false },
        { "id": "ans_4", "text": "string", "isCorrect": false }
      ]
    }
  ],
  "meta": {
    "total": 10,
    "quizId": "quiz_abc123"
  }
}

GET/api/v1/questions

Browse Questions

Browse questions across all published quizzes. When called without a quiz_id, this endpoint returns paginated questions filtered by category, difficulty, type, and tags. Each question includes its parent quiz context. Answers are always included in browse mode.

Query Parameters

Parameter	Type	Default	Description
`category`	string	-	Filter by quiz category. Supports comma-separated values for multiple categories (case-insensitive). E.g. `Programming,DevOps`
`difficulty`	string	-	Filter by difficulty. Supports comma-separated values (case-insensitive). E.g. `EASY,MEDIUM`
`type`	string	-	Filter by question type. Supports comma-separated values. E.g. `MULTIPLE_CHOICE,TRUE_FALSE`
`tags`	string	-	Comma-separated list of tags to match (e.g. `javascript,react`)
`limit`	integer	10	Number of questions to return per page (1–50)
`offset`	integer	0	Number of questions to skip for pagination
`random`	string	false	Set to `"true"` to shuffle the returned questions randomly

Tip: Use the /api/v1/metadata endpoint to discover available categories, tags, and difficulty levels before querying. All filter values (category, difficulty, type) are case-insensitive.

Example Request

bash

curl -X GET "https://quizapi.io/api/v1/questions?category=Programming,DevOps&difficulty=EASY,MEDIUM&type=MULTIPLE_CHOICE&tags=javascript,react&limit=10&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

json

{
  "success": true,
  "data": [
    {
      "id": "ques_xyz789",
      "text": "What is the typeof null in JavaScript?",
      "type": "MULTIPLE_CHOICE",
      "difficulty": "MEDIUM",
      "explanation": "typeof null returns 'object' due to a legacy bug.",
      "category": "Programming",
      "tags": ["javascript", "fundamentals"],
      "quizId": "quiz_abc123",
      "quizTitle": "JavaScript Essentials",
      "answers": [
        { "id": "ans_1", "text": "null", "isCorrect": false },
        { "id": "ans_2", "text": "object", "isCorrect": true },
        { "id": "ans_3", "text": "undefined", "isCorrect": false },
        { "id": "ans_4", "text": "string", "isCorrect": false }
      ]
    }
  ],
  "meta": {
    "total": 23,
    "pageTotal": 1,
    "page": 1,
    "lastPage": 3,
    "limit": 10,
    "offset": 0,
    "links": {
      "first": "/api/v1/questions?...&offset=0&limit=10",
      "last": "/api/v1/questions?...&offset=20&limit=10",
      "next": "/api/v1/questions?...&offset=10&limit=10",
      "prev": null
    }
  }
}

Pagination Meta Object

Field	Type	Description
`total`	integer	Total number of questions matching your filters (across all pages)
`pageTotal`	integer	Number of questions returned in this page
`page`	integer	Current page number (1-based)
`lastPage`	integer	Total number of pages available
`limit`	integer	The limit value used for this request
`offset`	integer	The offset value used for this request
`links`	object	Pagination links: `first`, `last`, `next` (null on last page), `prev` (null on first page)

Response Format

All API responses follow a consistent format. Successful responses wrap the result in a data key. Browse endpoints include a meta object with pagination info and navigation links.

Status Code	Description
200	Successful request
400	Bad request (invalid difficulty, type, or other validation error)
401	Unauthorized (missing or invalid API key)
429	Rate limit exceeded