---
updatedAt: 2025-05-14T20:42:26.000Z
agentTools:
  siteIndex: https://developers.klaxoon.com/llms.txt
  projectIndex: https://developers.klaxoon.com/klaxoon/llms.txt
---

# Get quiz results for current user

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Participant Activity Report -test",
    "description": "Participant Activity Report API",
    "contact": {
      "name": "Klaxoon PHP Team"
    },
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.klaxoon.com",
      "description": "API Klaxoon"
    }
  ],
  "tags": [
    {
      "name": "Quiz"
    }
  ],
  "paths": {
    "/v1/quizzes/{activityId}/participants/me": {
      "get": {
        "summary": "Get quiz results for current user",
        "tags": [
          "Quiz"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/activityId"
          },
          {
            "$ref": "#/components/parameters/include"
          }
        ],
        "security": [
          {
            "oauth2": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ParticipantsView"
                    },
                    {
                      "$ref": "#/components/schemas/QuizResultView"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "default": {
            "$ref": "#/components/responses/Default"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "oauth2": {
        "flows": {},
        "type": "oauth2"
      }
    },
    "parameters": {
      "activityId": {
        "name": "activityId",
        "in": "path",
        "description": "Unique identifier for the activity.",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      "include": {
        "name": "include",
        "in": "query",
        "description": "Comma-separated list of fields to define the additional data to include. To include result data you must set the 'include' parameter with the field 'result' when you request this endpoint.",
        "required": false,
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "result"
            ],
            "example": "result"
          }
        },
        "style": "form",
        "explode": false
      }
    },
    "schemas": {
      "QuizResultView": {
        "type": "object",
        "properties": {
          "result": {
            "type": "object",
            "description": "Results relative to the participation of the user in the Quiz",
            "required": [
              "firstActionDate",
              "lastActionDate",
              "score",
              "successRate",
              "progression",
              "replays"
            ],
            "properties": {
              "progression": {
                "type": "number",
                "format": "float",
                "description": "Percentage of questions answered by the participant out of the total number of questions in the Quiz",
                "example": 33.33
              },
              "score": {
                "type": "number",
                "format": "float",
                "description": "Score of the participant based on the whole Quiz (percentage)",
                "example": 33.33
              },
              "successRate": {
                "type": "number",
                "format": "float",
                "description": "Score of the participant based only on the questions already answered (percentage)",
                "example": 66.66
              },
              "replays": {
                "type": "number",
                "description": "The number of times the participant replayed the Quiz. The initial participation does not count as a Replay."
              },
              "firstActionDate": {
                "type": "string",
                "format": "date-time",
                "description": "Date of the first question answered by the participant",
                "example": "2020-07-24T09:00:00.000+0000"
              },
              "lastActionDate": {
                "type": "string",
                "format": "date-time",
                "description": "Date of the last question answered by the participant",
                "example": "2020-07-24T09:00:00.000+0000"
              },
              "feedback": {
                "$ref": "#/components/schemas/ParticipantFeedbackView"
              }
            }
          }
        }
      },
      "ParticipantsView": {
        "description": "Successful operation",
        "type": "object",
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "ID of the participant.",
            "example": "d16f8914-388d-4714-a259-b183de50d447"
          },
          "firstname": {
            "type": "string",
            "description": "First name of the participant. Available only if the participant is connected to his Klaxoon account when he join the activity.",
            "example": "John"
          },
          "lastname": {
            "type": "string",
            "description": "Last name of the participant. Available only if the participant is connected to his Klaxoon account when he join the activity.",
            "example": "Doe"
          },
          "username": {
            "type": "string",
            "description": "Username of the participant. Available if Join using a Nickname option is enabled on the activity.",
            "nullable": true,
            "example": "J.D"
          },
          "email": {
            "type": "string",
            "description": "Email of the participant. Only returned if the caller is host of the activity (or for caller's detailed informations).",
            "nullable": true,
            "example": "john.doe@klaxoon.com"
          },
          "role": {
            "type": "string",
            "description": "Role of the participant in the activity.",
            "nullable": true,
            "enum": [
              "host",
              "participant"
            ]
          }
        }
      },
      "ParticipantFeedbackView": {
        "type": "object",
        "description": "The feedback left by the participant at the end of the activity",
        "nullable": true,
        "properties": {
          "comment": {
            "type": "string",
            "description": "The comment left by the participant at the end of the activity",
            "nullable": true
          },
          "rating": {
            "type": "number",
            "description": "The rating left by the participant at the end of the activity",
            "format": "float",
            "nullable": true
          }
        }
      },
      "Error": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "The problem type",
            "example": "about:blank"
          },
          "title": {
            "type": "string",
            "description": "A short, human-readable summary of the problem type",
            "example": "Bad Request"
          },
          "detail": {
            "type": "string",
            "description": "Error details"
          },
          "instance": {
            "type": "string",
            "description": "A URI reference that identifies the specific occurrence of the problem",
            "example": "/138d9bea-4edf-4e9c-86f7-43672e42c5dc"
          }
        },
        "required": [
          "type",
          "title"
        ]
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Bad Request",
        "content": {
          "application/problem+json": {
            "schema": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/Error"
                },
                {
                  "type": "object",
                  "properties": {
                    "title": {
                      "example": "Bad Request"
                    },
                    "detail": {
                      "example": "Expecting a string, got number."
                    }
                  }
                }
              ]
            }
          }
        }
      },
      "Forbidden": {
        "description": "The user does not have the required permissions to access this resource",
        "content": {
          "application/problem+json": {
            "schema": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/Error"
                },
                {
                  "type": "object",
                  "properties": {
                    "title": {
                      "example": "You do not have access to this resource."
                    },
                    "detail": {
                      "example": "You tried to access to a resource that does not belong to you"
                    }
                  }
                }
              ]
            }
          }
        }
      },
      "NotFound": {
        "description": "The resource does not exists.",
        "content": {
          "application/problem+json": {
            "schema": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/Error"
                },
                {
                  "type": "object",
                  "properties": {
                    "title": {
                      "example": "Not Found"
                    },
                    "detail": {
                      "example": ""
                    }
                  }
                }
              ]
            }
          }
        }
      },
      "Default": {
        "description": "Operation in error",
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```