Overview

ampEducator gives developers access to a REST style API allowing them to access a large subset of it's features.

Before You Begin

In order to start using the API there are two things which need to be done. Both of them require administrator access to the ampEducator account.

• You must enable the API under the institution config.
• You must generate / copy the API key found under the institution config.
• Keep this key secret and do not share it with anyone.

API Request

The API is accessed using an endpoint with data as parameters. The API Key can be passed as a parameter or as an HTTP header.

ENDPOINT WITH PARAMETERS

https://{purl}.ampeducator.com/api/{resource}/{action}?apiKey={apiKey}{parameters}

ALTERNATE HTTP AUTH HEADER

Authorization: Bearer {apiKey}

CURL EXAMPLES

curl -X POST https://{purl}.ampeducator.com/api/{resource}/{action}
   -H "Content-Type: application/x-www-form-urlencoded" 
   -d "apiKey={apiKey}{parameters}"

curl -X POST https://{purl}.ampeducator.com/api/{resource}/{action}
   -H "Content-Type: application/x-www-form-urlencoded" 
   -H "Authorization: Bearer {apiKey}" 
   -d "{parameters}"

• purl is the unique identifier for the institution
• resource identifies the section of the application
• action identifies what is being requested
• apiKey is the unique secret key for the institution
• parameters are any additional pieces of data which are required for the action

JSON Post

As an alternative to posting data using parameters you can post a JSON object. To post JSON include the following headers and the JSON object as the body of your request.

ENDPOINT

https://{purl}.ampeducator.com/api/{resource}/{action}

REQUIRED HTTP HEADERS

Authorization: Bearer {apiKey}
Content-Type: application/json

CURL EXAMPLE

curl -X POST https://{purl}.ampeducator.com/api/{resource}/{action}
   -H "Content-Type: application/json" 
   -H "Authorization: Bearer {apiKey}" 
   -d "{..JSON Object..}" 

• purl is the unique identifier for the institution
• resource identifies the section of the application
• action identifies what is being requested
• apiKey is the unique secret key for the institution

API Response

The application will always respond with a JSON object in the following form:

JSON RESPONSE

{"messages": "general": [String], 
             "warning": [String],
             "errors":  [String],
             "withErrors": boolean,
             "totalMessages": 1},
{"action": String},
{"query": Map},
{"body": String},
{"page": Integer},
{"totalPages": Integer},
{"totalRecords": Integer},
{"data": Object[]}
			

• messages is an Object which will identify whether or not the requested action was successfull along with any response messages
• action is a String identifying which action was requested
• query is a Map (String key, String value) containing all the parsed query parameters
• body is a String containing the contents of the request body
• page is an Integer containing the current page of data retrieved
• totalPages is an Integer containing the current total number of pages available
• totalRecords is an Integer containing the current total number of objects available
• data contains an array of objects returned by the application

Pagination & Order

• The API will return a maximum of 100 objects per request.
• Each response will contain a totalPages field with the total number of pages available.
• You can retrieve specific pages by passing a page parameter in your request:
  • &page=# or {"page" : #}
• You can order the results by passing orderBy and orderDir parameters in your request:
  • &orderBy=... or {"orderBy" : "..."}
  • &orderDir=ASC|DESC or {"orderDir" : "ASC|DESC"}
• Only use fields with unique values for ordering otherwise the ordering can change with each request.

Notes & Tips

• Each API call indicates the required GET or POST method. Use the appropriate method to avoid errors.
• The easiest way to debug and to make sure a call is working is by posting the link in your browser. For example, try posting the following in your browser replacing the {purl} and {apiKey} with values specific to your institution. You should immediately see the results from ampEducator.
  

  https://{purl}.ampeducator.com/api/location/get?apiKey={apiKey}

/academicSession

Add, update and manage academic sessions and intakes.

Methods

Action	Required	Returns
/academicSession/get Retrieves academic sessions. GET	None	AcademicSession [ ]
/academicSession/getIntakes Retrieves program intakes for an academic session. GET	academicSessionID	ProgramIntake [ ]

Academic Session

Field	Format	Notes / Values
academicSessionID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
sessionKey	string
sessionName	string
sessionStart	yyyy-mm-dd
sessionEnd	yyyy-mm-dd
registrationStart	yyyy-mm-dd
registrationEnd	yyyy-mm-dd
studentDistinctionGroupID	int
notes	string
defaultChoice	boolean
status	string	'Active','Completed'
deleted	boolean

ProgramIntake

Field	Format	Notes / Values
programIntakeID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
academicSessionID	int
programIntakeCode	string
programIntake	string
programIntakeDate	yyyy-mm-dd
expectedEndDate	yyyy-mm-dd
deleted	boolean

/account

Add, update and manage student financial accounts..

Methods

Action	Required	Returns
Account Invoices
/account/getInvoices Retrieves account invoices. GET	None	AccountInvoice [ ]
/account/addInvoice Add a new invoice for student. POST	AddAccountInvoiceForm	AccountInvoice
/account/postInvoice Post an invoice. POST	PostAccountInvoiceForm	AccountInvoice
/account/updateInvoice Update invoice details. POST	EditAccountInvoiceForm	AccountInvoice
/account/deleteInvoice Delete an invoice. POST	DeleteAccountInvoiceForm
/account/getInvoiceItems Retrieves account invoice line items. GET	None	AccountInvoiceItem [ ]
/account/addInvoiceItem Add a new invoice item for an invoice. POST	AddAccountInvoiceItemForm	AccountInvoiceItem
/account/updateInvoiceItem Update an invoice item. POST	EditAccountInvoiceItemForm	AccountInvoiceItem
/account/deleteInvoiceItem Delete an invoice item. POST	DeleteAccountInvoiceItemForm
/account/getInvoiceItemTaxes Retrieves tax information for account invoice line items. GET	None	AccountInvoiceItemTax [ ]
Account Charges
/account/getCharges Retrieves account charges. GET	None	AccountCharge [ ]
/account/addCharge Add a new charge for a student. POST	AddAccountChargeForm	AccountCharge
/account/updateCharge Update charge details. POST	EditAccountChargeForm	AccountCharge
/account/deleteCharge Delete charge. POST	DeleteAccountChargeForm
Account Payments
/account/getPayments Retrieves account payments. GET	None	AccountPayment [ ]
/account/addPayment Add a new payment from a student. POST	AddAccountPaymentForm	AccountPayment[ ]
/account/updatePayment Update payment details. POST	EditAccountPaymentForm	AccountPayment
/account/deletePayment Delete payment. POST	DeleteAccountPaymentForm
Account Adjustments
/account/getAdjustment Retrieves account adjustments. GET	None	AccountAdjustment [ ]
/account/addAdjustment Add a new account adjustment for a student. POST	AddAccountAdjustmentForm	AccountAdjustment[ ]
/account/updateAdjustment Update adjustment details. POST	EditAccountAdjustmentForm	AccountAdjustment
/account/deleteAdjustment Delete adjustment. POST	DeleteAccountAdjustmentForm
Account Funding
/account/getFunding Retrieves account funding. GET	None	AccountFunding [ ]
/account/addFunding Add new account funding for a student. POST	AddAccountFundingForm	AccountFunding[ ]
/account/updateFunding Update funding details. POST	EditAccountFundingForm	AccountFunding
/account/deleteFunding Delete funding. POST	DeleteAccountFundingForm
Account Payment Plan
/account/getPaymentPlanItems Retrieves account payment plan items. GET	None	AccountPaymentPlanItem [ ]
/account/addPaymentPlanItem Add new account payment plan item for a student. POST	AddAccountPaymentPlanItemForm	AccountPaymentPlanItem
/account/updatePaymentPlanItem Update account payment plan item for a student. POST	EditAccountPaymentPlanItemForm	AccountPaymentPlanItem
/account/deletePaymentPlanItem Delete payment plan item for a student. POST	DeleteAccountPaymentPlanItemForm
Other
/account/getPaymentAccounts Retrieves payment accounts. GET	None	PaymentAccount [ ]
/account/getRevenueAccounts Retrieves revenue accounts. GET	None	RevenueAccount [ ]
/account/getSalesDiscountAccounts Retrieves sales discount accounts. GET	None	SalesDiscountAccount [ ]
/account/getTaxAccounts Retrieves tax accounts. GET	None	TaxAccount [ ]
/account/getFundingSources Retrieves funding sources. GET	None	FundingSource [ ]

AccountInvoice

Field	Format	Notes / Values
accountInvoiceID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
invoiceKey	string
invoiceAssignedID	string
studentID	int
locationID	int
locationMask	long
invoiceStatus	string	'Draft','Pending','Overdue','Paid','Deleted'
invoiceDate	yyyy-mm-dd
invoiceDueDate	yyyy-mm-dd
invoiceSubTotal	double
invoiceTaxAmount	double
invoiceTotalAmount	double
invoicePaymentsAppliedAmount	double
invoiceCreditsAppliedAmount	double
invoiceBalance	double
invoiceNotes	string
posted	boolean
postedDateTime	yyyy-mm-dd hh:mm:ss
postedByUserID	int
deleted	boolean

AccountInvoiceItem

Field	Format	Notes / Values
accountInvoiceItemID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
accountInvoiceID	int
locationID	int
locationMask	long
academicSessionID	int
programID	int
programCode	string
courseID	int
courseCode	string
revenueAccountCode	string
revenueAccountName	string
itemDescription	string
itemRate	double
itemQuantity	double
itemSubTotal	double
itemTaxMask	long
itemTaxDescription	string
itemTaxAmount	double
itemTotalAmount	double
itemPaymentsAppliedAmount	double
itemPaymentsAppliedTaxAmount	double
itemPaymentsAppliedTotalAmount	double
itemCreditsAppliedAmount	double
itemCreditsAppliedTaxAmount	double
itemCreditsAppliedTotalAmount	double
itemBalance	double
modified	boolean
deleted	boolean

AccountInvoiceItemTax

Field	Format	Notes / Values
accountInvoiceItemTaxID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
accountInvoiceID	int
accountInvoiceItemID	int
taxAccount	string
taxName	string
taxRate	double
taxAmount	double
taxPaymentsAppliedAmount	double
taxCreditsAppliedAmount	long
taxBalance	string
deleted	boolean

AddAccountInvoiceForm

Field	Format	Notes / Values
studentID	int	Required.
invoiceDate	yyyy-mm-dd	Required.
invoiceDueDate	yyyy-mm-dd	Required.
invoiceNotes	string

PostAccountInvoiceForm

Field	Format	Notes / Values
accountInvoiceID	int	Required.

EditAccountInvoiceForm

Field	Format	Notes / Values
accountInvoiceID	int	Required.
invoiceDate	yyyy-mm-dd	Required.
invoiceDueDate	yyyy-mm-dd	Required.
invoiceNotes	string

DeleteAccountInvoiceForm

Field	Format	Notes / Values
accountInvoiceID	int	Required.

AddAccountInvoiceItemForm

Field	Format	Notes / Values
accountInvoiceID	int	Required.
revenueAccountID	int	Required.
academicSessionID	int	(Optional) The session this invoice item should be associated with.
programID	int	(Optional) The program this invoice item should be associated with.
courseID	int	(Optional) The course this invoice item should be associated with.
itemDescription	string	Required.
itemRate	double	Required.
itemQuantity	double	Required.
taxMask	long	The summation of masks for any taxes being applied.

EditAccountInvoiceItemForm

Field	Format	Notes / Values
accountInvoiceItemID	int	Required.
accountInvoiceID	int	Required.
revenueAccountID	int	Required.
academicSessionID	int	(Optional) The session this invoice item should be associated with.
programID	int	(Optional) The program this invoice item should be associated with.
courseID	int	(Optional) The course this invoice item should be associated with.
itemDescription	string	Required.
itemRate	double	Required.
itemQuantity	double	Required.
taxMask	long	The summation of masks for any taxes being applied.

DeleteAccountInvoiceItemForm

Field	Format	Notes / Values
accountInvoiceItemID	int	Required.
accountInvoiceID	int	Required.

AccountCharge

Field	Format	Notes / Values
accountChargeID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
chargeAssignedID	string
studentID	int
locationID	int
locationMask	long
academicSessionID	int
programID	int
programCode	string
courseID	int
courseCode	string
chargeStatus	string	'Pending','Overdue','Paid','Reversed','Deleted'
chargeDate	yyyy-mm-dd
chargeDueDate	yyyy-mm-dd
chargeDescription	string
chargeAmount	double
chargePaymentsAppliedAmount	double
chargeCreditsAppliedAmount	double
chargeBalance	double
revenueAccountCode	string
revenueAccountName	string
chargeNote	string
reversed	boolean
deleted	boolean

AddAccountChargeForm

Field	Format	Notes / Values
studentID	int	Required.
revenueAccountID	int	Required.
academicSessionID	int	(Optional) The session this invoice item should be associated with.
programID	int	(Optional) The program this invoice item should be associated with.
courseID	int	(Optional) The course this invoice item should be associated with.
chargeDate	yyyy-mm-dd	Required.
chargeDueDate	yyyy-mm-dd	Required.
chargeDescription	string	Required.
chargeAmount	double	Required.
chargeNote	string

EditAccountChargeForm

Field	Format	Notes / Values
accountChargeID	int	Required.
revenueAccountIDChanged	boolean
revenueAccountID	int	Required if revenueAccountIDChanged is 'true'.
academicSessionIDChanged	boolean
academicSessionID	int	Required if academicSessionIDChanged is 'true'.
programIDChanged	boolean
programID	int	Required if programIDChanged is 'true'.
courseIDChanged	boolean
courseID	int	Required if courseIDChanged is 'true'.
chargeDate	yyyy-mm-dd	Required.
chargeDueDate	yyyy-mm-dd	Required.
chargeDescription	string	Required.
chargeAmount	double	Required.
chargeNote	string

DeleteAccountChargeForm

Field	Format	Notes / Values
accountChargeID	int	Required.

AccountPayment

Field	Format	Notes / Values
accountPaymentID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
paymentKey	string
paymentAssignedID	string
studentID	int
locationID	int
locationMask	long
applyToFunding	boolean
fundingSourceCode	string
fundingSourceName	string
paymentStatus	string	'Approved','Pending','Declined','Deleted'
paymentRefundStatus	string	'None','Partial','Refunded'
paymentAccountCode	string
paymentAccountName	string
paymentDate	yyyy-mm-dd
paymentDescription	string
paymentAmount	double
paymentRefundedAmount	double
paymentRefundsAppliedAmount	double
paymentAvailableAmount	double
paymentApplied	double
paymentBalance	double
paymentAppliedToPlan	double
paymentAppliedToPlanBalance	double
paymentNotes	string
onlinePayment	boolean
creditCardHolder	string
creditCardRef	string
merchantTransactionID	string
merchantResponseCode	string
merchantResponseText	string
merchantAuthorizationCode	string
deleted	boolean

AddAccountPaymentForm

Field	Format	Notes / Values
studentID	int	Required.
paymentAccountID	int	Required.
date	yyyy-mm-dd	Required.
description	string
amount	double	Required.
fundingSourceID	int
applyType	string	'auto', 'selectInvoices', 'selectCharges'
accountInvoiceID	int	Required when applyType is 'selectInvoices'. Repeat for multiple invoices.
accountChargeID	int	Required when applyType is 'selectCharges'. Repeat for multiple charges.
applyToPaymentPlanType	string	'auto', 'planItems', 'none'
accountPaymentPlanItemID	int	Required when applyToPaymentPlanType is 'planItems'. Repeat for multiple payment plan items.
paymentNotes	string

EditAccountPaymentForm

Field	Format	Notes / Values
accountPaymentID	int	Required.
updateApplyToFunding	boolean
fundingSourceID	int	Required when updateApplyToFunding is 'true'.
paymentDate	yyyy-mm-dd	Required.
paymentDescription	string
paymentAmount	double	Required.
paymentNotes	string

DeleteAccountPaymentForm

Field	Format	Notes / Values
accountPaymentID	int	Required.

AccountAdjustment

Field	Format	Notes / Values
accountAdjustmentID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
adjustmentAssignedID	string
studentID	int
locationID	int
locationMask	long
revenueDebitFlag	boolean
revenueCreditFlag	boolean
adjustmentType	string	'Credit','Debit','Refund'
adjustmentDate	yyyy-mm-dd
adjustmentDescription	string
adjustmentAmount	double
adjustmentApplied	double
adjustmentBalance	double
adjustmentCreditAccountCode	string
adjustmentCreditAccountName	string
adjustmentDebitAccountCode	string
adjustmentDebitAccountName	string
adjustmentNote	string
locked	boolean
deleted	boolean

AddAccountAdjustmentForm

Field	Format	Notes / Values
studentID	int	Required.
adjustmentDate	yyyy-mm-dd	Required.
adjustmentDescription	String
adjustmentAmount	double	Required.
adjustmentArType	string	'debit', 'credit', 'refund'
adjustmentDebitAccountCode	string	Required when adjustmentArType is 'credit'.
adjustmentCreditAccountCode	string	Required when adjustmentArType is 'debit'.
adjustmentPaymentAccountCode	string	Required when adjustmentArType is 'refund'.
adjustmentApplyToCreditType	string	Required when adjustmentArType is 'credit'. Options are 'noneCredit', 'selectInvoices', 'selectCharges'.
adjustmentApplyToInvoiceID	int	Required when adjustmentApplyToCreditType is 'selectInvoices'. Repeat for multiple invoices.
adjustmentApplyToChargeID	int	Required when adjustmentApplyToCreditType is 'selectCharges'. Repeat for multiple charges.
adjustmentApplyToRefundType	string	Required when adjustmentArType is 'refund'. Options are 'nonePayments', 'selectPayments'.
adjustmentApplyToPaymentID	int	Required when adjustmentApplyToRefundType is 'selectPayments'. Repeat for multiple payments.
adjustmentNote	string

EditAccountAdjustmentForm

Field	Format	Notes / Values
accountAdjustmentID	int	Required.
adjustmentDate	yyyy-mm-dd	Required.
adjustmentDescription	String
adjustmentAmount	double	Required.
adjustmentNote	string

DeleteAccountAdjustmentForm

Field	Format	Notes / Values
accountAdjustmentID	int	Required.

AccountFunding

Field	Format	Notes / Values
accountFundingID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
adjustmentAssignedID	string
studentID	int
locationID	int
locationMask	long
fundingSourceCode	string
fundingSourceName	string
fundingStatus	string	'Pending', 'Paid', 'Overdue', 'Deleted'
fundingDescription	string
fundingDueDate	yyyy-mm-dd
fundingAmount	double
fundingAmountCollected	double
fundingAmountBalance	double
fundingNotes	string
deleted	boolean

AddAccountFundingForm

Field	Format	Notes / Values
studentID	int	Required.
fundingSourceID	int	Required.
fundingDescription	string	Required.
fundingDueDate	yyyy-mm-dd	Required.
fundingAmount	double	Required.
fundingNotes	string

EditAccountFundingForm

Field	Format	Notes / Values
accountFundingID	int	Required.
fundingDescription	string	Required.
fundingDueDate	yyyy-mm-dd	Required.
fundingAmount	double	Required.
fundingNotes	string

DeleteAccountFundingForm

Field	Format	Notes / Values
accountFundingID	int	Required.

AccountPaymentPlanItem

Field	Format	Notes / Values
accountPaymentPlanItemID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
adjustmentAssignedID	string
studentID	int
paymentStatus	string	'Pending', 'Overdue', 'Paid'
paymentDescription	string
paymentDueDate	yyyy-mm-dd
paymentAmount	double
paymentPaid	double
paymentBalance	double
autoPaymentFromSaved	boolean
accountCreditCardID	double

AddAccountPaymentPlanItemForm

Field	Format	Notes / Values
studentID	int	Required.
paymentDescription	string	Required.
paymentDueDate	yyyy-mm-dd	Required.
paymentAmount	double	Required.
autoPaymentFromSaved	boolean	When true and a saved credit card exists, payment will be taken from that card.

EditAccountPaymentPlanItemForm

Field	Format	Notes / Values
accountPaymentPlanItemID	int	Required.
paymentDescription	string	Required.
paymentDueDate	yyyy-mm-dd	Required.
paymentAmount	double	Required.

DeleteAccountPaymentPlanItemForm

Field	Format	Notes / Values
accountPaymentPlanItemID	int	Required.

PaymentAccount

Field	Format	Notes / Values
paymentAccountID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
paymentAccountCode	string
paymentAccountName	string

RevenueAccount

Field	Format	Notes / Values
revenueAccountID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
accountCode	string
accountName	string
deleted	boolean

SalesDiscountAccount

Field	Format	Notes / Values
salesDiscountAccountID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
accountCode	string
accountName	string
deleted	boolean

TaxAccount

Field	Format	Notes / Values
taxAccountID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
taxMask	long
taxAccountCode	string
taxAccountName	string
taxRate	double	Between 0-100%.
deleted	boolean

FundingSource

Field	Format	Notes / Values
fundingSourceID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
code	string
name	string
deleted	boolean

/announcement

Add, update and manage general, course and program announcements.

Methods

Action	Required	Returns
/announcement/get Retrieves annnouncements. GET	None	Announcement [ ]

Announcement

Field	Format	Notes / Values
announcementID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
associateWith	string	None, Course, Program
associateWithID	int
associateWithDetails	string
Display Until	yyyy-mm-dd
pinned	boolean
announcementDate	yyyy-mm-dd
announcementTitle	string(250)
announcement	string
announcementDocumentID	int
bulkEmailID	int
ownerUserID	int
audienceRoleMask	int
locationMask	long
restrictStudentStati	boolean	Only display announcement to select student stati. Only populated when student role in audience.
studentStati	string	List of student stati to restrict announcement to. Delimited by |. Only populated when student role in audience.
deleted	boolean

/course

Add, update and manage courses.

Methods

Action	Required	Returns
Course
/course/get Retrieves courses. GET	courseID OPTIONAL	Course [ ]
/course/makeActive Reverts completed course to an active state. POST	MakeCourseActiveForm [ ]
/course/complete Completed a course. POST	CompleteCourseForm [ ]
Course Assignment
/course/getAssignments Retrieves course assignments. GET	courseID OPTIONAL courseAssignmentID OPTIONAL	CourseAssignment [ ]
/course/getAssignmentAttachments Retrieves course assignment attachments. GET	courseAssignmentID OPTIONAL courseAssignmentAttachmentID OPTIONAL	CourseAssignmentAttachment [ ]
Course Attendance
/course/getAttendanceEvents Retrieves course attendance events. GET	courseID OPTIONAL	CourseEvent [ ]
/course/addAttendanceEvent Add a new course attendance event. POST	AddCourseAttendanceEventForm	CourseEvent
/course/updateAttendanceEvent Updates an existing course attendance event. POST	EditCourseAttendanceEventForm	CourseEvent
/course/deleteAttendanceEvent Deletes an existing course attendance event. POST	courseEventID
Course Discussion
/course/getDiscussionTopics Retrieves discussion topics for a course. GET	courseID OPTIONAL courseDiscussionTopicID OPTIONAL	CourseDicussionTopic [ ]
/course/getDiscussionMessages Retrieves discussion messages for a course. GET	courseID OPTIONAL courseDiscussionTopicID OPTIONAL courseDiscussionMessageID OPTIONAL	CourseDicussionMessage [ ]
Course Grade
/course/getGrades Retrieves course grades. GET	courseID	CourseGrade [ ]
/course/getGradeGroups Retrieves course grade groups. GET	courseID	CourseGradeGroup [ ]
Course Student
/course/getStudents Retrieves course students. GET	courseID	StudentCourse [ ]
Course Tests
/course/getTests Retrieves course tests. GET	courseID OPTIONAL courseTestID OPTIONAL	CourseTest [ ]
/course/getTestSections Retrieves course test sections. GET	courseID OPTIONAL courseTestID OPTIONAL courseTestSectionID OPTIONAL	CourseTestSection [ ]
/course/getTestQuestions Retrieves course test questions. GET	courseID OPTIONAL courseTestID OPTIONAL courseTestSectionID OPTIONAL courseTestQuestionID OPTIONAL	CourseTestQuestion [ ]

Course

Field	Format	Notes / Values
courseID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
locationID	int
locationMask	long
academicYearID	int
status	string
courseCode	string(50)
courseName	string(100)
section	string(50)
version	int
courseDescription	string
courseCapacity	int
courseWeeks	int
courseHours	double
courseHoursScheduled	double
courseCredits	double
passingMark	double	0-100
finalMarkType	string
customGradingScaleID	int	When final mark is 'Custom'.
finalMarkTypeAlt	string
finalMarkCalculation	int
excludeFromGPA	boolean
excludeFromAttendance	boolean
openEnded	boolean
attendanceType	string
courseStart	yyyy-mm-dd
courseEnd	yyyy-mm-dd
selfEnrol	boolean
coursePercentageGradeAverage	double
courseGradePointAverage	double
numEnrolled	int
numCompleted	int
totalTuition	double
instructorOneID	int
instructorOneAccess	int
instructorTwoID	int
instructorTwoAccess	int
instructorThreeID	int
instructorThreeAccess	int
instructorFourID	int
instructorFourAccess	int
instructorFiveID	int
instructorFiveAccess	int
instructorSixID	int
instructorSixAccess	int
instructorSevenID	int
instructorSevenAccess	int
instructorEightID	int
instructorEightAccess	int
instructorNineID	int
instructorNineAccess	int
instructorTenID	int
instructorTenAccess	int
customField1-5	string(500)

MakeCourseActiveForm

Field	Format	Notes / Values
courseID	int	Required.
reenerollStudents	boolean
note	string

CompleteCourseForm

Field	Format	Notes / Values
courseID	int	Required.
note	string

Course Assignment

Field	Format	Notes / Values
courseAssignmentID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
courseID	int
courseGradeID	int
courseEventID	int	A course event for assignment due date.
courseAssignmentKey	string
courseAssignmentOrder	int
courseAssignmentName	string
courseAssignmentDescription	string
courseAssignmentWithDueDate	boolean
courseAssignmentDueDate	yyyy-mm-dd hh:mm:ss
courseAssignmentAllowLate	boolean
courseAssignmentLateDueDate	yyyy-mm-dd hh:mm:ss
courseAssignmentSubmissionType	int	0 None 1 Upload 2 Text 3 Video
courseAssignmentSubmissionMaxUploads	int
courseAssignmentRestrictFileType	boolean
courseAssignmentRestrictFileTypes	string
courseAssignmentTextSubmissionMinWordLength	int
courseAssignmentTextSubmissionMaxWordLength	int
courseAssignmentVideoSubmissionMinMinutes	int
courseAssignmentVideoSubmissionMaxMinutes	int
courseAssignmentPlagiarismCheck	boolean
courseAssignmentPlagiarismCheckStudentAccess	int	0 No Access 1 Access When Completed
courseAssignmentNotifyInstructorIDs	String
courseAssignmentTotalNumber	int
courseAssignmentSubmitted	int
courseAssignmentMarked	int
deleted	boolean

Course Assignment Attachment

Field	Format	Notes / Values
courseAssignmentAttachmentID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
courseAssignmentID	int
documentID	int

Course Grade

Field	Format	Notes / Values
courseGradeID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
courseID	int
courseGradeGroupID	int
gradeOrder	int
gradeName	string
gradeWeight	double
gradeOutOf	int
gradePassingMark	double
gradeType	string
courseCustomGradingScaleID	int
gradeLinkType	string
evaluationID	int
evaluationStudentAccess	boolean
testID	int
ltiToolID	int
attendanceGradeCalculation	int
attendanceGradeThreshold	double
gradePublishType	string
gradePublishDate	yyyy-mm-dd
gradePublishToggle	bolean
courseGradeAverage	double
externalGrade	double
externalGradeID	string
deleted	boolean

Course Grade Group

Field	Format	Notes / Values
courseGradeGroupID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
courseID	int
courseGradeGroupOrder	int
courseGradeGroupName	string
courseGradeGroupWeight	double
courseGradeGroupWithTakeBest	boolean
courseGradeGroupTakeBest	int
courseGradeGroupNumGrades	int
courseGradeGroupTotalGradeWeight	double
courseGradeGroupAverage	double
courseGradeGroupPublished	boolean
deleted	boolean

Course Event

Field	Format	Notes / Values
courseEventID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
sequence	int
courseID	int
courseCode	string
courseSection	string
courseLocationMask	long
eventType	string	'Attendance','Assignment','Test','CollaborationMeeting','Other'
eventTypeID	int
eventDate	yyyy-mm-dd
eventAllDay	boolean
eventStart	yyyy-mm-dd hh:mm:ss
eventEnd	yyyy-mm-dd hh:mm:ss
eventDescription	string
identifier	string
attendanceHours	double
resourceID	int
assignInstructor	boolean
assignInstructorUserID	int
restrictToInstructor	boolean
assignStudent	bolean
assignStudentID	int

AddCourseAttendanceEventForm

Field	Format	Notes / Values
courseID	int	Required.
eventDate	yyyy-mm-dd	Required.
eventStart	hh:mm:ss	Required.
eventEnd	hh:mm:ss	Required.
identifier	string
attendanceHours	double	Required.
resourceID	int
assignInstructor	boolean	If true this attendance event will be assigned to a specific instructor.
assignInstructorUserID	int	Required when assignInstructor is true.
restrictToInstructor	boolean	if true only the assigned instructor will be able to update students for this attendance event.
assignStudent	bolean	If true this attendance event will be assigned to a specific student.
assignStudentID	int	Required when assignStudent is true.

EditCourseAttendanceEventForm

Field	Format	Notes / Values
courseEventID	int	Required.
courseID	int	Required.
eventDate	yyyy-mm-dd	Required.
eventStart	hh:mm:ss	Required.
eventEnd	hh:mm:ss	Required.
identifier	string
attendanceHours	double	Required.
resourceID	int
assignInstructor	boolean	If true this attendance event will be assigned to a specific instructor.
assignInstructorUserID	int	Required when assignInstructor is true.
restrictToInstructor	boolean	if true only the assigned instructor will be able to update students for this attendance event.
assignStudent	bolean	If true this attendance event will be assigned to a specific student.
assignStudentID	int	Required when assignStudent is true.

CourseDiscussionTopic

Field	Format	Notes / Values
courseDiscussionTopicID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
courseID	int
topicDateTime	yyyy-mm-dd hh:mm:ss
topicAddedByUser	string
topicAddedByThumbnail	byte[]
topicModified	boolean
topicModifiedByUser	string
topicByInstructor	boolean
topicInstructorEndorsed	boolean
topicPrivate	boolean
topicTag	string
topicTitle	string
topicBody	string
topicMessageCount	int
topicLastMessageNumber	int
topicViews	int
deleted	boolean

CourseDiscussionMessage

Field	Format	Notes / Values
courseDiscussionMessageID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
courseID	int
courseDiscussionTopicID	int
messageReplyToMessageID	int
messageNumber	int
messageDateTime	yyyy-mm-dd hh:mm:ss
messageAddedByUser	string
messageAddedByThumbnail	byte[]
messageModified	boolean
messageModifiedByUser	string
messageByInstructor	boolean
messageInstructorEndorsed	boolean
message	string
deleted	boolean

CourseTest

Field	Format	Notes / Values
courseTestID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
courseID	int
courseGradeID	int
courseEventID	int
testName	string
testTitle	string
testDescription	string
testScheduleType	string	DateTime Schedule, Open Open Ended
testScheduleStart	yyyy-mm-dd hh:mm:ss
testScheduleEnd	yyyy-mm-dd hh:mm:ss
testScheduleStartWithCutoff	boolean
testScheduleStartCutoff	yyyy-mm-dd hh:mm:ss
testTimeLimit	boolean
testTimeLimitAmount	int	Minutes.
testQuestionRandomization	string	None, Sections, Questions, SectionsQuestions
testAnswerRandomization	boolean
testAutoMark	boolean
testStudentView	string	None, Completed, Marked
testVerifyStudent	boolean
testSecurityLevel	int	0 None, 1 Warn Only, 2 Warn & End Test
testScreenCapture	int	0 None, 1 Random, 2 Security Events
testVideoCapture	int	0 None, 1 Random, 2 Anomaly
testTotalNumber	int
testTotalCompleted	int
testTotalMarked	int
testTotalSections	int
testTotalQuestions	int
testTotalQuestionsAvailable	int
testTotalPoints	double
testTotalPointsAvailable	double
testAveragePoints	double
testAveragePercentage	double
testAverageTime	double
testPrintPageSize	string	Legal, Letter, A4, Custom
testPrintPageCustomWidth	double
testPrintPageCustomHeight	double
testPrintPagePdfTemplateID	int
testNotifyInstructors	boolean
externalProctor	boolean
externalProctorCode	string
externalProctorStatus	string
externalProctorCourseID	string
externalProctorTestID	string
externalProctorLog	string
deleted	boolean

CourseTestSection

Field	Format	Notes / Values
courseTestSectionID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
courseID	int
courseGradeID	int
courseTestID	int
testSectionOrder	int
testSectionTitle	string
testSectionInstructions	string
testSectionWithQuestionLimit	boolean
testSectionQuestionLimit	int
testSectionQuestionLimitPoints	double
testSectionQuestions	int
testSectionQuestionsAvailable	int
testSectionPoints	double
testSectionPointsAvailable	double

CourseTestQuestion

Field	Format	Notes / Values
courseTestQuestionID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
courseID	int
courseGradeID	int
courseTestID	int
courseTestSectionID	int
testQuestionOrder	int
testQuestionHtml	boolean
testQuestion	string
testQuestionType	string
testQuestionPoints	double
testQuestionPartialPoints	boolean
testQuestionNumChoices	int
testQuestionChoice1	string
testQuestionChoice2	string
testQuestionChoice3	string
testQuestionChoice4	string
testQuestionChoice5	string
testQuestionChoice6	string
testQuestionChoice7	string
testQuestionChoice8	string
testQuestionChoice9	string
testQuestionChoice10	string
testQuestionCorrectChoice	int
testQuestionFillBlankNumAnswers	int
testQuestionFillBlankAnswer1	string
testQuestionFillBlankAnswer2	string
testQuestionFillBlankAnswer3	string
testQuestionFillBlankAnswer4	string
testQuestionFillBlankAnswer5	string
testQuestionFillBlankAnswer6	string
testQuestionFillBlankAnswer7	string
testQuestionFillBlankAnswer8	string
testQuestionFillBlankAnswer9	string
testQuestionFillBlankAnswer10	string
testQuestionFillBlankAnswerCaseSensitive	boolean
testQuestionMatchingNumPremises	int
testQuestionMatchingPremise1	string
testQuestionMatchingResponse1	string
testQuestionMatchingPremise2	string
testQuestionMatchingResponse2	string
testQuestionMatchingPremise3	string
testQuestionMatchingResponse3	string
testQuestionMatchingPremise4	string
testQuestionMatchingResponse4	string
testQuestionMatchingPremise5	string
testQuestionMatchingResponse5	string
testQuestionMatchingPremise6	string
testQuestionMatchingResponse6	string
testQuestionMatchingPremise7	string
testQuestionMatchingResponse7	string
testQuestionMatchingPremise8	string
testQuestionMatchingResponse8	string
testQuestionMatchingPremise9	string
testQuestionMatchingResponse9	string
testQuestionMatchingPremise10	string
testQuestionMatchingResponse10	string
testQuestionMatchingResponseDisplayPermutation	int
testQuestionPrintNumLines	int
testQuestionWithOnScreenKeyboard	boolean
testQuestionOnScreenKeyboard	string
testQuestionTextDirectionRTL	boolean

/document

Download, upload and manage documents in your account.

Methods

Action	Required	Description
/document/get Retrieves document meta-data. GET	None	Document [ ]
/document/getData Retrieves document data encoded in Base64. GET	documentID	string
/document/add Adds a new document. POST	AddDocumentForm	Document
/document/getTags Retrieves defined document tags. GET	None	DocumentTag [ ]

AddDocumentForm

Field	Format	Notes / Values
associateWith	string	One of 'None','Course','Staff','Student'
associateWithID	int	Required when associateWith is not None.
fileName	string
fileMimeType	string
fileDescription	string
readRoleMask	int	If associateWith is None, sum of role masks which can read this document.
updateRoleMask	int	If associateWith is None, sum of role masks which can update this document.
locationMask	int	If associateWith is None, sum of locations masks which can access this document.
documentData	string	The document data encoded in Base64

Document

Field	Format	Notes / Values
documentID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
associateWith	string
associateWithID	int	0 (None) or the id of the associated object.
documentTagID	int	0 (None) or the id of the document tag.
fileName	string
fileSize	double	Given in kilobytes.
fileMimeType	string
fileDescription	string
fileExtension	string
filePath	string
internal	boolean
ownerUserID	int
readRoleMask	int
updateRoleMask	int
locationMask	int

DocumentTag

Field	Format	Notes / Values
documentTagID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
documentTag	string(100)
deleted	boolean

/event

Add, edit and manage events.

Methods

Action	Required	Returns
/event/get Retrieves events. GET	None	Event [ ]

Event

Field	Format	Notes / Values
eventID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
sequence	int	Sequentially updated on change.
associateWith	string	None, Prospect, Student
associateWithID	int	0 (None) or the id of the associated object.
associateWithStatusID	int
eventType	string	Meeting, Phone Call In, Phone Call Out, To Do, Other
eventDescription	string
eventAllDay	boolean
eventDate	yyyy-mm-dd
eventStart	yyyy-mm-dd hh:mm:ss
eventEnd	yyyy-mm-dd hh:mm:ss
resourceID	int
completed	boolean
completedByUserID	int
completedDateTime	yyyy-mm-dd hh:mm:ss
ownerUserID	int
readRoleMask	int	For 'Other' event type.
publicEvent	boolean	For 'Other' event type.
locationMask	int	For 'Other' event type.
attendeeOneID attendeeTwoID attendeeThreeID attendeeFourID attendeeFiveID attendeeSixID attendeeSevenID attendeeEightID attendeeNineID attendeeTenID	int	For 'Meeting' event type.
deleted	boolean

/group

Add, update and manage groups.

Methods

Action	Required	Returns
/group/get Retrieves groups. GET	None	Group [ ]
/group/getMembers Retrieves group members. GET	groupID	GroupMember [ ]

Group

Field	Format	Notes / Values
groupID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
groupStatus	string	Active Disabled
groupName	string(100)
groupDescription	string
numMembers	int
ownerUserID	int
readRoleMask	int
updateRoleMask	int
locationMask	long

GroupMember

Field	Format	Notes / Values
groupMemberID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
groupID	int
studentID	int

/hourClock

Retrieve information about user hour clock activity.

Methods

Action	Required	Returns
/hourClocks/getHoursDaily Retrieves the daily sign in / outs for students or staff. GET	associateWithOPTIONAL associateWithID OPTIONAL date OPTIONAL	HoursDaily [ ]
/hourClocks/getHoursDailyTotals Retrieves the daily total hours for students or staff. GET	associateWithOPTIONAL associateWithID OPTIONAL date OPTIONAL	HoursDailyTotal [ ]

HoursDaily

Field	Format	Notes / Values
hoursDailyID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
associateWith	string	Staff,Student
associateWithID	int	The id of the staff or student.
ignoreHourClock	boolean
date	yyyy-mm-dd
timeInActual	hh:mm:ss
timeOutActual	hh:mm:ss
totalMinutesActual	int
timeInAdjusted	hh:mm:ss
timeOutAdjusted	hh:mm:ss
totalMinutesAdjusted	int
withTimeInImage	boolean
timeInImageDocumentID	int
withTimeOutImage	boolean
timeOutImageDocumentID	int

HoursDailyTotal

Field	Format	Notes / Values
hoursDailyTotalID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
associateWith	string	Staff,Student
associateWithID	int	The id of the staff or student.
date	yyyy-mm-dd
timeIn	hh:mm:ss
timeOut	hh:mm:ss
totalBreakMinutes	int
totalBreakPenaltyMinutes	int
totalMinutes	int

/location

Retrieve infomation about locations.

Methods

Action	Required	Returns
/location/get Retrieves locations. GET	None	Location [ ]

Location

Field	Format	Notes / Values
locationID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
locationMask	int
status	string	'Active','Disabled'
name	string
contactPerson	string
contactPersonPosition	string
addressOne	string
addressTwo	string
city	string
province	string	Province / State
postalCode	string	PostalCode / Zip
country	string	ISO 3166-1 2 Letter Code
phone	string
fax	string
email	string
deleted	boolean

/program

Add, update and manage programs.

Methods

Action	Required	Returns
/program/get Retrieves programs. GET	None	Program [ ]
/program/getComponents Retrieves program components. GET	programID	ProgramComponent [ ]
/program/getCourses Retrieves programs courses. GET	programID programComponentID OPTIONAL	ProgramCourse [ ]

Program

Field	Format	Notes / Values
programID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
status	string	Active, Inactive
version	int
programCode	string(50)
programName	string(100)
programHours	double
programWeeks	int
programFormat	string	FullTime, PartTime
passingMark	double	0-100
crendentialCode	string(20)
credential	string
finalMarkType	string	Percentage, LetterGrade, GradePoint, PassFail, Custom
customGradingScaleID	int	When final mark is 'Custom'.
finalMarkTypeAlt	string	Percentage, LetterGrade, GradePoint, PassFail, None
totalProgramCredits	double
notes	string

Program Component

Field	Format	Notes / Values
programComponentID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
programID	int
componentName	string
requiredComponentCredits	double
totalComponentCredits	double

Program Course

Field	Format	Notes / Values
programCourseID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
programID	int
programComponentID	int
courseCode	string
courseName	string
courseCredits	double

/prospect

Add, update and manage prospect data.

Methods

Action	Required	Returns
/prospect/get Retrieves prospects. GET	None	Student [ ]
/prospect/getNotes Retrieves prospect notes. GET	studentID	StudentNote [ ]
/prospect/addComplete Adds a complete prospect record. POST	AddProspectCompleteForm	Student
/prospect/enroll Enrolls a prospect as a student. POST	EnrollProspectForm	Student

AddProspectCompleteForm

Field	Format	Notes / Values
locationID	int	Location of this student. Required.
agentID	int	The user ID for this student's agent.
admissionAdvisorID	int	The user ID for this student's admission advisor.
organizationID	int	The user ID of the organizatin the student is associated with.
internationalStudent	boolean
feeClassCode	string	Must be a valid defined fee class code. If no code is provided the default is used.
studentAssignedID	string	Optional. Must be unique. If none provided one will automatically be generated.
image	string	Optional base64 encoded of image of the student.
namePrefix	string	Mr, Ms, Mrs, Miss
firstName	string(50)	Required.
middleName	string(50)
lastName	string(50)
preferredName	string(50)
addressOne	string(100)
addressTwo	string(100)
city	string(50)
province	string(50)	Province / State
postalCode	string(25)	PostalCode / Zip
country	string(2)	ISO 3166-1 2 Letter Code
permAddressOne	string(100)
permAddressTwo	string(100)
permCity	string(100)
permProvince	string(50)	Province / State
permPostalCode	string(25)	PostalCode / Zip
permCountry	string(2)	ISO 3166-1 2 Letter Code
phone	string(50)
mobilePhoneCountry	string(2)	ISO 3166-1 2 Letter Code
mobilePhone	string(50)
workPhone	string(50)
altPhone	string(50)
email	string(100)	Required. Must be unique.
secondaryEmail	string(100)
gender	string	Optional. 'Male','Female','NB','TG','Other'
dateofBirth	yyyy-mm-dd
educationHighSchoolGraduate	boolean
educationHighSchoolGraduationYear	yyyy	Required if educationHighSchoolGraduate is true.
educationHighSchoolName	string(50)
educationHighSchoolNotes	string
educationPostSecondaryOne	boolean
educationPostSecondaryOneName	string(50)	Required if educationPostSecondaryOne is true.
educationPostSecondaryOneFrom	yyyy-mm-dd
educationPostSecondaryOneTo	yyyy-mm-dd
educationPostSecondaryOneCredential	boolean
educationPostSecondaryOneCredentialType	string	Required if educationPostSecondaryOneCredential is true. One of 'Certificate', 'Diploma', 'Bachelors', 'Masters', 'Doctorate', 'Other'
educationPostSecondaryOneNotes	string
educationPostSecondaryTwo	boolean
educationPostSecondaryTwoName	string(50)	Required if educationPostSecondaryTwo is true.
educationPostSecondaryTwoFrom	yyyy-mm-dd
educationPostSecondaryTwoTo	yyyy-mm-dd
educationPostSecondaryTwoCredential	boolean
educationPostSecondaryTwoCredentialType	string(15)	Required if educationPostSecondaryTwoCredential is true. One of 'Certificate', 'Diploma', 'Bachelors', 'Masters', 'Doctorate', 'Other'
educationPostSecondaryTwoNotes	string
emergencyContactOne	string(50)
emergencyContactOneRelationship	string	Required if contact one is populated. Must be one of 'Friend', 'Grandparent', 'Parent', 'Sibling', 'Signifigant Other', 'Spouse', 'Other'
emergencyContactOnePhone	string(25)	Required if contact one is populated.
emergencyContactOnePhoneAlt	string(25)
emergencyContactTwo	string(50)
emergencyContactTwoRelationship	string	Required if contact two is populated. Must be one of 'Friend', 'Grandparent', 'Parent', 'Sibling', 'Signifigant Other', 'Spouse', 'Other'
emergencyContactTwoPhone	string(25)	Required if contact two is populated.
emergencyContactTwoPhoneAlt	string(25)
employer	string(50)
employerContact	string(25)
employerAddressOne	string(100)
employerAddressTwo	string(100)
employerCity	string(50)
employerProvince	string(50)
employerCountry	string(2)	ISO 3166-1 2 Letter Code
employerPostalCode	string(25)
employerPhone	string(50)
employerEmail	string(100)
employerWeb	string(100)
employerPosition	string(100)
employerPositionType	string	'Full Time', 'Part Time'
employerStartDate	date	yyyy-mm-dd
employerSalary	string(100)
tag	string	Repeat for multiple tags.
leadSourceCode	string	If defined, must be a valid lead source code.
interested	string	Repeat for multiple interested programs / courses. Must be a valid interested code.
customField1-100		Format varies by selected field type. Could be one of string, boolean or date (YYYY-MM-DD) or file. For file the format is a string containing filename;base64Data.
optedIn	boolean	Student has opted into receiving emails.
duplicateMerge	boolean	When true the prospect will be merged with any duplicate existing prospects based on email.
addEvent	boolean	When true a follow up event will be added for the admission advisor.

EnrollProspectForm

Field	Format	Notes / Values
studentID	int	Required.
studentAssignedID	string	Automatically generated if left blank. Must be unique.
advisorID	int	The user ID for this student's advisor.
status	string	Required. Must be a valid defined status.
sendEmail	boolean	When true student will receive credentials by email.

/resource

Add, update and manage resources.

Methods

Action	Required	Returns
/resource/get Retrieves resources. GET	resourceID OPTIONAL	Resource [ ]
/resource/add Adds a resource. POST	AddResourceForm	Resource
/resource/update updates a resource. POST	EditResourceForm	Resource
/resource/delete Deletes a resource. POST	DeleteResourceForm	Resource

Resource

Field	Format	Notes / Values
resourceID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
resourceKey	string
locationID	int
resourceName	string
deleted	boolean

AddResourceForm

Field	Format	Notes / Values
locationID	int	Required.
resourceName	string	Required.

EditResourceForm

Field	Format	Notes / Values
resourceID	int	Required.
locationID	int	Required.
resourceName	string	Required.

DeleteResourceForm

Field	Format	Notes / Values
resourceID	int	Required.

/report

Generate and download reports.

Methods

Action	Required	Returns
/report/get Retrieves reports. GET	None	Report [ ]
/report/getParameters Retrieves report parameters. GET	ReportID	ReportParameter [ ]
/report/generate Generates a report. POST	ReportID For report parameter values pass parameterName=...value... for each parameter found in ReportParameters.
/report/download Downloads a generated report. GET	DownloadReportForm	ReportParameter [ ]

Report

Field	Format	Notes / Values
reportID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
reportDocumentID	int
status	string	None, Running, Completed, Error
lastRun	yyyy-mm-dd hh:mm:ss
reportName	string(100)
reportDescription	text
reportJRXML	string
scheduleType	string	None,Daily,Weekly,Monthly
scheduleWeekdays	int	Bitmask Values MON 1 TUE 2 WED 4 THU 8 FRI 16 SAT 32 SUN 64
scheduleMonthly	int	1-28
emailResults	boolean
emailUserID	int
emailUserTwoID	int
emailCC	string(500)	Emails (CSV)
associateWithLinkType	string	None,Student
associateReportParameterID	int
log	text
readRoleMask	int
updateRoleMask	int
locationMask	long

ReportParameter

Field	Format	Notes / Values
reportParameterID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
reportID	int
fromInstitutionReport	boolean
institutionReportKey	string
parameterOrder	int
parameterName	string
parameterLabel	string
parameterType	string
defaultValue	string
listType	string
selectQuery	string
selectOptionField	string
selectValueField	string
selectOptionCSV	string
selectValueCSV	string
selectMulti	boolean
dependentParameters	boolean
dependentParameterNames	string

DownloadReportForm

Field	Format	Notes / Values
reportID	int	Required.
reportDownloadFormat	int	1 PDF 2 CSV 3 XML 4 TXT

/staff

Retrieve infomation about staff.

Methods

Action	Required	Returns
/staff/get Retrieves staff. GET	None	Staff [ ]

Staff

Field	Format	Notes / Values
staffID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
locationID	int
locationMask	long
roleMask	int	Mask of roles assigned.
locationAccessMask	long	Mask of accessible locations.
imageDocumentID	int	The DocumentID of the image for this staff. If 0 then no image has been uploaded.
userID	int
hourClockID	int
status	string	Active,Not Active
namePrefix	string	Mr, Ms, Mrs, Miss
firstName	string
middleName	string
lastName	string
gender	string	Male,Female
addressOne	string
addressTwo	string
city	string
province	string	Province / State
postalCode	string	PostalCode / Zip
country	string	ISO 3166-1 2 Letter Code
phone	string
altPhone	string
dateofBirth	yyyy-mm-dd
email	string
sin	string	SIN / SSN / NIN
position	string
sendDailyAgenda	boolean
inbox	int	Number of unread emails in inbox.
totalHours	double
customField1-30	string
deleted	boolean

/student

Add, update and manage student data.

Methods

Action	Required	Returns
Student
/student/addComplete Adds a complete student record. POST	AddStudentCompleteForm	Student
/student/add Adds a quick student record. POST	AddStudentForm	Student
/student/get Retrieves students. GET	None	Student [ ]
/student/updateAdmin Updates admin information for a student. POST	EditStudentAdministrativeForm	Student
/student/updateDetails Updates basic information for a student. POST	EditStudentDetailsForm	Student
/student/updateEducation Updates education information for a student. POST	EditStudentEducationForm	Student
/student/updateEmergencyContacts Updates emergency contacts for a student. POST	EditStudentEmergencyContactsForm	Student
/student/updateOther Updates other misc information for a student. POST	EditStudentOtherForm	Student
/student/addStatus Adds a new status for the student. POST	AddStudentStatusForm	StudentStatus
Student Academic Session
/student/getSessions Retrieves list of student academic sessions. GET	studentID	StudentAcademicSession [ ]
/student/addSession Registers a student into a new academic session. POST	AddStudentAcademicSessionForm	StudentAcademicSession
Student Assignment
/student/getAssignments Retrieves list of student assignments. GET	studentID OPTIONAL studentAssignmentID OPTIONAL courseID OPTIONAL courseAssignmentID OPTIONAL	StudentAssignment [ ]
/student/getAssignmentAttachments Retrieves list of student assignment attachments. GET	studentAssignmentID OPTIONAL studentAssignmentAttachmentID OPTIONAL courseAssignmentID OPTIONAL	StudentAssignmentAttachment [ ]
/student/submitAssignment Submits a student assignment. POST	SubmitStudentAssignmentForm	StudentAssignment [ ]
Student Attendance
/student/getAttendance Retrieves list of student attendance records. GET	studentID OPTIONAL courseID OPTIONAL studentAttendanceID OPTIONAL attendanceDate OPTIONAL	StudentAttendance [ ]
/student/addAttendance Adds a student attendance record. POST	AddStudentAttendanceForm	StudentAttendance
/student/updateAttendance Updates a student attendance record. POST	EditStudentAttendanceForm	StudentAttendance
/student/deleteAttendance Deletes a student attendance record. POST	studentAttendanceID
/student/generateAttendanceReport Generates an attendance report for a student encoded in Base64. GET	GenerateStudentAttendanceForm	string
Student Course
/student/enrollCourse Enrolls a student into a course. POST	EnrollStudentCourseForm	StudentCourse
/student/getCourses Retrieves a list of student courses for student. GET	studentID	StudentCourse [ ]
/student/getCourse Retrieves a specific course for student. GET	studentCourseID	StudentCourse
/student/completeCourse Completes a student course. POST	CompleteStudentCourseForm	StudentCourse
/student/withdrawCourse Withdraws a student from a course. POST	WithdrawStudentCourseForm	StudentCourse
/student/reenrollCourse Reenrolls a student into a course. POST	ReenrollStudentCourseForm	StudentCourse
Student Custom Fields
/student/getCustom Retrieves list of student custom fields. GET	studentID	StudentCustomFields
/student/updateCustom Updates custom fields for a student. POST	EditStudentCustomFieldForm	StudentCustomFields
Student Employers
/student/getEmployers Retrieves list of student employers. GET	studentID	StudentEmployer
/student/addEmployer Adds a new student employer. POST	AddStudentEmployerForm	StudentEmployer
/student/updateEmployer Updates a student employer. POST	EditStudentEmployerForm	StudentEmployer
/student/deleteEmployer Deletes a student employer. POST	DeleteStudentEmployerForm
Student Grades
/student/getGrades Retrieves a list of student grades. GET	studentID OPTIONAL courseID OPTIONAL courseGradeID OPTIONAL courseGradeGroupID OPTIONAL	StudentGrade [ ]
/student/getGradeItems Retrieves a list of student grade items. GET	studentID OPTIONAL studentGradeID OPTIONAL courseID OPTIONAL courseGradeID OPTIONAL courseGradeGroupID OPTIONAL	StudentGradeItem [ ]
Student Program
/student/getPrograms Retrieves a list of student programs for student. GET	studentID	StudentProgram [ ]
/student/getProgram Retrieves a specific program for student. GET	studentProgramID	StudentProgram
/student/enrollProgram Enrolls a student into a new program. POST	EnrollStudentProgramForm	StudentProgram
/student/updateProgram Updates details of a student program. POST	EditStudentProgramForm	StudentProgram
/student/completeProgram Completes a student program. POST	CompleteStudentProgramForm	StudentProgram
/student/withdrawProgram Withdraws a student from a program. POST	WithdrawStudentProgramForm	StudentProgram
/student/reenrollProgram Reenrols a student in a withdrawn program. POST	ReenrollStudentProgramForm	StudentProgram
/student/makeProgramPrimary Makes a program the student's primary program. POST	studentProgramID	StudentProgram
Student Test
/student/getTests Gets a lits of student tests. GET	courseID OPTIONAL courseTestID OPTIONAL studentID OPTIONAL studentTestID OPTIONAL	StudentTest []
/student/getTestSections Gets a lits of student test sections. GET	courseID OPTIONAL courseTestID OPTIONAL studentID OPTIONAL studentTestID OPTIONAL studentTestSectionID OPTIONAL	StudentTestSection []
/student/getTestQuestions Gets a lits of student test questions. GET	courseID OPTIONAL courseTestID OPTIONAL studentID OPTIONAL studentTestID OPTIONAL studentTestSectionID OPTIONAL studentTestQuestionID OPTIONAL	StudentTestQuestion []
Student Transcript
/student/generateTranscript Generates a PDF transcript for the student encoded in Base64. POST	GenerateStudentTranscriptForm	string
Student Transfer Credit
/student/getTransferCredits Retrieves a list of student transfer credits for student. GET	studentID	StudentTransferCredit [ ]
/student/addTransferCredit Adds a new studend transfer credit. POST	AddStudentTransferCreditForm	StudentTransferCredit
/student/updateTransferCredit Updates an existing student transfer credit. POST	EditStudentTransferCreditForm	StudentTransferCredit
/student/deleteTransferCredit Deletes an existing student transfer credit. POST	DeleteStudentTransferCreditForm

AddStudentCompleteForm

Field	Format	Notes / Values
locationID	int	Location of this student. Required.
agentID	int	The user ID for this student's agent.
admissionAdvisorID	int	The user ID for this student's admission advisor.
advisorID	int	The user ID for this student's advisor.
organizationID	int	The user ID of the organizatin the student is associated with.
internationalStudent	boolean
feeClassCode	string	Must be a valid defined fee class code. If no code is provided the default is used.
hourClockID	int	The hour clock ID for this student.
studentAssignedID	string	Optional. Must be unique. If none provided one will automatically be generated.
status	string	If none provided the default status will be used.
image	string	Optional base64 encoded of image of the student.
namePrefix	string	Mr, Ms, Mrs, Miss
firstName	string(50)	Required.
middleName	string(50)
lastName	string(50)
preferredName	string(50)
addressOne	string(100)
addressTwo	string(100)
city	string(50)
province	string(50)	Province / State
postalCode	string(25)	PostalCode / Zip
country	string(2)	ISO 3166-1 2 Letter Code
permAddressOne	string(100)
permAddressTwo	string(100)
permCity	string(100)
permProvince	string(50)	Province / State
permPostalCode	string(25)	PostalCode / Zip
permCountry	string(2)	ISO 3166-1 2 Letter Code
phone	string(50)
mobilePhoneCountry	string(2)	ISO 3166-1 2 Letter Code
mobilePhone	string(50)
workPhone	string(50)
altPhone	string(50)
email	string(100)	Required. Must be unique.
secondaryEmail	string(100)
gender	string	Optional. 'Male','Female','NB','TG','Other'
dateofBirth	yyyy-mm-dd
educationHighSchoolGraduate	boolean
educationHighSchoolGraduationYear	yyyy	Required if educationHighSchoolGraduate is true.
educationHighSchoolName	string(50)
educationHighSchoolNotes	string
educationPostSecondaryOne	boolean
educationPostSecondaryOneName	string(50)	Required if educationPostSecondaryOne is true.
educationPostSecondaryOneFrom	yyyy-mm-dd
educationPostSecondaryOneTo	yyyy-mm-dd
educationPostSecondaryOneCredential	boolean
educationPostSecondaryOneCredentialType	string	Required if educationPostSecondaryOneCredential is true. One of 'Certificate', 'Diploma', 'Bachelors', 'Masters', 'Doctorate', 'Other'
educationPostSecondaryOneNotes	string
educationPostSecondaryTwo	boolean
educationPostSecondaryTwoName	string(50)	Required if educationPostSecondaryTwo is true.
educationPostSecondaryTwoFrom	yyyy-mm-dd
educationPostSecondaryTwoTo	yyyy-mm-dd
educationPostSecondaryTwoCredential	boolean
educationPostSecondaryTwoCredentialType	string(15)	Required if educationPostSecondaryTwoCredential is true. One of 'Certificate', 'Diploma', 'Bachelors', 'Masters', 'Doctorate', 'Other'
educationPostSecondaryTwoNotes	string
emergencyContactOne	string(50)
emergencyContactOneRelationship	string	Required if contact one is populated. Must be one of 'Friend', 'Grandparent', 'Parent', 'Sibling', 'Signifigant Other', 'Spouse', 'Other'
emergencyContactOnePhone	string(25)	Required if contact one is populated.
emergencyContactOnePhoneAlt	string(25)
emergencyContactTwo	string(50)
emergencyContactTwoRelationship	string	Required if contact two is populated. Must be one of 'Friend', 'Grandparent', 'Parent', 'Sibling', 'Signifigant Other', 'Spouse', 'Other'
emergencyContactTwoPhone	string(25)	Required if contact two is populated.
emergencyContactTwoPhoneAlt	string(25)
employer	string(50)
employerContact	string(25)
employerAddressOne	string(100)
employerAddressTwo	string(100)
employerCity	string(50)
employerProvince	string(50)
employerCountry	string(2)	ISO 3166-1 2 Letter Code
employerPostalCode	string(25)
employerPhone	string(50)
employerEmail	string(100)
employerWeb	string(100)
employerPosition	string(100)
employerPositionType	string	'Full Time', 'Part Time'
employerStartDate	date	yyyy-mm-dd
employerSalary	string(100)
tag	string	Repeat for multiple tags.
leadSourceCode	string	If defined, must be a valid lead source code.
interested	string	Repeat for multiple interested programs / courses. Must be a valid interested code.
customField1-100		Format varies by selected field type. Could be one of string, boolean or date (YYYY-MM-DD) or file. For file the format is a string containing filename;base64Data.
userName	string	Optional. Must be unique. If not present one will be generated.
userPass	string	Optional. If not present one will be generated.
optedIn	boolean	Student has opted into receiving emails.
emailLoginInfo	boolean	When true student will receive an email with their login credentials.

AddStudentForm

Field	Format	Notes / Values
namePrefix	string	Mr, Ms, Mrs, Miss
name	string(150)	Required.
phone	string(50)
email	string(100)	Required. Must be unique.
dateofBirth	yyyy-mm-dd
overrideStudentAssignedID	boolean	If true you must provide a student ID.
studentAssignedID	string(100)	Required if override is set to true. Must be unique.
locationID	int	Location of this student. Required.
status	string	Current status of student. If not provided the default status is used.
advisorID	int	The user ID for this student's advisor.
agentID	int	The user ID for this student's agent.
tag	string	Repeat for multiple tags.
leadSourceCode	string
interested	string	The interested code for any courses or programs. Must be a valid interested code. Repeat for multiple interests.
emailLoginInfo	boolean	If true the student will receive an email with their login information.

AddStudentAcademicSessionForm

Field	Format	Notes / Values
studentID	int	Required.
academicSessionID	int	Required.
registrationDate	yyyy-mm-dd	Required.
makeCurrent	boolean	When true will set this academic session as student's current session.
chargeFees	int	0 No Fees, 1 Charge Account, 2 Invoice Account
accountInvoiceID	int	Optional. Will add fees to provided invoice.
note	string

EditStudentAdministrativeForm

Field	Format	Notes / Values
studentID	int	Required.
studentAssignedID	string	Required. Must be unique.
locationIDChanged	boolean
locationID	int	Required if locationIDChanged is true changed.
admissionAdvisorIDChanged	boolean	Only applicable if student type is 'Prospect'.
admissionAdvisorID	int	Required if admissionAdvisorIDChanged is true. Only applicable if student type is 'Prospect'.
advisorIDChanged	boolean	Only applicable if student type is 'Student'.
advisorID	int	Required if advisorIDChanged is true. Only applicable if student type is 'Student'.
agentIDChanged	boolean
agentID	int	Required if agentIDChanged is true.
feeClassCodeChanged	boolean
feeClassCode	string	Required if feeClassCodeChanged is true. Must be a valid defined fee class code.
internationalStudent	boolean
hourClockID	int	The hour clock ID for this student.

EditStudentCustomFieldForm

Field	Format	Notes / Values
studentID	int	Required.
customField1-100		Format varies by selected field type. Could be one of string, boolean or date (YYYY-MM-DD) or file. For file the format is a string containing filename;base64Data. Note that all custom fields are updated.

EditStudentDetailsForm

Field	Format	Notes / Values
studentID	int	Required.
namePrefix	string	Mr, Ms, Mrs, Miss
firstName	string(50)	Required.
middleName	string(50)
lastName	string(50)
addressOne	string(100)
addressTwo	string(100)
city	string(50)
province	string(50)	Province / State
postalCode	string(25)	PostalCode / Zip
country	string(2)	ISO 3166-1 2 Letter Code
permAddressOne	string(100)
permAddressTwo	string(100)
permCity	string(100)
permProvince	string(50)	Province / State
permPostalCode	string(25)	PostalCode / Zip
permCountry	string(2)	ISO 3166-1 2 Letter Code
phone	string(50)
mobilePhoneCountry	string(2)	ISO 3166-1 2 Letter Code. Required if mobile phone is present.
mobilePhone	string(50)
workPhone	string(50)
altPhone	string(50)
email	string(100)	Required.
secondaryEmail	string(100)
gender	string	Optional. 'Male','Female','NB','TG','Other'.
dateofBirth	yyyy-mm-dd
sin	string(25)	SIN / SSN / NIN depending on country.

EditStudentEducationForm

Field	Format	Notes / Values
studentID	int	Required.
educationHighSchoolGraduate	boolean
educationHighSchoolGraduationYear	yyyy	Required if educationHighSchoolGraduate is true.
educationHighSchoolName	string(50)
educationHighSchoolNotes	string
educationPostSecondaryOne	boolean
educationPostSecondaryOneName	string(50)	Required if educationPostSecondaryOne is true.
educationPostSecondaryOneFrom	yyyy-mm-dd
educationPostSecondaryOneTo	yyyy-mm-dd
educationPostSecondaryOneCredential	boolean
educationPostSecondaryOneCredentialType	string	Required if educationPostSecondaryOneCredential is true. One of 'Certificate', 'Diploma', 'Bachelors', 'Masters', 'Doctorate', 'Other'
educationPostSecondaryOneNotes	string
educationPostSecondaryTwo	boolean
educationPostSecondaryTwoName	string(50)	Required if educationPostSecondaryTwo is true.
educationPostSecondaryTwoFrom	yyyy-mm-dd
educationPostSecondaryTwoTo	yyyy-mm-dd
educationPostSecondaryTwoCredential	boolean
educationPostSecondaryTwoCredentialType	string(15)	Required if educationPostSecondaryTwoCredential is true. One of 'Certificate', 'Diploma', 'Bachelors', 'Masters', 'Doctorate', 'Other'
educationPostSecondaryTwoNotes	string

EditStudentEmergencyContactsForm

Field	Format	Notes / Values
studentID	int	Required.
emergencyContactOne	string(50)
emergencyContactOneRelationship	string	Required if contact one is populated. Must be one of 'Friend', 'Grandparent', 'Parent', 'Sibling', 'Signifigant Other', 'Spouse', 'Other'
emergencyContactOnePhone	string(25)	Required if contact one is populated.
emergencyContactOnePhoneAlt	string(25)
emergencyContactTwo	string(50)
emergencyContactTwoRelationship	string	Required if contact two is populated. Must be one of 'Friend', 'Grandparent', 'Parent', 'Sibling', 'Signifigant Other', 'Spouse', 'Other'
emergencyContactTwoPhone	string(25)	Required if contact two is populated.
emergencyContactTwoPhoneAlt	string(25)

EditStudentOtherForm

Field	Format	Notes / Values
studentID	int	Required.
leadSourceCode	string	If defined, must be a valid lead source code.
tag	string	Repeat for multiple tags.
interested	string	Repeat for multiple interested programs / courses. Must be a valid interested code.
expectedProgramIDChanged	boolean
expectedProgramID	int	Required when expectedProgramIDChanged is true.
expectedProgramAcademicSessionIDChanged	boolean
expectedProgramAcademicSessionID	int	Required when expectedProgramAcademicSessionIDChanged is true.
expectedProgramIntakeIDChanged	boolean
expectedProgramIntakeID	int	Required when expectedProgramIntakeIDChanged is true.
expectedProgramStartDate	yyyy-mm-dd
expectedProgramEnrollDate	yyyy-mm-dd
expectedProgramEndDate	yyyy-mm-dd
expectedDate	yyyy-mm-dd
expectedRevenue	double
expectedRevenueProbability	double	0-100
expectedRevenueDate	yyyy-mm-dd

Student

Field	Format	Notes / Values
studentID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
studentKey	string
studentType	string	'Prospect','Student','Public','Duplicate'.
enrolledFromProspect	boolean
enrolledByUserID	int
enrolledDateTime	yyyy-mm-dd hh:mm:ss
userID	int	UserID of this student.
locationAccessMask	long
source	string	API, Application,Form,Import,External Course,Public Form,Web
sourceDetails	string(100)	Details of the source.
sourceIP	string(100)
locationID	int	Location of this student.
locationMask	long
submittedByAgent	boolean
submittedByAgencyID	int
submittedByAgentID	int
agencyID	int
agentID	int
admissionAdvisorID	int
advisorID	int	UserID of the assigned student advisor.
organizationID	int
studentAssignedID	string(100)
imageDocumentID	int	The DocumentID of the image for this student. If 0 then no image has been uploaded.
imageThumbnail	string	Thumbnail of student image. Base64 encoded, jpeg, 30x45.
namePrefix	string	Mr, Ms, Mrs, Miss
firstName	string(50)
middleName	string(50)
lastName	string(50)
preferredName	string(50)
addressOne	string(100)
addressTwo	string(100)
city	string(50)
province	string(50)	Province / State
postalCode	string(25)	PostalCode / Zip
country	string(2)	ISO 3166-1 2 Letter Code
permAddressOne	string(100)
permAddressTwo	string(100)
permCity	string(100)
permProvince	string(50)	Province / State
permPostalCode	string(25)	PostalCode / Zip
permCountry	string(2)	ISO 3166-1 2 Letter Code
phone	string(50)
mobilePhone	string(50)
workPhone	string(50)
altPhone	string(50)
email	string(100)
secondaryEmail	string(100)
gender	string
dateofBirth	yyyy-mm-dd
sin	string(25)	SIN / SSN / NIN depending on country.
internationalStudent	boolean	true, false
feeClassCode	string
studentLeadStageID	int
leadStageKey	string
leadStage	string
leadStageDateTime	yyyy-mm-dd hh:mm:ss
leadStageStatus	string	'NA','Completed','Not Completed'
leadStageReasonCode	string
leadStageReason	string
leadStageCompleted	boolean
leadSourceCategoryCode	string
leadSourceCode	string
interested	string	Delimited by |
tag	string	Delimited by |
hourClockID	int	The id of the assigned hour clock.
baseHours	double
lastContactDateTime	yyyy-mm-dd hh:mm:ss
lastContactType	string	'Email','Meeting','Phone','Sms'
lastContactTypeID	int
lastContactByUserID	int
expectedProgramID	int
expectedProgramAcademicSessionID	int
expectedProgramIntakeID	int
expectedProgramStartDate	yyyy-mm-dd
expectedProgramEnrollDate	yyyy-mm-dd
expectedProgramEndDate	yyyy-mm-dd
expectedDate	yyyy-mm-dd
expectedRevenue	double
expectedRevenueProbability	double	0-100
expectedRevenueDate	yyyy-mm-dd
educationHighSchoolGraduate	boolean
educationHighSchoolGraduationYear	yyyy
educationHighSchoolName	string(50)
educationHighSchoolNotes	string
educationPostSecondaryOne	boolean
educationPostSecondaryOneName	string(50)
educationPostSecondaryOneFrom	yyyy-mm-dd
educationPostSecondaryOneTo	yyyy-mm-dd
educationPostSecondaryOneCredential	boolean
educationPostSecondaryOneCredentialType	string(15)
educationPostSecondaryOneNotes	string
educationPostSecondaryTwo	boolean
educationPostSecondaryTwoName	string(50)
educationPostSecondaryTwoFrom	yyyy-mm-dd
educationPostSecondaryTwoTo	yyyy-mm-dd
educationPostSecondaryTwoCredential	boolean
educationPostSecondaryTwoCredentialType	string(15)
educationPostSecondaryTwoNotes	string
emergencyContactOne	string(50)
emergencyContactOneRelationship	string(30)
emergencyContactOnePhone	string(25)
emergencyContactOnePhoneAlt	string(25)
emergencyContactTwo	string(50)
emergencyContactTwoRelationship	string(30)
emergencyContactTwoPhone	string(25)
emergencyContactTwoPhoneAlt	string(25)
employer	string(50)
employerContact	string(25)
employerAddressOne	string(100)
employerAddressTwo	string(100)
employerCity	string(50)
employerProvince	string(50)
employerCountry	string(2)	ISO 3166-1 2 Letter Code
employerPostalCode	string(25)
employerPhone	string(50)
employerEmail	string(100)
employerWeb	string(100)
employerPosition	string(100)
employerPositionType	string	Full Time, Part Time
employerStartDate	date	yyyy-mm-dd
employerSalary	string(100)
currentStatus	string	Current status of student.
currentStatusDateTime	yyyy-mm-dd hh:mm:ss
withHolds	boolean
holdCodes
academicSessionIDs	json
currentFollowUpDate	yyyy-mm-dd
currentStudentProgramID	int
currentProgramIntakeID	int
currentProgramID	int
currentProgramCode	string
currentProgramName	string
currentProgramStatus	string
currentProgramStatusReasonCode	string
currentProgramStatusReason	string
currentProgramSubStatus	string
currentProgramStartDate	yyyy-mm-dd
currentProgramExpectedEndDate	yyyy-mm-dd
currentLastDayOfAttendance	yyyy-mm-dd
hasActiveEnrollments	boolean
currentNumEnrolledCourses	boolean
currentNumCompletedCourses	boolean
totalCreditsEarned	double
percentageGradeAverage	double
gradePointAverage	double
academicStatus	string
attendanceStatusSource	string
attendanceStatusSourceUserID	int
attendanceStatusDate	yyyy-mm-dd
attendanceStatusAverageAttendance	double
attendanceStatusAverageLates	double
attendanceStatusAbsences	int
attendanceStatusLates	int
attendanceStatusMarginalCourses	int
attendanceStatusReviewCourses	int
attendanceStatusCalculated	string
attendanceStatusReasonCalculated	int
attendanceStatus	string
attendanceStatusMovement	int
attendanceStatusTrend	int
attendanceStatusReason	int
attendanceStatusWeeks	int
attendanceStatusPolicy	json
accountBalance	double
accountBalanceDueCurrent	double
accountBalanceDue30Days	double
accountBalanceDue60Days	double
accountBalanceDue90Days	double
accountBalanceDue	double
accountUnappliedPayments	double
accountDeposits	double
accountFundingBalance	double
accountFundingBalanceDue	double
accountPaymentPlanBalance	double
accountPaymentPlanBalanceDueCurrent	double
accountPaymentPlanBalanceDue30Days	double
accountPaymentPlanBalanceDue60Days	double
accountPaymentPlanBalanceDue90Days	double
accountPaymentPlanBalanceDue	double
accountTotalRevenue	double
accountStatus	string
accountStatusOverride	boolean
accountStatusOverrideDateTime	yyyy-mm-dd
accountStatusOverrideUserID	int
accountStatusOverrideNote	string
optedIn	boolean	Student opted into receiving emails. true, false
optedInDate	yyyy-mm-dd
optedInIP	string
optedInNote	string
optedOut	boolean	Student opted out of receiving emails. true, false
optedOutDate	yyyy-mm-dd
optedOutNote	string
deleted	boolean

Student Custom Fields

Field	Format	Notes / Values
studentCustomFieldsID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
studentID	int
customField1-100		Format varies by selected field type. Could be one of string, boolean or date (YYYY-MM-DD).

StudentEmployer

Field	Format	Notes / Values
studentEmployerID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
studentID	int
employerKey	string
employerCurrent	boolean
employer	string
employerContact	string
employerAddressOne	string
employerAddressTwo	string
employerCity	string
employerProvince	string
employerPostalCode	string
employerCountry	string	ISO 3166-1 2 Letter Code
employerPhone	string
employerEmail	string
employerWeb	string
employerPosition	string
employerPositionType	string	Part Time,Full Time
employerStartDate	yyyy-mm-dd
employerSalary	string
deleted	boolean

AddStudentEmployerForm

Field	Format	Notes / Values
studentID	int	Required.
employerCurrent	boolean
employer	string	Required.
employerContact	string
employerAddressOne	string
employerAddressTwo	string
employerCity	string
employerProvince	string
employerPostalCode	string
employerCountry	string	ISO 3166-1 2 Letter Code
employerPhone	string
employerEmail	string
employerWeb	string
employerPosition	string
employerPositionType	string	Part Time,Full Time
employerStartDate	yyyy-mm-dd
employerSalary	string

EditStudentEmployerForm

Field	Format	Notes / Values
studentEmployerID	int	Required.
employerCurrent	boolean
employer	string	Required.
employerContact	string
employerAddressOne	string
employerAddressTwo	string
employerCity	string
employerProvince	string
employerPostalCode	string
employerCountry	string	ISO 3166-1 2 Letter Code
employerPhone	string
employerEmail	string
employerWeb	string
employerPosition	string
employerPositionType	string	Part Time,Full Time
employerStartDate	yyyy-mm-dd
employerSalary	string

DeleteStudentEmployerForm

Field	Format	Notes / Values
studentEmployerID	int	Required.

StudentGrade

Field	Format	Notes / Values
studentGradeID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
studentID	int
courseID	int
courseGradeID	int
courseGradeGroupID	int
gradeGroup	boolean
percentageGrade	double
percentageGradeWeighted	double
percentageGradeWeightedInterim	double
numGrades	int
gradesEntered	int
completed	boolean
deleted	boolean

StudentGradeItem

Field	Format	Notes / Values
studentGradeItemID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
studentID	int
studentGradeID	int
studentAssignmentID	int
studentAssignmentSubmitted	boolean
studentAssignmentSubmissionStatus	string
studentEvaluationID	int
studentTestID	int
studentTestCompleted	boolean
studentTestMarked	boolean
studentTestStatus	string
studentLtiToolID	int
studentLtiToolOutcomeReceived	boolean
studentLtiToolOutcomeStatus	status
courseID	int
courseGradeID	int
courseGradeGroupID	int
courseAssignmentID	int
courseEvaluationID	int
courseTestID	int
courseLtiToolID	int
percentageGrade	double
percentageGradeWeighted	double
instructorComments	string
gradeDropped	boolean
deleted	boolean

StudentAcademicSession

Field	Format	Notes / Values
studentAcademicSessionID	int
studentID	int
academicSessionID	int
registeredByUserID	int
registrationDate	yyyy-mm-dd
registrationNote	string
currentAcademicSession	boolean
creditsAttempted	double
creditsEarned	double
percentageGradeAverage	double
gradePointAverage	double
letterGrade	string
distinction	string
courseHours	double
timeclockHours	double
attended	int
absences	int
lates	int
avgAttendance	double
avgAbsences	double
avgLates	double

StudentAssignment

Field	Format	Notes / Values
studentAssignmentID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
studentID	int
studentGradeID	int
studentGradeItemID	int
courseID	int
courseGradeID	int
courseAssignmentID	int
studentAssignmentSubmissionStatus	string
studentAssignmentTextSubmission	string
studentAssignmentTextSubmissionDocumentID	int
studentAssignmentTextSubmissionAttachmentID	int
studentAssignmentVideoSubmissionDocumentID	int
studentAssignmentNumAttachments	int
studentAssignmentSubmitted	boolean
studentAssignmentSubmittedDate	yyyy-mm-dd hh:mm:ss
studentAssignmentSubmittedNotes	string
studentAssignmentSubmissionKey	string
studentAssignmentFeedback	boolean
studentAssignmentFeedbackComments	string
studentAssignmentFeedbackDateTime	yyyy-mm-dd hh:mm:ss
studentAssignmentFeedbackByUserID	int
studentAssignmentFeedbackDocumentID	int
studentAssignmentMarked	boolean
overrideStudentAssignmentSubmissionStatus	boolean
overrideStudentAssignmentSubmissionStatusUserID	int
overrideStudentAssignmentSubmissionStatusDate	yyyy-mm-dd hh:mm:ss
overrideStudentAssignmentSubmissionStatusReason	string
overrideStudentAssignmentSubmissionPrevStatusAssigned	string
deleted	boolean

StudentAssignmentAttachment

Field	Format	Notes / Values
studentAssignmentAttachmentID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
studentAssignmentID	int
studentID	int
documentID	int
uploadedDate	yyyy-mm-dd hh:mm:ss
instructorUpload	boolean
plagiarismCheck	boolean
plagiarismChecker	string
plagiarismCheckID	string
plagiarismCheckComplete	boolean
plagiarismCheckStatus	string
plagiarismCheckMatchPercentage	double
plagiarismCheckReportPdfID	string
plagiarismCheckReportPdfDocumentID	int
plagiarismCheckLog	string
deleted	boolean

SubmitStudentAssignmentForm

Field	Format	Notes / Values
studentAssignmentID	int	Required.
studentAssignmentUploadedNotes	string
documentName	string	Required.
documentData	string	The document data encoded in Base64. Required.
sendNotification	boolean	If true a notification of submission is sent to the student

StudentAttendance

Field	Format	Notes / Values
studentAttendanceID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
studentID	int
courseID	int
courseEventID	int
studentEvaluationID	int
collaborationID	int
attendanceDate	yyyy-mm-dd
attendanceScheduledHours	double
attendancePenaltyCode	string
attendancePenaltyReason	string
attendancePenaltyMinutes	int
attendancePenaltyLateMinutes	int
attendanceHours	double
present	boolean
late	boolean
penalty	boolean
authorisedAbsence	boolean
hourClockAttendance	boolean
makeUpAttendance	boolean
studentEvaluationAttendance	boolean
collaborationAttendance	boolean
note	string

AddStudentAttendanceForm

Field	Format	Notes / Values
studentID	int	Required.
courseID	int	Required.
courseEventID	int	Required.
attendancePenaltyCode	string	Required when penalty is true. Must be a code already defined.
attendancePenaltyMinutes	int	Required when attendancePenaltyCode is set.
attendancePenaltyLateMinutes	int	Required when late is true.
attendanceHours	double	Required.
present	boolean
penalty	boolean
late	boolean
authorisedAbsence	boolean
note	string

EditStudentAttendanceForm

Field	Format	Notes / Values
studentAttendanceID	int	Required.
attendancePenaltyCode	string	Required when penalty is true. Must be a code already defined.
attendancePenaltyMinutes	int	Required when attendancePenaltyCode is set.
attendancePenaltyLateMinutes	int	Required when late is true.
attendanceHours	double	Required.
present	boolean
penalty	boolean
late	boolean
authorisedAbsence	boolean
note	string

GenerateStudentAttendanceForm

Field	Format	Notes / Values
studentID	int	Required.
startDate	yyyy-mm-dd	Optional.
endDate	yyyy-mm-dd	Optional.
type	int	1 PDF 2 CSV

StudentNote

Field	Format	Notes / Values
studentNoteID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
studentID	int
note	string
numRevisions	int
deleted	boolean

AddStudentStatusForm

Field	Format	Notes / Values
studentID	int	Required.
status	string	Required. The new status.
note	string

Student Status

Field	Format	Notes / Values
studentStatusID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
studentID	int	Required.
eventID	int
status	string
result	string
reason	string
note	string

StudentCourse

Field	Format	Notes / Values
studentCourseID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
studentID	int
courseID	int
enrollDate	yyyy-mm-dd
startDate	yyyy-mm-dd
endDate	yyyy-mm-dd
selfEnrolled	boolean
autoComplete	int	0 None 1 By Course End 2 By Manual Date 3 By All Grades Entered
autoCompleteDate	yyyy-mm-dd
autoCompleteMinimumGrade	double
repeatCourse	boolean
percentageGradeAverageCalculated	double
gradePointAverageCalculated	double
letterGradeCalculated	string
passFailCalculated	string
customGradeCalculated	string
percentageGradeAverage	double
gradePointAverage	double
letterGrade	string
passFail	string
customGrade	string
status	string	Advanced Standing Completed Enrolled Incomplete Withdrawn
statusDate	yyyy-mm-dd
waitlistOrder	int
allGradesEntered	boolean
totalGradesEntered	int
totalGradesEnteredWeight	double
totalGrades	int
creditsEarned	double
attendanceStatus	string	Good Marginal Review
totalClassesAttended	int
totalClassesMissed	int
totalClassesLate	int
totalHoursCompleted	double
totalHoursMissed	double
totalHoursLate	double
avgAttendance	double
avgAbsences	double
avgLates	double
avgAttendanceOverall	double
avgAbsencesOverall	double
avgLatesOverall	double
consecutiveAbsences	int
comments	string
noGrade	boolean
noGradeCode	string
noGradeReason	string
noGradeUserID	int
noGradeDateTime	yyyy-mm-dd hh:mm:ss
overrideMark	boolean
overrideMarkUserID	int
overrideMarkDateTime	yyyy-mm-dd hh:mm:ss
overrideMarkReason	string
overrideAttendance	double
overrideAttendanceUserID	int
overrideAttendanceDateTime	yyyy-mm-dd hh:mm:ss
overrideAttendanceReason	string
overrideEquivalency	boolean
overrideEquivalencyCourseCode	string
overrideEquivalencyCourseName	string
credentialAwarded	boolean
credentialAwardedCode	string
credentialAwardedName	string
credentialAwardedDate	yyyy-mm-dd
credentialAwardedByUserID	int
credentialAwardedNotes	string
studentCredentialID	int
studentCredentialKey	string

EnrollStudentCourseForm

Field	Format	Notes / Values
studentID	int	Required.
courseID	int	Required.
enrollDate	YYYY-MM-DD	Required.
courseFeesType	int	0 None 1 Charge Account 2 Invoice Account
accountInvoiceID	int	If 'Invoice Account', the course fees will be added to this invoice. If not provided a new invoice will be created.
repeatCourse	boolean
autoComplete	int	0 None 1 By Course End 2 By Manual Date 3 By All Grades Entered
autoCompleteDate	yyyy-mm-dd	Required when autoComplete is 2.
autoCompleteMinimumGrade	double	Optional when autoComplete is 3.
autoCompleteMinimumAttendanceHours	double	Optional when autoComplete is 3.
autoCompleteMinimumEngagementHours	double	Optional when autoComplete is 3.
enrollInExternal	boolean	The student will be enrolled in the linked external course.
skipNotifications	boolean	If 'true', enroll notifications won't be sent to students or instructors.
optOutNotifications	boolean	If 'true', the student will not receive any course notifications.
note	string

CompleteStudentCourseForm

Field	Format	Notes / Values
studentCourseID	int	Required.
markAsIncomplete	boolean	The course will be completed for administrative purposes but will be marked as incomplete.
completedDate	yyyy-mm-dd	Required.
credentialAction	int	Only available when the course has a credential associated with it. 0 Auto Award / Not Award Credential 1 Award Credential 2 Don't Award Credential
completeExternal	boolean	if true, the student will be completed in the linked external course.
skipNotifications	boolean	If true, completed notifications won't be sent to students or instructors.
notes	string

WithdrawStudentCourseForm

Field	Format	Notes / Values
studentCourseID	int	Required.
withdrawType	int	1 Withdraw Normally, 2 Delete Student Course Record
withdrawDate	yyyy-mm-dd	Required.
withdrawCode	string	Required. Must match a withdraw code already defined.
reverseFees	int	0 None, 1 Reverse Charges, 2 Reverse Invoice Items
accountChargeID	int	Required when reverseFees is 1. Repeat for multiple charges.
accountInvoiceID	int	Required when reverseFees is 2.
withdrawExternal	boolean	if true, the student will be withdrawn from the linked external course.
skipNotifications	boolean	If true, withdrawn notifications won't be sent to students or instructors.
note	string

ReenrollStudentCourseForm

Field	Format	Notes / Values
studentCourseID	int	Required.
enrollDate	YYYY-MM-DD	Required.
reenrollExternal	boolean	The student will be reenrolled in the linked external course.
skipNotifications	boolean	If 'true', enroll notifications won't be sent to students or instructors.
optOutNotifications	boolean	If 'true', the student will not receive any course notifications.
note	string

StudentProgram

Field	Format	Notes / Values
studentProgramID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
studentID	int
programID	int
startingAcademicSessionID	int
programIntakeID	int
programEnrollDate	yyyy-mm-dd
programStartDate	yyyy-mm-dd
expectedEndDate	yyyy-mm-dd
percentageGradeAverageCalculated	double
gradePointAverageCalculated	double
letterGradeCalculated	string
passFailCalculated	string
customGradeCalculated	string
percentageGradeAverage	double
gradePointAverage	double
letterGrade	string
passFail	string
customGrade	string
distinction	string
totalCreditsEarned	double
totalCreditsEarnedPercentage	double
totalHoursCompleted	double
totalHoursCompletedPercentage	double
totalHoursMissed	double
totalHoursMissedPercentage	double
totalHoursLate	double
totalHoursLatePercentage	double
status	string	Enrolled,Completed,Withdrawn
statusDate	yyyy-mm-dd
statusReasonCode	string
statusReason	string
subStatus	string
credentialStatusCode	string
credentialAwardedCode	string
credentialAwarded	string
credentialAwardedDate	yyyy-mm-dd
credentialAwardedByUserID	int
credentialAwardedNote	string
primaryProgram	boolean
avgAttendanceCalculated	double
avgAbsencesCalculated	double
avgLatesCalculated	double
avgAttendance	double
avgAbsences	double
avgLates	double
avgAttendanceOverall	double
avgAbsencesOverall	double
avgLatesOverall	double
overrideFinal	boolean
overrideFinalDateTime	yyyy-mm-dd hh:mm:ss
overrideFinalUserID	int
overrideFinalReason	string
overrideAttendance	double
overrideAttendanceDateTime	yyyy-mm-dd hh:mm:ss
overrideAttendanceUserID	int
overrideAttendanceReason	string

EnrollStudentProgramForm

Field	Format	Notes / Values
studentID	int	Required.
programID	int	Required.
academicSessionID	int	Required. Student will automatically be registered if not registered.
programIntakeID	int
programEnrollDate	yyyy-mm-dd	Required.
programStartDate	yyyy-mm-dd	Required.
expectedEndDate	yyyy-mm-dd
subStatus	string
primary	boolean	When true this program will be student's primary program.
chargeFees	int	Required. '0' No Fees, '1' Charge Fees, '2' Invoice Fees
accountInvoiceID	int	Will add fees to selected invoices. 'chargeFees' must be 2.

EditStudentProgramForm

Field	Format	Notes / Values
studentProgramID	int	Required.
academicSessionIDChanged	boolean
academicSessionID	int	Required when changed.
programIntakeIDChanged	boolean
programIntakeID	int	Required when changed.
programEnrollDate	yyyy-mm-dd	Required.
programStartDate	yyyy-mm-dd	Required.
expectedEndDate	yyyy-mm-dd
subStatusChanged	boolean
subStatus	string	Required when changed.
subStatusDate	yyyy-mm-dd	Required when changed.
subStatusNote	string
primary	boolean	When true this program will be student's primary program.

CompleteStudentProgramForm

Field	Format	Notes / Values
studentProgramID	int	Required.
overrideFinal	boolean
overrideFinalMark	double	Required for override. Between 0-100.
overrideFinalReason	string
overrideAttendance	boolean
overrideAttendanceAmount	double	Required for override. Between 0-100.
overrideAttendanceLateAmount	double	Required for override. Between 0-100.
overrideAttendanceReason	string
awardCredential	boolean
completedDate	yyyy-mm-dd	Required.
subStatus	string
note	string

WithdrawStudentProgramForm

Field	Format	Notes / Values
studentProgramID	int	Required.
withdrawType	int	Required. '1' Withdraw, '2' Remove Program from Record
withdrawDate	yyyy-mm-dd	Required.
withdrawCode	string	Required. Must match defined withdrawn codes.
subStatus	string
reverseFees	int	Required. '0' No, '1' Reverse Charges, '2' Reverse Invoice
accountChargeID[]	int[]	The charges to reverse. Required when reversing charges.
accountInvoiceID	int	The invoice to reverse. Required when reversing invoice.
note	string

ReenrollStudentProgramForm

Field	Format	Notes / Values
studentProgramID	int	Required.
subStatus	string
primary	boolean	When true this program will be student's primary program.

StudentTest

Field	Format	Notes / Values
studentTestID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
studentID	int
studentGradeID	int
studentGradeItemID	int
courseID	int
courseGradeID	int
courseTestID	int
testKey	string
testScheduleType	string	DateTime Schedule, Open Open Ended
testScheduleStart	yyyy-mm-dd hh:mm:ss
testScheduleEnd	yyyy-mm-dd hh:mm:ss
testScheduleStartWithCutoff	boolean
testScheduleStartCutoff	yyyy-mm-dd hh:mm:ss
testTimeLimit	boolean
testTimeLimitAmount	int	Minutes.
testTitle	string
testStatus	string	PENDING, IN PROGRESS, COMPLETED, ERROR
testCurrentQuestionID	int
testCurrentQuestionKey	string
testStart	yyyy-mm-dd hh:mm:ss
testEnd	yyyy-mm-dd hh:mm:ss
testTotalMinutes	int
testTotalSections	int
testTotalQuestions	int
testTotalQuestionsAnswered	int
testTotalQuestionsAnsweredPercentage	double
testTotalPoints	double
testTotalPointsAnswered	double
testTotalPointsAnsweredPercentage	double
testTotalPointsEarned	double
testPercentageGradeCalculated	double
testPercentageGrade	double
testCompleted	boolean
testMarked	boolean
comments	string
commentsLastModifiedDateTime	yyyy-mm-dd hh:mm:ss
commentsLastModifiedByUserID	int
overrideGrade	boolean
overrideByUserID	int
overrideDateTime	yyyy-mm-dd hh:mm:ss
overrideReason	string
testVerifyStudent	boolean
testVerifyStudentIDDocumentID	int
testVerifyStudentFaceDocumentID	int
testVerifyStudentVerified	boolean
testScreenCapture	int	0 None, 1 Random, 2 Security Events
testVideoCapture	int	0 None, 1 Random, 2 Anomaly
securityLog	string
securityFlags	int	0 None, 1 Warn Only, 2 Warn & End Test
externalProctor	boolean
externalProctorCode	string
externalProctorStatus	string
externalProctorStudentID	string
externalProctorStudentEnrollmentID	string
externalProctorStudentTestID	string
externalProctorLog	string
deleted	boolean

StudentTestSection

Field	Format	Notes / Values
studentTestSectionID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
studentTestID	int
studentID	int
courseID	int
courseTestID	int
courseTestSectionID	int
testSectionOriginalOrder	int
testSectionOrder	int
testSectionQuestions	int
testSectionQuestionsAnswered	int
testSectionQuestionsPercentage	double
testSectionPoints	double
testSectionPointsEarned	double
testSectionPointsPercentage	double

StudentTestQuestion

Field	Format	Notes / Values
studentTestQuestionID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
studentTestID	int
studentTestSectionID	int
studentID	int
courseID	int
courseTestID	int
courseTestSectionID	int
courseTestQuestionID	int
testQuestionOriginalOrder	int
testQuestionOrder	int
testQuestionDisplayPermutation	int
testQuestionFillBlankAnswer1	string
testQuestionFillBlankAnswer2	string
testQuestionFillBlankAnswer3	string
testQuestionFillBlankAnswer4	string
testQuestionFillBlankAnswer5	string
testQuestionFillBlankAnswer6	string
testQuestionFillBlankAnswer7	string
testQuestionFillBlankAnswer8	string
testQuestionFillBlankAnswer9	string
testQuestionFillBlankAnswer10	string
testQuestionMatchingResponseDisplayPermutation	int
testQuestionMatchingAnswer1	string
testQuestionMatchingAnswer2	string
testQuestionMatchingAnswer3	string
testQuestionMatchingAnswer4	string
testQuestionMatchingAnswer5	string
testQuestionMatchingAnswer6	string
testQuestionMatchingAnswer7	string
testQuestionMatchingAnswer8	string
testQuestionMatchingAnswer9	string
testQuestionMatchingAnswer10	string
testQuestionMultipleChoiceAnswer	int
testQuestionMultipleSelectAnswer	int
testQuestionOpenEndedAnswer	string
testQuestionAnswered	boolean
testQuestionAnsweredDateTime	yyyy-mm-dd hh:mm:ss
testQuestionAnsweredIp	string
testQuestionAnswerCorrect	boolean
testQuestionAnswerPoints	double
testQuestionMarked	boolean
comments	string
commentsLastModifiedDateTime	yyyy-mm-dd hh:mm:ss
commentsLastModifiedByUserID	int

GenerateStudentTranscriptForm

Field	Format	Notes / Values
studentID	int	Required.
issueDate	yyyy-mm-dd	Required.
transcriptTemplateID	int	Required.
programID	int	List of program summaries which will appear on the transcript. Repeat parameter for each program.
restrictToProgram	boolean	If true, only courses in the provided programIDs will be shown. You must provide at least one programID. Cumulative and sessional averages will be disabled.
skipEmptySessions	boolean

StudentTransferCreditObject

Field	Format	Notes / Values
studentTransferCreditID	int	Required.
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
studentID	int
courseCode	string	The course code in ampEducator.
courseName	string	The course name in ampEducator.
courseCredits	double
prevCourseCode	string	The course code being transferred.
prevCourseName	string	The course name being transferred.
prevInstitution	string
prevSession	string
transferDate	yyyy-mm-dd
notes	string

AddStudentTransferCreditForm

Field	Format	Notes / Values
studentID	int	Required.
courseCode	string	Required. The course code in ampEducator.
courseName	string	Required. The course name in ampEducator.
courseCredits	double	Required.
prevCourseCode	string	Required. The course code being transferred.
prevCourseName	string	Required. The course name being transferred.
prevInstitution	string	Required. The name of institution being transferred from.
prevSession	string
transferDate	yyyy-mm-dd	Required.
notes	string

EditStudentTransferCreditForm

Field	Format	Notes / Values
studentTransferCreditID	int	Required.
courseCode	string	Required. The course code in ampEducator.
courseName	string	Required. The course name in ampEducator.
courseCredits	double	Required.
prevCourseCode	string	Required. The course code being transferred.
prevCourseName	string	Required. The course name being transferred.
prevInstitution	string	Required. The name of institution being transferred from.
prevSession	string
transferDate	yyyy-mm-dd	Required.
notes	string

DeleteStudentTransferCreditForm

Field	Format	Notes / Values
studentTransferCreditID	int	Required.

/template

Add, update and manage templates.

Methods

Action	Required	Returns
/template/get Retrieves templates. GET	None	Template [ ]

Template

Field	Format	Notes / Values
templateID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
pdfTemplateID	int
templateSize	string	Letter, Legal, A4, Custom
customWidth	double	With 'Custom' template size. In inches.
customHeight	double	With 'Custom' template size. In inches.
templateTitle	string(100)	Required.
templateDescription	text
template	text
ownerUserID	int
readRoleMask	int
updateRoleMask	int
locationMask	long

/transcriptTemplate

Add, update and manage transcript templates.

Methods

Action	Required	Returns
/transcriptTemplate/get Retrieves transcript templates. GET	None	TranscriptTemplate [ ]

TranscriptTemplate

Field	Format	Notes / Values
transcriptTemplateID	int
createdDateTime	yyyy-mm-dd hh:mm:ss
createdByUserID	int
lastModifiedDateTime	yyyy-mm-dd hh:mm:ss
lastModifiedByUserID	int
transcriptTemplate	String
transcriptDescription	string
transcriptType	string	Complete All Courses Current Only Current Enrolled Courses
summaryMarkType	string
summaryMarkTypeAlt	string
summaryShowAcademicSessions	boolean
summaryShowOverallTotals	boolean
summaryShowDistinctions	boolean
summaryShowCourseCredits	boolean
summaryShowCourseHours	boolean
summaryShowAbsences	boolean
summaryShowAverageAttendance	boolean
summaryShowLates	boolean
summaryShowAverageLates	boolean
showCoursesWithdrawn	boolean
showCoursesAdvancedStanding	boolean
overrideIncomplete	boolean
overrideIncompleteText	string
overrideFailed	boolean
overrideFailedText	string
overrideWithdrawn	boolean
overrideWithdrawnText	string
overrideActive	boolean
overrideActiveText	string
indicateRepeat	boolean
indicateRepeatText	string
showAcademicSessionTitles	boolean
showProgramMark	boolean
showProgramLength	boolean
showProgramStatus	boolean
showProgramSubStatus	boolean
showProgramStart	boolean
showProgramExpectedEnd	boolean
showProgramCredential	boolean
showTransferCredits	boolean
showGradingKey	boolean
showCertification	boolean
transcriptTitle	string
programInfoTitle	string
transferCreditsTitle	string
coursesTitle	string
gradingKeyTitle	string
certificationTitle	string
orientation	int	0 Portrait 1 Landscape
displayOrder	int	0 Ascending 1 Descending
pdfTemplateID	int
marginTop	double
marginBottom	double
marginLeft	double
marginRight	double
header	double
font	string
fontSize	double
printPageNumber	boolean
printIssueDate	boolean
printInstitutionName	boolean
printLocationName	boolean
printLocationAddress	boolean
printStudentID	boolean
printStudentIDLabel	string
printStudentName	boolean
printStudentNameLabel	string
printStudentAddress	boolean
printStudentAddressLabel	string
printStudentTimeclockHours	boolean
printStudentTimeclockHoursLabel	string
printStudentSIN	boolean
printStudentSINLabel	string
printStudentDOB	boolean
printStudentDOBLabel	string
printStudentCustomFieldLabels	boolean
printStudentCustomFieldIDs	string
printCourseStatus	boolean
printCourseCode	boolean
printCourseStart	boolean
printCourseEnd	boolean
printCourseHours	boolean
printCourseCredits	boolean
printCourseInstructors	boolean
printStudentCourseFinalMarkAlt	boolean
printStudentCourseAbsences	boolean
printStudentCourseAverageAttendance	boolean
printStudentCourseLates	boolean
printStudentCourseAverageLates	boolean
printStudentCourseHours	boolean
printStudentCourseStatus	boolean
printStudentCourseComments	boolean
printStudentCourseGradesEnteredWeight	boolean
printStudentCourseFinalMarkHeader	string
certifiedBy	string
certifiedByPosition	string
certifiedBySignature	int	0 Manual Signature 1 Auto Generated Signature 2 Uploaded Signature
certifiedBySignatureDocumentID	int
certificationNotes	string
gradingKey	string
printTimeStamp	boolean
printUserInitials	boolean
deleted	boolean

Webhooks

ampEducator provides webhooks for a variety of events.

Before You Begin

In order to start using the Webhooks you must enable it under the institution config and create webhooks for the events you need.

Webhook URL Validation

When you add a new webhook you must validate the URL in order to confirm ownership. In order to do this ampEducator will post a validation request to the webhook URL in the following format:

{
    "challenge" : "{challengeKey}",
    "type" : "urlVerification" 
}

The endpoint must return the challenge key in the following format in order to validate.

HTTP 200 OK
Content-type: application/json
{
    "challenge" : "{challengeKey}",
}

Webhook Post Format

The webhook post format is always the same but the data posted depends on the the webhook type. The format of the webhook is:

{
    "webhookKey" : {Unique Key per Webhook},
    "notificationKey" : {Unique Key per Notification},
    "date" : {DateTime UTC},
    "type" : {Webhook Type},
    "dataSignature" : {Base64 encoded HMAC256 Hash of Data},
    "data" : {Data}
} 

The {Data} is a JSON object. It is one of the following object types:

• Prospect / ... Returns Student
• Prospect Lead Stage / ... Returns StudentLeadStage
• Student / ... Returns Student
• Student Course / ... Returns StudentCourse
• Student Program / ... Returns StudentProgram
• Student Status / ... Returns StudentStatus
• Student Transfer Credit / ... Returns StudentTransferCredit
• Student User / ... Returns User

Webhook Data Signature

The {Data} portion of the notification is used to generate an HMAC256 hash using the secret key under institution config. You can use this key to validate that the data is from ampEducator.

• The secret key in ampEducator is a 256 byte key encoded using Base64.
• The data signature in the webhook notification is also encoded using Base64.