EngradeWikisEngrade API › Get Teacher's Classes

Get Teacher's Classes

List all of a teacher's classes.

URL: https://api.engrade.com/api/

Input Fields:
apitask = teacher-classes
apikey = contact us for your API key
ses = The session token ID

Response fields
classes = will provide a list of classes in <item> tags

In each <item> tag:
clid = the Engrade class ID of that class (you'll need this to get the class gradebook, etc.)
created = Unix timestamp of the date the class was created
folder = 3 is active, 2 is archived, 1 is trashed
syr = the school year of the class, either 2YYY or 2YYY-2YYY
gp = the 1-9 grading period of the class
name = the name of the class
code = the class code (i.e. BIO101)
***** Request *****
POST /api/ HTTP/1.1
Host: api.engrade.com
Content-length: x


apikey=1234&apitask=teacher-classes&ses=abc1234



***** Response *****
HTTP/1.0 200 OK
Date: Sat, 15 Jan 2000 14:37:12 GMT
Content-Type: text/xml
Content-Length: x

<?xml version="1.0" encoding="utf-8" ?>
<engrade>
<classes>
<item>
<superid>1000002975618</superid>
<subid>5000001800319</subid>
<supertype>teacher</supertype>
<subtype>class</subtype>
<auth>6</auth>
<joined>1286233052</joined>
<role>Teacher</role>
<clid>5000001800319</clid>
<created>1286233052</created>
<folder>2</folder>
<syr>2012</syr>
<gp>1</gp>
<gscale>9</gscale>
<weighted>1</weighted>
<showper>1</showper>
<stusort>2</stusort>
<assnsort>1</assnsort>
<round>1</round>
<stuview>1</stuview>
<stumail>0</stumail>
<teachmail>1</teachmail>
<priteach>1000002975618</priteach>
<name>Art History</name>
<code></code>
</item>
<item>
<superid>1000002975618</superid>
<subid>5000001001388</subid>
<supertype>teacher</supertype>
<subtype>class</subtype>
<auth>6</auth>
<joined>1280670949</joined>
<role>Teacher</role>
<clid>5000001001388</clid>
<created>1232949661</created>
<folder>3</folder>
<syr>2012</syr>
<gp>1</gp>
<gscale>9</gscale>
<weighted>0</weighted>
<showper>1</showper>
<stusort>2</stusort>
<assnsort>3</assnsort>
<round>4</round>
<stuview>1</stuview>
<stumail>0</stumail>
<teachmail>1</teachmail>
<priteach>1000002975618</priteach>
<name>US History</name>
<code>HIST1</code>
</item>
</classes>
<success>true</success>
<time>1289244591</time>

</engrade>
Close