> ## 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. # Get a participant's quiz result > One participant's per-question result for a single quiz instance: the questions they received, what they answered, and the correct answers. Visible to the quiz's admins and the participant's manager-of-record (subject to the quiz's result visibility). ## OpenAPI ````yaml /openapi.json get /v1/quizzes/{quizId}/instances/{instanceId}/participants/{userId} 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/{quizId}/instances/{instanceId}/participants/{userId}: get: tags: - Quiz Reports summary: Get a participant's quiz result description: >- One participant's per-question result for a single quiz instance: the questions they received, what they answered, and the correct answers. Visible to the quiz's admins and the participant's manager-of-record (subject to the quiz's result visibility). parameters: - schema: type: string minLength: 1 maxLength: 128 pattern: ^[A-Za-z0-9_-]+$ description: The unique identifier of the quiz example: quiz_abc123 required: true description: The unique identifier of the quiz name: quizId in: path - schema: type: string minLength: 1 maxLength: 128 pattern: ^[A-Za-z0-9_-]+$ description: >- The scheduled-activity id that delivered the quiz to the participant example: act_abc123 required: true description: The scheduled-activity id that delivered the quiz to the participant name: instanceId in: path - schema: type: string minLength: 1 maxLength: 128 pattern: ^[A-Za-z0-9_-]+$ description: The participant's user id example: user_abc123 required: true description: The participant's user id name: userId in: path responses: '200': description: The participant's per-question result content: application/json: schema: $ref: '#/components/schemas/QuizParticipantResult' '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' '404': description: Quiz, instance, or result not found / not visible content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - apiKey: [] components: schemas: QuizParticipantResult: type: object properties: object: type: string enum: - quiz_participant_result quiz_id: type: string instance_id: type: string title: type: string user_id: type: string display_name: type: string nullable: true email: type: string status: type: string enum: - not_started - in_progress - completed - expired description: This participant's status for the quiz run. answered: type: integer total: type: integer correct: type: integer score_pct: type: integer nullable: true description: >- Correct / total questions as a 0-100 percentage. Null when nothing was received. delivered_at: type: string nullable: true description: When the quiz was delivered to this participant (ISO 8601). started_at: type: string nullable: true description: First answer (ISO 8601). Null if not started. last_activity_at: type: string nullable: true description: Most recent answer (ISO 8601). Null if not started. completed_at: type: string nullable: true description: Completion time (ISO 8601). Null if not completed. due_at: type: string nullable: true description: >- When answers are due / the run expires (ISO 8601). Null if no deadline. delivery_method: type: string enum: - one_off - track description: How the quiz was delivered to this participant. track_id: type: string nullable: true description: Track (workflow) ID if delivered via a track. track_name: type: string nullable: true description: Track (workflow) name if delivered via a track. questions: type: array items: $ref: '#/components/schemas/QuizParticipantQuestionResult' required: - object - quiz_id - instance_id - title - user_id - display_name - email - status - answered - total - correct - score_pct - delivered_at - started_at - last_activity_at - completed_at - due_at - delivery_method - track_id - track_name - questions 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 QuizParticipantQuestionResult: type: object properties: question_id: type: string question: type: string their_answer: type: string nullable: true description: What the participant answered, or null if they didn't answer it. correct_answer: type: string is_correct: type: boolean nullable: true description: Null when the participant hasn't answered the question yet. required: - question_id - question - their_answer - correct_answer - is_correct securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: API key for authentication. Generate keys in the Doozy dashboard. ````