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

# Get Assessment Analytics

> Aggregate performance, a score distribution, and per-question statistics
including a discrimination index that identifies questions failing to
separate strong from weak learners.

Requires the `read:results` scope.




## OpenAPI

````yaml GET /assessments/{id}/analytics
openapi: 3.1.0
info:
  title: Edpire API
  description: >
    Edpire is a headless assessment engine. This API lets you manage
    assessments,

    submit answers for grading, retrieve results, organise them into folders,
    and configure

    webhooks for real-time notifications.


    All responses use a consistent envelope: `{ data, error, meta }`.
  version: 1.0.0
  contact:
    name: Edpire Support
    url: https://edpire.com
  license:
    name: Proprietary
servers:
  - url: https://edpire.com/api/v1
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Assessments
    description: Create, list, update, publish, and grade assessments
  - name: Submissions
    description: Retrieve submission details
  - name: Learners
    description: Query learner results
  - name: Webhooks
    description: Register and manage webhook endpoints
  - name: Embed
    description: Mint tokens and load assessments for browser-side rendering
  - name: Folders
    description: Nestable structure for filing assessments
  - name: Authoring
    description: Hand an author into the Edpire builder from your own admin
paths:
  /assessments/{id}/analytics:
    get:
      tags:
        - Assessments
      summary: Per-question analytics for an assessment
      description: |
        Aggregate performance, a score distribution, and per-question statistics
        including a discrimination index that identifies questions failing to
        separate strong from weak learners.

        Requires the `read:results` scope.
      operationId: getAssessmentAnalytics
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Analytics for the assessment
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/AssessmentAnalytics'
                  error:
                    type: 'null'
                  meta:
                    type: 'null'
        '404':
          description: Assessment not found in this organization
components:
  schemas:
    AssessmentAnalytics:
      type: object
      properties:
        assessment_id:
          type: string
          format: uuid
        assessment_title:
          type: string
        overview:
          type: object
          properties:
            submission_count:
              type: integer
            avg_score:
              type: number
            avg_score_percent:
              type: number
            max_score:
              type: number
            passing_score_percent:
              type: number
            pass_rate:
              type: number
        distribution:
          type: array
          description: Score buckets, for a histogram.
          items:
            type: object
            properties:
              label:
                type: string
              count:
                type: integer
        question_stats:
          type: array
          items:
            type: object
            properties:
              question_id:
                type: string
                format: uuid
              label:
                type: string
              points:
                type: number
              attempt_count:
                type: integer
              avg_score_percent:
                type: number
              pct_fully_correct:
                type: number
              pct_skipped:
                type: number
              discrimination_index:
                type: number
                nullable: true
                description: >
                  Correlation between performance on this question and on the

                  assessment overall. Low or negative values flag a question
                  that

                  is not separating strong learners from weak ones.
              discrimination_label:
                type: string
                nullable: true
        student_results:
          type: array
          items:
            type: object
            properties:
              submission_id:
                type: string
                format: uuid
              display_name:
                type: string
              score:
                type: number
              max_score:
                type: number
              percentage:
                type: number
              submitted_at:
                type: string
                format: date-time
                nullable: true
              status:
                type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >
        API key starting with `edp_live_`. Pass via `Authorization: Bearer
        edp_live_xxx`.


        Scopes: `read:assessments`, `write:assessments`, `read:results`,
        `write:submissions`.

````