Course Section

Teachers and students are enrolled into course sections; each section must belong to a parent course. Assignments, documents, events, and other materials are created and associated with course sections.

Fields

FieldNameDescriptionTypeRequired
title
(section_title allowed in POST/PUT)
Section Title The section title (e.g. Section 10b). string yes
section_code Section Code The section code must be unique across the course and grading period (e.g. "Spring 2010" can only have one "10b" for course "ENG101"). string Either section_code or section_school_code must be set. If both are specified section code will be ignored and section school code will be used.
section_school_code Section School Code The section school code must be unique across the school string Either section_code or section_school_code must be set. If both are specified section code will be ignored and section school code will be used.
access_code Access Code The access code is created by Schoology automatically, and cannot be adjusted. If this field is blank, the course cannot be enrolled in via access code string no
grading_periods Grading Periods The grading period IDs with which this course is associated. array of integers yes
description Description The section description. string
profile_url Profile picture URL The full URL of the section's profile picture string
location Location The location of the course section. string
meeting_days Meeting Days Days of the week that this course section meets. Each day is represented by a number (Sun is 0, Sat is 7). array of integers
start_time Start Time The time this section starts on the specified meeting days, from 00:00 to 23:59 (local time). Not applicable if your school uses class period blocks (i.e. sections meet at different times on different days). string (HH:mm)
end_time End Time The time this section ends on the specified meeting days. string (HH:mm)
class_periods Class Periods The class period IDs with which this course is associated. Not applicable if your school does not use class period blocks (see start_time). array of integers
options/course_format Course Format The course format - 1 for basic (default), 2 for topic-based {1,2} default: 1
options/weighted_grading_categories Weighted Grading Categories Whether grading categories for this course are weighted; otherwise, categories will be weighted evenly. {0,1} default: 0
options/upload_document Upload Documents Whether students can upload documents to the course profile. {0,1} default: 0
options/create_discussion Create Discussion Topic Whether students can create discussion topics. {0,1} default: 0
options/member_post Post to Course Feed Whether students can post to the course feed. {0,1} default: 0
options/member_post_comment Post Course Feed Comments Whether students can post comments to course feed entries. {0,1} default: 0
synced Sync Status Whether or not this course section was synced with an external system (eg, Student Information System). The default value is 0. For synced course sections, the Section School Code field is not editable through Schoology. {0,1}

Operations

create

Create a course section

Path

POST https://api.schoology.com/v1/courses/{course_id}/sections

Content

An object containing course section fields

JSON
{
    "title": "Section 1",
    "description": "Section 1 Math",
    "section_school_code": "35",
    "grading_periods": [
        13221,
        2344,
        1246
    ]
}
XML
<body>
  <title>Section 1</title>
  <description>Section 1 Math</description>
  <section_school_code>37</section_school_code>
  <grading_periods>13221</grading_periods>
  <grading_periods>2344</grading_periods>
  <grading_periods>1246</grading_periods>
</body>
Return

An object containing course section fields

JSON
{
    "id": "5614973",
    "course_id": "1407691",
    "school_id": "344232",
    "access_code": "C2BGQ-F3TCV",
    "section_title": "Section API",
    "section_code": "",
    "section_school_code": "SA1",
    "synced": null,
    "active": 1,
    "description": "discuss REST API",
    "grading_periods": [
        13011
    ],
    "profile_url": "http:\/\/......\/course-default.gif",
    "location": "",
    "meeting_days": [
        ""
    ],
    "start_time": null,
    "end_time": null,
    "options": {
        "weighted_grading_categories": null,
        "upload_documents": null,
        "create_discussion": null,
        "member_post": null,
        "member_post_comment": null,
        "content_index_visibility": [

        ]
    },
    "links": {
        "self": "http:\/\/...\/v1\/sections\/5614973"
    }
}
XML
<?xml version="1.0" encoding="utf-8" ?>
<result>
	<id>5614973</id>
	<course_id>1407691</course_id>
	<school_id>344232</school_id>
	<access_code>C2BGQ-F3TCV</access_code>
	<section_title>Section API</section_title>
	<section_code />
	<section_school_code>SA1</section_school_code>
	<synced />
	<active>1</active>
	<description>discuss REST API</description>
	<grading_periods>13011</grading_periods>
	<profile_url>http://......course-default.gif</profile_url>
	<location />
	<meeting_days />
	<start_time />
	<end_time />
	<options>
		<weighted_grading_categories />
		<upload_documents />
		<create_discussion />
		<member_post />
		<member_post_comment />
		<content_index_visibility />
	</options>
	<links>
		<self>http://.../v1/sections/5614973</self>
	</links>
</result>

bulk create

Create multiple sections at a time. The following parameters can be added to this endpoint:

  • update_existing: Set this to 1 (e.g. ?update_existing=1) in order update existing sections, matched by the 'section_code' and 'grading_periods' fields. Without this parameter, creation will fail if a pre-existing section has the same 'section_code' for the given 'grading_periods' as a passed section object.
Path

POSThttps://api.schoology.com/v1/courses/{course_id}/sections

Content

Multiple sections can be created at a time (up to 50) by wrapping your response in 'sections' with section fields wrapped in 'section'.

JSON

{
    "sections": {
        "section": [
            {
                "title": "Section 1",
                "description": "Section 1 Math",
                "section_school_code": "35",
                "grading_periods": [
                    13221,
                    2344,
                    1246
                ]
            },
            {
                "title": "Section 2",
                "description": "Section 2 Math",
                "section_school_code": "37",
                "grading_periods": [
                    13221,
                    2344,
                    1246
                ]
            }
        ]
    }
}
XML
<body>
  <sections>
    <section>
      <title>Section 1</title>
      <description>Section 1 Math</description>
      <section_school_code>35</section_school_code>
      <grading_periods>13221</grading_periods>
      <grading_periods>2344</grading_periods>
      <grading_periods>1246</grading_periods>
    </section>
    <section>
      <title>Section 2</title>
      <description>Section 2 Math</description>
      <section_school_code>37</section_school_code>
      <grading_periods>13221</grading_periods>
      <grading_periods>2344</grading_periods>
      <grading_periods>1246</grading_periods>
    </section>
  </sections>
</body>
Return

The API endpoint (location) of each sectioncreated, or an error message if there was a problem creating the section.

JSON
{
    "section": [
        {
            "response_code": 200,
            "id": "5614975",
            "location": "http:\/\/...\/v1\/sections\/5614975",
            "section_code": "",
            "section_school_code": "SA4",
            "synced": null,
            "grading_periods": [
                13011
            ]
        },
        {
            "response_code": 200,
            "id": "5614977",
            "location": "http:\/\/...\/v1\/sections\/5614977",
            "section_code": "",
            "section_school_code": "SA5",
            "synced": null,
            "grading_periods": [
                13011
            ]
        }
    ]
}
XML
<?xml version="1.0" encoding="utf-8" ?>
<result>
  <section>
    <response_code>200</response_code>
    <id>5614975</id>
    <location>http://.../v1/sections/5614975</location>
    <section_code />
    <section_school_code>SA4</section_school_code>
    <synced />
    <grading_periods>13011</grading_periods>
  </section>
  <section>
    <response_code>200</response_code>
    <id>5614977</id>
    <location>http://.../v1/sections/5614977</location>
    <section_code />
    <section_school_code>SA5</section_school_code>
    <synced />
    <grading_periods>13011</grading_periods>
  </section>
</result>

bulk copy

Copy existing sections and their content into new or existing sections

Fields

  • source_section_id or source_section_school_code - the identifier of the section getting copied - required
  • section_id or section_school_code or section_code - required
    • if section_id is provided then we assume section exists - check permissions, make sure section has no content, and then just copy content to existing section
    • if section_school_code is provided then check if section_school_code exists.
      • If exists, check if section is empty and then copy contents to existing section.
      • If does not exist then create new section and then copy contents to new section.
    • If section_code is provided then try and create new section
  • course_id or course_code - the identifier of the parent course that the copied section will live in - required
  • title - the title of the new section - required
  • grading_periods - the grading_periods the new section with span - required
  • description - the description of the new section - optional
  • synced - If set to 1 course section fields (section_school_code, grading_periods) will not be editable. If not set, "synced" property will be inherited from source section - optional

Optional Query Parameters

  • enroll_user: Set this to 1 (e.g. ?enroll_user=1) in order enroll the user making the API call into the newly copied section
Path

POST https://api.schoology.com/v1/sections/copy

Content

JSON

{
  "sections": {
    "section": [
      {
        "source_section_id": 123456,
        "title": "Section 2A",
        "description": "Science Section 2A",
        "section_school_code": "SCI2A",
        "course_id": 5432751,
        "course_id": 1,
        "grading_periods": [
          175,
          212
        ]
      },
      {
        "source_section_school_code": "MASTERSCIENCE",
        "title": "Section 3A",
        "description": "Science Section 3A",
        "section_school_code": "SCI3A",
        "course_code": "SCIFULL",
        "grading_periods": [
          175,
          212
        ]
      }
    ]
  }
}
XML
<?xml version="1.0" encoding="utf-8" ?>
<result>
	<sections>
		<section>
			<source_section_id>123456</source_section_id>
			<title>Section 2A</title>
			<description>Science Section 2A</description>
			<section_school_code>SCI2A</section_school_code>
			<course_id>5432751</course_id>
                        <synced>1</synced>
			<grading_periods>175</grading_periods>
			<grading_periods>212</grading_periods>
		</section>
		<section>
			<source_section_school_code>MASTERSCIENCE</source_section_school_code>
			<title>Section 3A</title>
			<description>Science Section 3A</description>
			<section_school_code>SCI3A</section_school_code>
			<course_code>SCIFULL</course_code>
			<grading_periods>175</grading_periods>
			<grading_periods>212</grading_periods>
		</section>
	</sections>
</result>
Return
JSON
{
  "section": [
    {
      "section_school_code": "SCI2A",
      "grading_periods": [
        175,
        212
      ],
      "title": "Section 2A",
      "transfer_url": "https:\/\/schoology.com\/settings\/transfers",
      "response_code": 200,
      "description": "Science Section 2A"
    },
    {
      "section_school_code": "3A",
      "grading_periods": [
        175,
        212
      ],
      "title": "Section 3A",
      "transfer_url": "https:\/\/schoology.com\/settings\/transfers",
      "response_code": 200,
      "description": "Science Section 3A"
    }
  ]
}
XML
<?xml version="1.0" encoding="utf-8" ?>
<result>
	<section>
		<section_school_code>SCI2A</section_school_code>
		<grading_periods>175</grading_periods>
		<grading_periods>212</grading_periods>
		<title>Section 2A</title>
		<transfer_url>https://schoology.com/settings/transfers</transfer_url>
		<response_code>200</response_code>
		<description>Science Section 2A</description>
	</section>
	<section>
		<section_school_code>3A</section_school_code>
		<grading_periods>175</grading_periods>
		<grading_periods>212</grading_periods>
		<title>Section 3A</title>
		<transfer_url>https://schoology.com/settings/transfers</transfer_url>
		<response_code>200</response_code>
		<description>Science Section 3A</description>
	</section>
</result>

list

View a list of sections for a course (paged). The following parameters can be added to this path:

  • include_past: Set this to 1 to include sections from expired/past grading periods.

Path

GET https://api.schoology.com/v1/courses/{course_id}/sections

Content

none

Return

A collection of section objects, each one containing course section fields

JSON
{
    "section": [
        {
            "id": "4318461",
            "course_title": "Time Travel",
            "course_code": "CC106",
            "course_id": "1407691",
            "school_id": "344232",
            "access_code": "GBMWW-2QKN5",
            "section_title": "Section 9nw",
            "section_code": "",
            "section_school_code": "SI200",
            "synced": "0",
            "active": 1,
            "description": "",
            "grading_periods": [
                435,
                13011
            ],
            "profile_url": "http:\/\/...\/images\/course-default.gif",
            "location": "",
            "meeting_days": [
                ""
            ],
            "start_time": "",
            "end_time": "",
            "weight": "0",
            "options": {
                "weighted_grading_categories": "0",
                "upload_documents": "0",
                "create_discussion": "0",
                "member_post": "1",
                "member_post_comment": "1",
                "content_index_visibility": {
                    "topics": 1,
                    "assignments": 1,
                    "assessments": 1,
                    "documents": 1,
                    "discussion": 1,
                    "album": 1,
                    "pages": 1
                }
            },
            "links": {
                "self": "http:\/\/...\/v1\/sections\/4318461"
            },
            "admin": 1
        },
        {
            "id": "3719526",
            "course_title": "Time Travel",
            "course_code": "CC106",
            "course_id": "1407691",
            "school_id": "344232",
            "access_code": "88548-D5TVT",
            "section_title": "Section 8i",
            "section_code": "SC101",
            "section_school_code": "",
            "synced": "0",
            "active": 1,
            "description": "",
            "grading_periods": [
                13011
            ],
            "profile_url": "http:\/\/...\/images\/course-default.gif",
            "location": "",
            "meeting_days": [
                ""
            ],
            "start_time": "",
            "end_time": "",
            "weight": "0",
            "options": {
                "weighted_grading_categories": "0",
                "upload_documents": "0",
                "create_discussion": "0",
                "member_post": "1",
                "member_post_comment": "1",
                "content_index_visibility": {
                    "topics": 1,
                    "assignments": 1,
                    "assessments": 1,
                    "documents": 1,
                    "discussion": 1,
                    "album": 1,
                    "pages": 1
                }
            },
            "links": {
                "self": "http:\/\/...\/v1\/sections\/3719526"
            },
            "admin": 1
        }
    ],
    "total": "2",
    "links": {
        "self": "http:\/\/...\/sections?start=0&limit=20"
    }
}
XML
<?xml version="1.0" encoding="utf-8" ?>
<result>
  <section>
    <id>4318461</id>
    <course_title>Time Travel</course_title>
    <course_code>CC106</course_code>
    <course_id>1407691</course_id>
    <school_id>344232</school_id>
    <access_code>GBMWW-2QKN5</access_code>
    <section_title>Section 9nw</section_title>
    <section_code />
    <section_school_code>SI200</section_school_code>
    <synced>0</synced>
    <active>1</active>
    <description />
    <grading_periods>435</grading_periods>
    <grading_periods>13011</grading_periods>
    <profile_url>http://.../images/course-default.gif</profile_url>
    <location />
    <meeting_days />
    <start_time />
    <end_time />
    <weight>0</weight>
    <options>
      <weighted_grading_categories>0</weighted_grading_categories>
      <upload_documents>0</upload_documents>
      <create_discussion>0</create_discussion>
      <member_post>1</member_post>
      <member_post_comment>1</member_post_comment>
      <content_index_visibility>
        <topics>1</topics>
        <assignments>1</assignments>
        <assessments>1</assessments>
        <documents>1</documents>
        <discussion>1</discussion>
        <album>1</album>
        <pages>1</pages>
      </content_index_visibility>
    </options>
    <links>
      <self>http://.../v1/sections/4318461</self>
    </links>
    <admin>1</admin>
  </section>
  <section>
    <id>3719526</id>
    <course_title>Time Travel</course_title>
    <course_code>CC106</course_code>
    <course_id>1407691</course_id>
    <school_id>344232</school_id>
    <access_code>88548-D5TVT</access_code>
    <section_title>Section 8i</section_title>
    <section_code>SC101</section_code>
    <section_school_code />
    <synced>0</synced>
    <active>1</active>
    <description />
    <grading_periods>13011</grading_periods>
    <profile_url>http://...images/course-default.gif</profile_url>
    <location />
    <meeting_days />
    <start_time />
    <end_time />
    <weight>0</weight>
    <options>
      <weighted_grading_categories>0</weighted_grading_categories>
      <upload_documents>0</upload_documents>
      <create_discussion>0</create_discussion>
      <member_post>1</member_post>
      <member_post_comment>1</member_post_comment>
      <content_index_visibility>
        <topics>1</topics>
        <assignments>1</assignments>
        <assessments>1</assessments>
        <documents>1</documents>
        <discussion>1</discussion>
        <album>1</album>
        <pages>1</pages>
      </content_index_visibility>
    </options>
    <links>
      <self>http://.../v1/sections/3719526</self>
    </links>
    <admin>1</admin>
  </section>
  <total>2</total>
  <links>
    <self>http://.../sections?start=0&amp;limit=20</self>
  </links>
</result>

view

View a specified course section

Path

GET https://api.schoology.com/v1/sections/{id}

Content

none

Return

An object containing course section fields

JSON
{
    "id": "4318461",
    "course_title": "Time Travel",
    "course_code": "CC106",
    "course_id": "1407691",
    "school_id": "344232",
    "access_code": "GBMWW-2QKN5",
    "section_title": "Section 9nw",
    "section_code": "",
    "section_school_code": "SI200",
    "synced": "0",
    "active": 1,
    "description": "",
    "subject_area": "0",
    "grade_level_range_start": "12",
    "grade_level_range_end": "14",
    "grading_periods": [
        13011,
        435
    ],
    "profile_url": "http:\/\/...\/images\/course-default.gif",
    "location": "",
    "meeting_days": [
        ""
    ],
    "start_time": "",
    "end_time": "",
    "weight": "0",
    "options": {
        "weighted_grading_categories": "0",
        "upload_documents": "0",
        "create_discussion": "0",
        "member_post": "1",
        "member_post_comment": "1",
        "content_index_visibility": {
            "topics": 1,
            "assignments": 1,
            "assessments": 1,
            "documents": 1,
            "discussion": 1,
            "album": 1,
            "pages": 1
        }
    },
    "admin": 1
}
XML
<?xml version="1.0" encoding="utf-8" ?>
<result>
  <id>4318461</id>
  <course_title>Time Travel</course_title>
  <course_code>CC106</course_code>
  <course_id>1407691</course_id>
  <school_id>344232</school_id>
  <access_code>GBMWW-2QKN5</access_code>
  <section_title>Section 9nw</section_title>
  <section_code />
  <section_school_code>SI200</section_school_code>
  <synced>0</synced>
  <active>1</active>
  <description />
  <subject_area>0</subject_area>
  <grade_level_range_start>12</grade_level_range_start>
  <grade_level_range_end>14</grade_level_range_end>
  <grading_periods>13011</grading_periods>
  <grading_periods>435</grading_periods>
  <profile_url>http://.../images/course-default.gif</profile_url>
  <location />
  <meeting_days />
  <start_time />
  <end_time />
  <weight>0</weight>
  <options>
    <weighted_grading_categories>0</weighted_grading_categories>
    <upload_documents>0</upload_documents>
    <create_discussion>0</create_discussion>
    <member_post>1</member_post>
    <member_post_comment>1</member_post_comment>
    <content_index_visibility>
      <topics>1</topics>
      <assignments>1</assignments>
      <assessments>1</assessments>
      <documents>1</documents>
      <discussion>1</discussion>
      <album>1</album>
      <pages>1</pages>
    </content_index_visibility>
  </options>
  <admin>1</admin>
</result>

update

Modify a course

Path

PUT https://api.schoology.com/v1/sections/{id}

Content

An object containing course section fields

JSON
{
    "title": "Updated Section 1 title",
    "section_school_code": "35",
    "synced": "1"
}
XML
<body>
  <title>Updated Section 1 title</title>
  <section_school_code>37</section_school_code>
  <synced>1</synced>
</body>
Return

none

bulk update

Modify multiple sections

Path

PUT https://api.schoology.com/v1/sections

Content

Up to 50 sections can be updated at a time by wrapping your response in 'sections', with section fields wrapped in 'section'.


JSON

{
    "sections": {
        "section": [
            {
                "id": 123456,
                "title": "Updated Section 1 title",
                "section_school_code": "35",
                "synced": "1"
            },
            {
                "id": 123457,
                "title": "Updated Section 2 title",
                "section_school_code": "37",
                "synced": "1"
            }
        ]
    }
}
XML
<body>
  <sections>
    <section>
      <id>123456</id>
      <title>Updated Section 1 title</title>
      <section_school_code>35</section_school_code>
      <synced>1</synced>
    </section>
    <section>
      <id>123457</id>
      <title>Updated Section 2 title</title>
      <section_school_code>37</section_school_code>
      <synced>1</synced>
    </section>
  </sections>
</body>
Return

The schoology ID of each section updated, or an error message if there was a problem creating the section.

JSON
{
    "section": [
        {
            "response_code": 200,
            "id": "3719526",
            "location": "http:\/\/...\/v1\/sections\/3719526",
            "section_code": "",
            "section_school_code": "SC111",
            "synced": "0",
            "grading_periods": [
                13011
            ]
        },
        {
            "response_code": 200,
            "id": "4318461",
            "location": "http:\/\/...\/v1\/sections\/4318461",
            "section_code": "",
            "section_school_code": "SI200",
            "synced": "0",
            "grading_periods": [
                13011,
                435
            ]
        }
    ]
}
XML
<?xml version="1.0" encoding="utf-8" ?>
<result>
  <section>
    <response_code>200</response_code>
    <id>3719526</id>
    <location>http://.../v1/sections/3719526</location>
    <section_code />
    <section_school_code>SC111</section_school_code>
    <synced>0</synced>
    <grading_periods>13011</grading_periods>
  </section>
  <section>
    <response_code>200</response_code>
    <id>4318461</id>
    <location>http://.../v1/sections/4318461</location>
    <section_code />
    <section_school_code>SI200</section_school_code>
    <synced>0</synced>
    <grading_periods>13011</grading_periods>
    <grading_periods>435</grading_periods>
  </section>
</result>

delete

Delete a course (cannot be undone)

Path

DELETE https://api.schoology.com/v1/sections/{id}

Content

none

Return

none

bulk delete

Delete up to 50 sections. Comma-separated Schoology IDs are passed in the query string with the section_ids parameter.

Path

DELETE https://api.schoology.com/v1/sections

Content

none

Return

none


Other Calls

Grading Category

List the available grading categories for the given course section

Fields

FieldNameDescriptionTypeRequired
title Grading category title The name of the grading category integer
calculation_type Calculation type Whether the grades for the given category are calculated as a percentage (1) or as points (2). Only course section administrators can see this value. {1,2}
default_max_points Default max points The default number of max points given to assignments in this category. Only course section administrators can see this value. integer
default_grading_scale_id Default grading scale Id The default grading scale assigned to assignments in this category. Only course section administrators can see this value. integer
drop_lowest Drop lowest Indicates the number of lower most grades to drop when calculating the final grade for the given category. Only course section administrators can see this value. integer

List

Path

GET https://api.schoology.com/v1/sections/{id}/grading_categories

JSON
{
    "grading_category": [
        {
            "id": 3081,
            "title": "e.g. Homework",
            "delta": 0,
            "calculation_type": 2,
            "default_max_points": 100,
            "default_grading_scale_id": 0,
            "drop_lowest": 0,
            "weight": 0
        },
        {
            "id": 4341,
            "title": "xtra points",
            "delta": 0,
            "calculation_type": 2,
            "default_max_points": 100,
            "default_grading_scale_id": 0,
            "drop_lowest": 0,
            "weight": 0
        }
    ]
}
XML
<?xml version="1.0" encoding="utf-8" ?>
<result>
    <grading_category>
        <id>3081</id>
        <title>e.g. Homework</title>
        <delta>0</delta>
        <calculation_type>2</calculation_type>
        <default_max_points>100</default_max_points>
        <default_grading_scale_id>0</default_grading_scale_id>
        <drop_lowest>0</drop_lowest>
        <weight>0</weight>
    </grading_category>
    <grading_category>
        <id>4341</id>
        <title>xtra points</title>
        <delta>0</delta>
        <calculation_type>2</calculation_type>
        <default_max_points>100</default_max_points>
        <default_grading_scale_id>0</default_grading_scale_id>
        <drop_lowest>0</drop_lowest>
        <weight>0</weight>
    </grading_category>
</result>

Grading Scales

List the available grading scales for the given course section

Path

GET https://api.schoology.com/v1/sections/{id}/grading_scales

JSON
{
    "grading_scale": [
        {
            "id": 1,
            "title": "Classic five point chromatic",
            "type": 1,
            "auto_averaging": 0,
            "hide_numeric": 0,
            "scale": {
                "level": [
                    {
                        "grade": "F",
                        "cutoff": 0,
                        "average": 0
                    },
                    {
                        "grade": "D-",
                        "cutoff": 60,
                        "average": 60
                    },
                    {
                        "grade": "D",
                        "cutoff": 63,
                        "average": 63
                    },
                    {
                        "grade": "D+",
                        "cutoff": 67,
                        "average": 67
                    },
                    {
                        "grade": "C-",
                        "cutoff": 70,
                        "average": 70
                    },
                    {
                        "grade": "C",
                        "cutoff": 73,
                        "average": 73
                    },
                    {
                        "grade": "C+",
                        "cutoff": 77,
                        "average": 77
                    },
                    {
                        "grade": "B-",
                        "cutoff": 80,
                        "average": 80
                    },
                    {
                        "grade": "B",
                        "cutoff": 83,
                        "average": 83
                    },
                    {
                        "grade": "B+",
                        "cutoff": 87,
                        "average": 87
                    },
                    {
                        "grade": "A-",
                        "cutoff": 90,
                        "average": 90
                    },
                    {
                        "grade": "A",
                        "cutoff": 93,
                        "average": 93
                    },
                    {
                        "grade": "A+",
                        "cutoff": 97,
                        "average": 97
                    }
                ]
            }
        }
    ],
    "links": {
        "self": "https:\/\/...\/v1\/sections\/4318461\/grading_scales"
    }
}
XML
<?xml version="1.0" encoding="utf-8" ?>
<result>
    <grading_scale>
        <id>1</id>
        <title>Classic five point chromatic</title>
        <type>1</type>
        <auto_averaging>0</auto_averaging>
        <hide_numeric>0</hide_numeric>
        <scale>
            <level>
                <grade>F</grade>
                <cutoff>0</cutoff>
                <average>0</average>
            </level>
            <level>
                <grade>D-</grade>
                <cutoff>60</cutoff>
                <average>60</average>
            </level>
            <level>
                <grade>D</grade>
                <cutoff>63</cutoff>
                <average>63</average>
            </level>
            <level>
                <grade>D+</grade>
                <cutoff>67</cutoff>
                <average>67</average>
            </level>
            <level>
                <grade>C-</grade>
                <cutoff>70</cutoff>
                <average>70</average>
            </level>
            <level>
                <grade>C</grade>
                <cutoff>73</cutoff>
                <average>73</average>
            </level>
            <level>
                <grade>C+</grade>
                <cutoff>77</cutoff>
                <average>77</average>
            </level>
            <level>
                <grade>B-</grade>
                <cutoff>80</cutoff>
                <average>80</average>
            </level>
            <level>
                <grade>B</grade>
                <cutoff>83</cutoff>
                <average>83</average>
            </level>
            <level>
                <grade>B+</grade>
                <cutoff>87</cutoff>
                <average>87</average>
            </level>
            <level>
                <grade>A-</grade>
                <cutoff>90</cutoff>
                <average>90</average>
            </level>
            <level>
                <grade>A</grade>
                <cutoff>93</cutoff>
                <average>93</average>
            </level>
            <level>
                <grade>A+</grade>
                <cutoff>97</cutoff>
                <average>97</average>
            </level>
        </scale>
    </grading_scale>
    <links>
        <self>https://.../v1/sections/4318461/grading_scales</self>
    </links>
</result>

Grading Periods

List the available grading periods for the given course section

Path

GET https://api.schoology.com/v1/sections/{id}/grading_periods

JSON
{
    "grading_period": [
        {
            "id": 435,
            "title": "Fall 2013",
            "weight": 50,
            "start": "2013-09-01 00:00:00",
            "end": "2013-12-31 00:00:00"
        },
        {
            "id": 13011,
            "title": "Never Ending Period",
            "weight": 50,
            "start": "2012-09-17 00:00:00",
            "end": "2016-09-17 00:00:00"
        }
    ],
    "links": {
        "self": "https:\/\/...\/v1\/sections\/4318461\/grading_periods"
    }
}
XML
<?xml version="1.0" encoding="utf-8" ?>
<result>
	<grading_period>
		<id>435</id>
		<title>Fall 2013</title>
		<weight>50</weight>
		<start>2013-09-01 00:00:00</start>
		<end>2013-12-31 00:00:00</end>
	</grading_period>
	<grading_period>
		<id>13011</id>
		<title>Never Ending Period</title>
		<weight>50</weight>
		<start>2012-09-17 00:00:00</start>
		<end>2016-09-17 00:00:00</end>
	</grading_period>
	<links>
		<self>https://.../v1/sections/4318461/grading_periods</self>
	</links>
</result>