> ## Documentation Index
> Fetch the complete documentation index at: https://help.doozy.live/llms.txt
> Use this file to discover all available pages before exploring further.

# List quizzes

> List all quizzes accessible to the authenticated user. Returns quizzes where the user is an admin or delegated admin. Results are paginated and sorted by creation date (newest first).



## OpenAPI

````yaml /openapi.json get /v1/quizzes
openapi: 3.0.3
info:
  title: Doozy Public API
  version: 1.0.0
  description: >-
    The Doozy Public API allows you to programmatically access your
    organization's data.


    ## Authentication


    All API requests require an API key passed in the `x-api-key` header.


    ```

    x-api-key: dzy_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

    ```


    API keys can be generated and managed through the Doozy dashboard. Each key
    is associated with a user account and inherits that user's permissions.


    ## Rate Limiting


    API requests are rate limited. Rate limiting is handled by Cloudflare. If
    you exceed the rate limit, you'll receive a 429 Too Many Requests response.


    ## Pagination


    List endpoints support cursor-based pagination using `limit` and
    `starting_after` query parameters.
  contact:
    name: Doozy Support
    email: support@doozy.live
    url: https://help.doozy.live/api
servers:
  - url: https://api.doozy.live
    description: Production
security:
  - apiKey: []
tags:
  - name: Quizzes
    description: Quiz analytics and reporting endpoints
  - name: Tracks
    description: Track management and analytics endpoints
  - name: Surveys
    description: Survey and poll analytics endpoints
  - name: Introductions
    description: Doozy Roulette and Matchmaking introduction endpoints
paths:
  /v1/quizzes:
    get:
      tags:
        - Quizzes
      summary: List quizzes
      description: >-
        List all quizzes accessible to the authenticated user. Returns quizzes
        where the user is an admin or delegated admin. Results are paginated and
        sorted by creation date (newest first).
      parameters:
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
            description: Maximum number of results to return (1-100, default 25)
            example: 25
          required: false
          description: Maximum number of results to return (1-100, default 25)
          name: limit
          in: query
        - schema:
            type: string
            description: >-
              Cursor for pagination - the ID of the last item from the previous
              page
            example: quiz_abc123
          required: false
          description: >-
            Cursor for pagination - the ID of the last item from the previous
            page
          name: starting_after
          in: query
        - schema:
            type: string
            description: >-
              Cursor to fetch the previous page of results. Pass previous_cursor
              value as ending_before.
            example: quiz_xyz789
          required: false
          description: >-
            Cursor to fetch the previous page of results. Pass previous_cursor
            value as ending_before.
          name: ending_before
          in: query
      responses:
        '200':
          description: List of quizzes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuizListResponse'
        '401':
          description: Authentication required - missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - apiKey: []
components:
  schemas:
    QuizListResponse:
      type: object
      properties:
        object:
          type: string
          enum:
            - list
          description: String representing the object type
          example: list
        data:
          type: array
          items:
            $ref: '#/components/schemas/QuizSummary'
          description: Array of quiz objects
        has_more:
          type: boolean
          description: Whether there are more results available beyond this page
          example: true
        url:
          type: string
          description: The URL for accessing this list endpoint
          example: /v1/quizzes
        next_cursor:
          type: string
          nullable: true
          description: >-
            Cursor to fetch the next page of results. Pass as starting_after in
            subsequent requests.
          example: quiz_xyz789
        previous_cursor:
          type: string
          nullable: true
          description: >-
            Cursor to fetch the previous page of results. Pass as ending_before
            in subsequent requests.
          example: quiz_abc123
      required:
        - object
        - data
        - has_more
        - url
        - next_cursor
        - previous_cursor
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - api_error
                - authentication_error
                - invalid_request_error
                - rate_limit_error
              description: The type of error returned
              example: invalid_request_error
            code:
              type: string
              nullable: true
              description: Machine-readable error code for specific error conditions
              example: resource_not_found
            message:
              type: string
              description: Human-readable error message
              example: 'No such quiz: quiz_abc123'
            param:
              type: string
              nullable: true
              description: The parameter related to the error, if applicable
              example: id
            doc_url:
              type: string
              format: uri
              description: URL to documentation about this error
              example: https://docs.doozy.live/api/errors#resource_not_found
          required:
            - type
            - code
            - message
      required:
        - error
    QuizSummary:
      type: object
      properties:
        object:
          type: string
          enum:
            - quiz
          description: Object type identifier
          example: quiz
        id:
          type: string
          description: Unique quiz identifier
          example: quiz_abc123
        title:
          type: string
          description: Quiz title
          example: Product Knowledge Assessment
        description:
          type: string
          nullable: true
          description: Quiz description
          example: Test your knowledge of our product lineup
        visibility:
          type: string
          enum:
            - public
            - public_unlisted
            - account
            - private
          description: Quiz visibility setting
          example: private
        round_count:
          type: integer
          description: Number of rounds in the quiz
          example: 3
        question_count:
          type: integer
          nullable: true
          description: Total number of questions in the quiz
          example: 15
        created_at:
          type: string
          nullable: true
          description: When the quiz was created (ISO 8601 format)
          example: '2026-01-15T10:30:00.000Z'
        updated_at:
          type: string
          nullable: true
          description: When the quiz was last updated (ISO 8601 format)
          example: '2026-01-20T14:00:00.000Z'
      required:
        - object
        - id
        - title
        - description
        - visibility
        - round_count
        - question_count
        - created_at
        - updated_at
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication. Generate keys in the Doozy dashboard.

````