EngradeWikisEngrade API › Get Gradebook

Get Gradebook

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

Input Fields:
apitask = gradebook
apikey = Your API key
ses = The session token ID
clid = Engrade Class ID

Response fields (incomplete)
clid - Engrade Class ID
cgs - a list of the class's custom grading scale grades
cat - a list of the class's assignment categories
dls - "drop lowest score" for that assignment category
assignments - a list of gradebook assignments
assnid - the unique ID for a given assignment
students - a list of students in the class with grade information
stuid - a unique ID for a given student
scores - a list of student assignment scores correlated by stuid and assnid.
***** Request *****
POST /api/ HTTP/1.1
Host: api.engrade.com
Content-length: x

apikey=1234&apitask=gradebook&clid=5000000001&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>

<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>


<cgs>
<item>
<num>1</num>
<low>90</low>
<grade>A</grade>
</item>
<item>
<num>2</num>
<low>80</low>
<grade>B</grade>
</item>
<item>
<num>3</num>
<low>70</low>
<grade>C</grade>
</item>
<item>
<num>4</num>
<low>0</low>
<grade>F</grade>
</item>
</cgs>


<cat>
<item>
<num>1</num>
<name>Quizzes</name>
<weight></weight>
<dls>0</dls>
</item>
<item>
<num>2</num>
<name>Tests</name>
<weight></weight>
<dls>0</dls>
</item>
<item>
<num>3</num>
<name>Homework</name>
<weight></weight>
<dls>0</dls>
</item>
</cat>


<assignments>
<item>
<clid>5000001001388</clid>
<assnid>10</assnid>
<created>1288162330</created>
<creator>1000002975618</creator>
<type>1</type>
<cat>3</cat>
<cal>1</cal>
<due>20101026</due>
<points>10</points>
<title>Register on Engrade</title>
<name>Mr. Teacher</name>
<usr>teacher</usr>
<pic>1</pic>
</item>
<item>
<clid>5000001001388</clid>
<assnid>9</assnid>
<created>1287168099</created>
<creator>1000002975618</creator>
<type>1</type>
<cat>1</cat>
<cal>0</cal>
<due>20101015</due>
<points>7</points>
<title>SAT Word List Prep #1</title>
<name>Mr. Teacher</name>
<usr>teacher</usr>
<pic>1</pic>
</item>
<item>
<clid>5000001001388</clid>
<assnid>8</assnid>
<created>1287127871</created>
<creator>1000002975618</creator>
<type>1</type>
<cat>1</cat>
<cal>0</cal>
<due>20101015</due>
<points>4</points>
<title>Cell Quiz</title>
<name>Mr. Teacher</name>
<usr>teacher</usr>
<pic>1</pic>
</item>
<item>
<clid>5000001001388</clid>
<assnid>5</assnid>
<created>1281468397</created>
<creator>1000002975618</creator>
<type>1</type>
<cat>1</cat>
<cal>1</cal>
<due>20100810</due>
<points>50</points>
<title>Founding Fathers Quiz</title>
<name>Mr. Teacher</name>
<usr>teacher</usr>
<pic>1</pic>
</item>
<item>
<clid>5000001001388</clid>
<assnid>4</assnid>
<created>1281050394</created>
<creator>1000002975618</creator>
<type>1</type>
<cat>2</cat>
<cal>1</cal>
<due>20100805</due>
<points>200</points>
<title>Civil War Midterm</title>
<name>Mr. Teacher</name>
<usr>teacher</usr>
<pic>1</pic>
</item>
<item>
<clid>5000001001388</clid>
<assnid>2</assnid>
<created>1280708218</created>
<creator>1000002975618</creator>
<type>1</type>
<cat>3</cat>
<cal>1</cal>
<due>20100816</due>
<points>10</points>
<title>WWII</title>
<name>Mr. Teacher</name>
<usr>teacher</usr>
<pic>1</pic>
</item>
<item>
<clid>5000001001388</clid>
<assnid>1</assnid>
<created>1232949661</created>
<creator>1000002975618</creator>
<type>1</type>
<cat>3</cat>
<cal>1</cal>
<due>20100802</due>
<points>ec</points>
<title>Return Signed Syllabus</title>
<name>Mr. Teacher</name>
<usr>teacher</usr>
<pic>1</pic>
</item>
</assignments>


<students>
<item>
<stuid>17406</stuid>
<num>1</num>
<first>John</first>
<last>Adams</last>
<grade>A</grade>
<percent>96.1</percent>
</item>
<item>
<stuid>460798</stuid>
<num>2</num>
<first>Thomas</first>
<last>Jefferson</last>
<grade>A</grade>
<percent>97.5</percent>
</item>
<item>
<stuid>99010</stuid>
<num>3</num>
<first>Abraham</first>
<last>Lincoln</last>
<grade>B</grade>
<percent>85.4</percent>
</item>
<item>
<stuid>55678</stuid>
<num>4</num>
<first>Franklin</first>
<last>Roosevelt</last>
<grade>A</grade>
<percent>96.3</percent>
</item>
<item>
<stuid>95956</stuid>
<num>5</num>
<first>George</first>
<last>Washington</last>
<grade>A</grade>
<percent>102.5</percent>
</item>
</students>


<scores>
<item>
<assnid>1</assnid>
<stuid>17406</stuid>
<score>5</score>
</item>
<item>
<assnid>1</assnid>
<stuid>460798</stuid>
<score>m</score>
</item>
<item>
<assnid>1</assnid>
<stuid>55678</stuid>
<score>5</score>
</item>
<item>
<assnid>1</assnid>
<stuid>95956</stuid>
<score>10</score>
</item>
<item>
<assnid>1</assnid>
<stuid>99010</stuid>
<score>E</score>
</item>
<item>
<assnid>2</assnid>
<stuid>17406</stuid>
<score>1</score>
</item>
<item>
<assnid>2</assnid>
<stuid>460798</stuid>
<score>10</score>
</item>
<item>
<assnid>2</assnid>
<stuid>55678</stuid>
<score>10</score>
</item>
<item>
<assnid>2</assnid>
<stuid>95956</stuid>
<score>10</score>
</item>
<item>
<assnid>2</assnid>
<stuid>99010</stuid>
<score>10</score>
</item>
<item>
<assnid>4</assnid>
<stuid>17406</stuid>
<score>180</score>
</item>
<item>
<assnid>4</assnid>
<stuid>460798</stuid>
<score>190</score>
</item>
<item>
<assnid>4</assnid>
<stuid>55678</stuid>
<score>E</score>
</item>
<item>
<assnid>4</assnid>
<stuid>95956</stuid>
<score>190</score>
</item>
<item>
<assnid>4</assnid>
<stuid>99010</stuid>
<score>155</score>
</item>
<item>
<assnid>5</assnid>
<stuid>17406</stuid>
<score>50</score>
</item>
<item>
<assnid>5</assnid>
<stuid>460798</stuid>
<score>50</score>
</item>
<item>
<assnid>5</assnid>
<stuid>55678</stuid>
<score>40</score>
</item>
<item>
<assnid>5</assnid>
<stuid>95956</stuid>
<score>49</score>
</item>
<item>
<assnid>5</assnid>
<stuid>99010</stuid>
<score>50</score>
</item>
<item>
<assnid>8</assnid>
<stuid>17406</stuid>
<score>3</score>
</item>
<item>
<assnid>8</assnid>
<stuid>460798</stuid>
<score>2</score>
</item>
<item>
<assnid>8</assnid>
<stuid>55678</stuid>
<score>3</score>
</item>
<item>
<assnid>8</assnid>
<stuid>95956</stuid>
<score>4</score>
</item>
<item>
<assnid>8</assnid>
<stuid>99010</stuid>
<score>5</score>
</item>
<item>
<assnid>9</assnid>
<stuid>17406</stuid>
<score>11</score>
</item>
<item>
<assnid>9</assnid>
<stuid>460798</stuid>
<score>12</score>
</item>
<item>
<assnid>9</assnid>
<stuid>55678</stuid>
<score>10</score>
</item>
<item>
<assnid>9</assnid>
<stuid>95956</stuid>
<score>15</score>
</item>
<item>
<assnid>9</assnid>
<stuid>99010</stuid>
<score>12</score>
</item>
<item>
<assnid>10</assnid>
<stuid>17406</stuid>
<score>20</score>
</item>
<item>
<assnid>10</assnid>
<stuid>460798</stuid>
<score>10</score>
</item>
<item>
<assnid>10</assnid>
<stuid>55678</stuid>
<score>10</score>
</item>
<item>
<assnid>10</assnid>
<stuid>95956</stuid>
<score>10</score>
</item>
<item>
<assnid>10</assnid>
<stuid>99010</stuid>
<score>8</score>
</item>
</scores>

<success>true</success>

<time>1289054470</time>

</engrade>
Close