Skip to main content

Attendance Resource

The OpenLoop API Attendance Resource provides a web-interface for importing daily and period attendance data into School Loop and displaying that data on student and parent dashboards.

Operations

The Attendance Resource allows applications to upload both daily and per-section student attendance data:

Operation HTTP Method Description Example URI
Create POST Add attendance https://myhs.schoolloop.com/api/attendance

 

IMPORTANT: All posts must use SSL (https). The HTTP authorization headers must be set with a valid, privileged School Loop user name, and your web-service password. For example “jsmith:mywebpass”. Note also that all parameters must be properly URL encoded. All successful web-service POST calls return HTTP status SC_OK on successful completion. An error code, and detailed message is returned if a call fails to execute for any reason.

Posting Attendance

The import-attendance operation is executed with an http POST command. The posted data must consist of attendance-records, one-per-line, in tab-separated format, with date, student permanent ID, and daily attendance code, followed by any number of section attendance “[sectionID:attendance-code]” pairs:

 

MM/dd/yyyy, permanentID, day attendanceCode, sectionID1:code1, sectionID2:code2, …

 

For example:

01/07/2014 7339962  1041:I  2042:I  3046:I  4140:I  5044:I  6042:I

01/07/2014  7340344  2041:I  3045:I  4139:I  5043:I  6043:I

01/07/2014 7341242  1028:U  2025:U  3034:U  4121:U  5024:U  5030:U

(tab-separated)

Service Response

Successful attendance-post operations return the HTTP status code SC_OK (200) and a one-line text response: “SUCCESS”. If an operation fails, an error status code and detailed message describing the failure is returned.