Skip to content
Schoology Dev Docs

Grading Rubrics

Grading rubrics allow you to grade assignments and discussions using a standard of performance for your students.

Fields

Section titled “Fields”
Field Name Description Type
id ID The ID of the grading rubric integer
created Created The created timestamp of the grading rubric string
title Title The title of the grading rubric string
total_points Total points The total points of the grading rubric integer
realm Realm The Schoology realm of the grading rubric (section) string
realm_id Realm id The Schoology realm id of the grading rubric (section id) integer
criteria Criteria A list of rubric criteria objects (see below) array
id Criteria id The ID of the grading rubric criteria integer
title Criteria title The title of the grading rubric criteria string
description Criteria description The description of the grading rubric criteria string
max_points Criteria max points The maximum points of the grading rubric criteria integer
weight Criteria weight The weight of the grading rubric criteria integer
ratings Ratings A list of criteria rating objects (see below) array
points Rating points The point value of the criteria rating integer
description Rating description The description of the criteria rating string

GET sections/{section id}/grading_rubrics

Section titled “GET sections/{section id}/grading_rubrics”

List all grading rubrics in a course section

Return A list of grading rubric objects

{
  "grading_rubric": [
    {
      "id": 405,
      "created": 1420642460,
      "title": "PowerPoint Presentation",
      "total_points": 20,
      "realm": "section",
      "realm_id": 709161,
      "criteria": [
        {
          "id": 249,
          "title": "Research and Note Taking",
          "description": "Student should have done ample research into their chose topic.",
          "max_points": 4,
          "weight": 1,
          "ratings": [
            {
              "points": 4,
              "description": "Excellent"
            },
            {
              "points": 3,
              "description": "Good"
            },
            {
              "points": 2,
              "description": "Satisfactory"
            },
            {
              "points": 1,
              "description": "Needs Improvement"
            }
          ]
        },
        {
          "id": 251,
          "title": "Pre Production Planning",
          "description": "A strong outline must be accompanied by the presentation",
          "max_points": 4,
          "weight": 2,
          "ratings": [
            {
              "points": 4,
              "description": "Excellent"
            },
            {
              "points": 3,
              "description": "Good"
            },
            {
              "points": 2,
              "description": "Satisfactory"
            },
            {
              "points": 1,
              "description": "Needs Improvement"
            }
          ]
        },
        {
          "id": 253,
          "title": "Content",
          "description": "Content should be clear, concise, logical, and accurate",
          "max_points": 4,
          "weight": 3,
          "ratings": [
            {
              "points": 4,
              "description": "Excellent"
            },
            {
              "points": 3,
              "description": "Good"
            },
            {
              "points": 2,
              "description": "Satisfactory"
            },
            {
              "points": 1,
              "description": "Needs Improvement"
            }
          ]
        },
        {
          "id": 255,
          "title": "Layout",
          "description": "Slides must be clean and easy to understand",
          "max_points": 4,
          "weight": 4,
          "ratings": [
            {
              "points": 4,
              "description": "Excellent"
            },
            {
              "points": 3,
              "description": "Good"
            },
            {
              "points": 2,
              "description": "Satisfactory"
            },
            {
              "points": 1,
              "description": "Needs Improvement"
            }
          ]
        },
        {
          "id": 257,
          "title": "Graphics",
          "description": "Any media on slides should be appropriate to the content",
          "max_points": 4,
          "weight": 5,
          "ratings": [
            {
              "points": 4,
              "description": "Excellent"
            },
            {
              "points": 3,
              "description": "Good"
            },
            {
              "points": 2,
              "description": "Satisfactory"
            },
            {
              "points": 1,
              "description": "Needs Improvement"
            }
          ]
        }
      ]
    },
    {
      "id": 407,
      "created": 1420642644,
      "title": "Oral Presentation",
      "total_points": 12,
      "realm": "section",
      "realm_id": 709161,
      "criteria": [
        {
          "id": 259,
          "title": "Delivery",
          "description": "Presenter doesn’t rush, shows\nenthusiasm, avoids likes, ums, kind ofs, you\nknows, etc. Uses complete sentences.",
          "max_points": 3,
          "weight": 1,
          "ratings": [
            {
              "points": 3,
              "description": "All elements present"
            },
            {
              "points": 2,
              "description": "Most elements\npresent"
            },
            {
              "points": 1,
              "description": "Some elements\npresent"
            },
            {
              "points": 0,
              "description": "No elements\npresent"
            }
          ]
        },
        {
          "id": 261,
          "title": "Eye Contact",
          "description": "Presenter keeps head up,\ndoes not read, and speaks to whole audience.",
          "max_points": 3,
          "weight": 2,
          "ratings": [
            {
              "points": 3,
              "description": "All elements present"
            },
            {
              "points": 2,
              "description": "Most elements\npresent"
            },
            {
              "points": 1,
              "description": "Some elements\npresent"
            },
            {
              "points": 0,
              "description": "No elements\npresent"
            }
          ]
        },
        {
          "id": 263,
          "title": "Posture",
          "description": "Presenter stands up straight, faces\naudience, and doesn’t fidget.",
          "max_points": 3,
          "weight": 3,
          "ratings": [
            {
              "points": 3,
              "description": "All elements present"
            },
            {
              "points": 2,
              "description": "Most elements\npresent"
            },
            {
              "points": 1,
              "description": "Some elements\npresent"
            },
            {
              "points": 0,
              "description": "No elements\npresent"
            }
          ]
        },
        {
          "id": 265,
          "title": "Volume",
          "description": "Presenter can be easily heard by\nall. No gum, etc.",
          "max_points": 3,
          "weight": 4,
          "ratings": [
            {
              "points": 3,
              "description": "All elements present"
            },
            {
              "points": 2,
              "description": "Most elements\npresent"
            },
            {
              "points": 1,
              "description": "Some elements\npresent"
            },
            {
              "points": 0,
              "description": "No elements\npresent"
            }
          ]
        }
      ]
    }
  ],
  "total": 2
}

GET sections/{section id}/grading_rubrics/{grading rubric id}

Section titled “GET sections/{section id}/grading_rubrics/{grading rubric id}”

View a grading rubric in a course section

Return A grading rubric object

{
  "id": 405,
  "created": 1420642460,
  "title": "PowerPoint Presentation",
  "total_points": 20,
  "realm": "section",
  "realm_id": 709161,
  "criteria": [
    {
      "id": 249,
      "title": "Research and Note Taking",
      "description": "Student should have done ample research into their chose topic.",
      "max_points": 4,
      "weight": 1,
      "ratings": [
        {
          "points": 4,
          "description": "Excellent"
        },
        {
          "points": 3,
          "description": "Good"
        },
        {
          "points": 2,
          "description": "Satisfactory"
        },
        {
          "points": 1,
          "description": "Needs Improvement"
        }
      ]
    },
    {
      "id": 251,
      "title": "Pre Production Planning",
      "description": "A strong outline must be accompanied by the presentation",
      "max_points": 4,
      "weight": 2,
      "ratings": [
        {
          "points": 4,
          "description": "Excellent"
        },
        {
          "points": 3,
          "description": "Good"
        },
        {
          "points": 2,
          "description": "Satisfactory"
        },
        {
          "points": 1,
          "description": "Needs Improvement"
        }
      ]
    },
    {
      "id": 253,
      "title": "Content",
      "description": "Content should be clear, concise, logical, and accurate",
      "max_points": 4,
      "weight": 3,
      "ratings": [
        {
          "points": 4,
          "description": "Excellent"
        },
        {
          "points": 3,
          "description": "Good"
        },
        {
          "points": 2,
          "description": "Satisfactory"
        },
        {
          "points": 1,
          "description": "Needs Improvement"
        }
      ]
    },
    {
      "id": 255,
      "title": "Layout",
      "description": "Slides must be clean and easy to understand",
      "max_points": 4,
      "weight": 4,
      "ratings": [
        {
          "points": 4,
          "description": "Excellent"
        },
        {
          "points": 3,
          "description": "Good"
        },
        {
          "points": 2,
          "description": "Satisfactory"
        },
        {
          "points": 1,
          "description": "Needs Improvement"
        }
      ]
    },
    {
      "id": 257,
      "title": "Graphics",
      "description": "Any media on slides should be appropriate to the content",
      "max_points": 4,
      "weight": 5,
      "ratings": [
        {
          "points": 4,
          "description": "Excellent"
        },
        {
          "points": 3,
          "description": "Good"
        },
        {
          "points": 2,
          "description": "Satisfactory"
        },
        {
          "points": 1,
          "description": "Needs Improvement"
        }
      ]
    }
  ]
}