iLMS API Documentation

Written By Marissa Fegan (Super Administrator)

Updated at August 5th, 2024

Table of Contents

Getting Started Users User Object Fields Get All Users / Search Users Description: URL: Method: Response Type: Parameters: CURL Request Example: Response: Get a User Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Create a User Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Update User Profile Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Inactivate a user Description: Response Type: HTTP Request Example: CURL Request Example: Response: Activate a user Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Delete a user Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Purge a user Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Reset Password and/or Force user to change password after login Description: URL: Method: Parameters: HTTP Request Example: CURL Request Example: Response: Groups Get All Groups Description: URL: Method: Response Type: Parameters: CURL Request Example: Response: Get a Group Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Get All Members / Users Of a Group Description: URL: Method: Response Type: Parameters: CURL Request Example: Response: Add a Member / User in Group Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Remove a Member / User from Group Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Get All Courses Of a Group Description: URL: Method: Response Type: Parameters: CURL Request Example: Response: Add a Course in Group Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Remove a Course from Group Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Modify Default Due Date and Requirement Type For A Group's Course Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Refresh a Group Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Get All Members / Users Of a Group's Explicit Inclusion List Description: URL: Method: Response Type: Parameters: CURL Request Example: Response: Add a User in Group's Explicit Inclusion List Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Remove a User from a Group's Explicit Inclusion List Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Get All Members / Users Of a Group's Explicit Exclusion List Description: URL: Method: Response Type: Parameters: CURL Request Example: Response: Add a User in Group's Explicit Exclusion List Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Remove a User from a Group's Explicit Exclusion List Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: User Hierarchy - Region, Division, and Department Region Get All Regions Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Create a Region Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Update Region Name Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Delete a Region Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Division Get All Divisions Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Create a Division Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Update Division Name Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Delete a Division Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Department Get All Departments Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Create a Department Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Update Department Name Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Delete a Department Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Transcripts Get Transcripts Of A User Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Get Transcripts Of A User For A Specific Course Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Get Transcripts Of A User For A Specific Curriculum Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Get Transcripts Of A User For A Specific Session Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Modify User's Transcript For A Course/Curriculum/Session Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Courses Get All Courses Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Get A Course Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Get Only Due Date Settings of a Course Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Modify Due Date Settings of a course Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Inactivate a course Description: Response Type: HTTP Request Example: CURL Request Example: Response: Activate a course Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Curricula Get All Curricula/Search by Name Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Get A Curriculum Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Modify Due Date Settings of a curriculum Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Instructor-Lead Training Sessions Get All Sessions of a ILT/Event Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Get A Session Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Enrollments Get All The Enrollments Of A Course Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Enroll User In A Course Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Un-enroll User From A Course Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Get All The Enrollments Of A Curriculum Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Enroll User In A Curriculum Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Un-enroll User From A Curriculum Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Get All The Enrollments Of A Session Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Enroll User In A Session Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Un-enroll User From A Session Description: URL: Method: Response Type: HTTP Request Example: CURL Request Example: Response: Reports Get Summary Report Of a Course, Curriculum or ILT Session Description: URL: Method: Response Type: Parameters: HTTP Request Example: CURL Request Example: Response: Status Codes 2xx - Success 4xx - Error Client Slide 5xx - Error on Server Side Region, Time, and Language Codes Time Zone Country US - States Canada - States (Provinces) Languages Pagination Sorting

Getting Started

 To get started with the API, please enable the iLMS API from Settings->iLMS API, generate your Transaction Key, and browse our full documentation (links are here in this page).

1.jpg

2.jpg

Users

User Object Fields

A user object looks like this:

Field Code Data Type Description Validations
F001 string First Name
  • Is Required: Yes
  • Maximum Length: 200 characters
  • Restricted Characters: < > " % ; +
  • & # are restricted by functionality and not error if using iLMS connect
F002 string Middle Name
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: < > " % ; +
F003 string Last Name
  • Is Required: Yes
  • Maximum Length: 200 characters
  • Restricted Characters: < > " % ; +
  • & # are restricted by functionality and not error if using iLMS connect
F004 string Employee ID
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: < > " % ; +
  • & # are restricted by functionality and not error if using iLMS connect
F005 Date Time Hire Date
  • Is Required: depend on ilms settings
F006 string User Language
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: % \ + ; " < > : ?
  • It accepts language name available to your organization in iLMS. Please go to Settings > Languages in your organization account in iLMS to see what are the languages available to your organization. A full list of all the languages can be seen in Language section.
F007 string Job Title
  • Is Required: depend on ilms settings
  • Maximum Length: 50 characters
  • Restricted Characters: < > " % ; +
F008 string Address 1
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: < > " % ; +
F009 string Address 2
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: < > " % ; +
F010 string City
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: < > " % ; +
F011 string Country
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: < > " % ; +
  • It accepts Country Name and Country Code. Please see the Country section to get all the country name and codes.
F012 string State (US or Canada)
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: < > " % ; +
  • It accepts State Name and State Code. Please see the State section to get all the country name and codes.
F013 string

State/Province/Region

(Non US or Candadian)

  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: < > " % ; +
F014 string Zip Code/Postal Code
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: < > " % ; +
F015 string Email ID
  • Is Required: depend on ilms settings
  • Maximum Length: 200 characters
  • Restricted Characters: < > " % ; +
  • If using LDAP, these cannot be the first character:
    `~!@#$&*()=}{|':./_ 
F016 string Password
  • Is Required: No
  • Maximum Length: depend on ilms settings
  • Restricted Characters: < > " % ; +
F017 string Phone
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: < > " % ; +
F018 string Fax
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: < > " % ; +
F019 string Region
  • Is Required: Yes
  • Maximum Length: 100 characters
  • Restricted Characters: % \ + ; " < > : ?
  • & # are restricted by functionality and not error if using iLMS connect
F020 string Division
  • Is Required: Yes
  • Maximum Length: 100 characters
  • Restricted Characters: % \ + ; " < > : ?
  • & # are restricted by functionality and not error if using iLMS connect
F021 string Department
  • Is Required: Yes
  • Maximum Length: 100 characters
  • Restricted Characters: % \ + ; " < > : ?
  • & # are restricted by functionality and not error if using iLMS connect
F022 string Company/Employer
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: < > " % ; +
F023 string Time Zone
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • It takes time zone full name. Please see Timezone section for the same.
F024 string Custom Field 1
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: < > " % ; +
F025 string Custom Field 2
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: < > " % ; +
F026 string Custom Field 3
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: < > " % ; +
F027 string Custom Field 4
  • Is Required: depend on ilms settings
  • Maximum Length: 100 characters
  • Restricted Characters: < > " % ; +
F031 string Registration Type. It tells about how user is registered.
  • Is Required: No. It is read only property.
  • Read only: Yes
  • Possible Values are: API, iLMS, Self Registration, iLMS Connect, LDAP, SAML, Unknown
F032 DateTime Registration Date
  • Is Required: No. It is read only property.
  • Read only: Yes
F033 string Supervisor Name
  • Is Required: depend on ilms settings
  • Maximum Length: 500 characters
  • Restricted Characters: < > " % ; +
F034 string Supervisor Email
  • Is Required: depend on ilms settings
  • Maximum Length: 500 characters
  • Restricted Characters: < > " % ; +
  • If using LDAP, these cannot be the first character:
    `~!@#$&*()=}{|':./_ 

Get All Users / Search Users

Description:

Get all the users of an organization based on search parameters. if none of the search parameter is used, then it returns all the users. It supports pagination.

URL:

https://api.inspiredlms.com/organizations/{orgID}/users

Method:

GET

Response Type:

JSON

Parameters:

Besides standard pagination and sort parameters, it accepts search on any user profile field.

Query String Parameter Data Type Description Validations
Pass one or more than one user profile field code string

It supports 4 types of search.

Exact search: e.g. F001="John"

It'll return all the users whose first name is John.

Like/Contains search: e.g. F001=John

It'll return all the users whose first name contains word John.

Starts with search: e.g. F001=Jo*

It'll return all the users whose first name starts with Jo.

Ends with search: e.g. F001=*hn

It'll return all the users whose first name ends with hn.

For datetime type of fields, use the following format:

Date range: (From:YYYY-MM-DDTHH:mm:ssTo:YYYY-MM-DDThh:mm:ss)

e.g. F005=(From:2012-01-01T00:00:00To:2012-12-31T23:59:59) will return all the users who are hired in Year 2012.

Greater than: Just skip 'To' part.

e.g. F005=(From:2012-01-01T00:00:00) will return all the users who are hired on or after 1st January, 2012.

Less than: Just skip 'From' part.

e.g. F005=(To:2012-12-31T23:59:59) will return all the users who are hired on or before 31st December, 2012.

groupids string Get the unique set of users who belongs to any of the groups supplied. 
  • Is Required: No
  • Valid Values are: Numeric group IDs
  • Multiple values can be used separated by commas. e.g. "groupids=363,370,384" will return all the unique set of users who belongs to any of the group (i.e. 363 or 370 or 384) 
sort string Get the results in specified sorting order. If nothing is passed, it returns result in F003 ascending order.
  • Supported field code for sorting are: F001, F002, F003, F004, F006, F011, F012, F015, F019, F020, F021
userstatus string Get users filtered by their status. i.e. active, inactive and/or deleted.
  • Is Required: No. If not passed, it only returns active users.
  • Valid values are: active, inactive, deleted
  • Multiple values can be used separated by commas. e.g. "userstatus=active,inactive" will return all the users whose status is either active or inactive.

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/users

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/users"

Response:

Since it supports pagination, response may include link header if resultant records are more than the page_size.

You can't retrieve password of an user. So password's field code F016 will always show value as null.

HTTP/1.1 200 Ok

X-Total-Count: 658

next: https://api.inspiredlms.com/organizations/99999/users?per_page=100&page=2
last: https://api.inspiredlms.com/organizations/99999/groups?per_page=100&page=7 

[
{
"ID": 517244,
"UserStatus": "Active",
"Profile": {
"F001": "John",
"F002": "",
"F003": "Doe",
"F004": "Emp001",
"F005": null,
"F006": "English",
"F007": "Manager",
"F008": "",
"F009": "",
"F010": "San Antonio",
"F011": "United States",
"F012": "Texas",
"F013": "",
"F014": "",
"F015": "john.doe@email.com",
"F016": null,
"F017": "",
"F018": "",
"F019": "Region 1",
"F019_ID": 13306,
"F020": "Division 1",
"F020_ID": 8463,
"F021": "Department 1",
"F021_ID": 15136,
"F022": "",
"F023": "(GMT-06.00) Central Time (US & Canada)",
"F024": "",
"F025": "",
"F026": "",
"F027": "",
"F031": "API",
"F032": "2013-10-23T13:30:38.22",
"F033": "",
"F034": ""
}
},
{
"ID": 517226,
"UserStatus": "Active",
"Profile": {
"F001": "Demo",
"F002": "",
"F003": "User",
"F004": "Emp002",
"F005": null,
"F006": "English",
"F007": "",
"F008": "",
"F009": "",
"F010": "",
"F011": "US",
"F012": "NE",
"F013": "",
"F014": "",
"F015": "demo.user@email.com",
"F016": null,
"F017": "",
"F018": "",
"F019": "Region 1",
"F019_ID": 13306,
"F020": "Division 1",
"F020_ID": 8463,
"F021": "Department 1",
"F021_ID": 15136,
"F022": "",
"F023": "(GMT-06.00) Central Time (US & Canada)",
"F024": "",
"F025": "",
"F026": "",
"F027": "",
"F031": "LDAP",
"F032": "2013-10-17T12:34:34.61",
"F033": "",
"F034": ""
}
},

{

.......

.......

}


Get a User

Description:

Get a user of an organization specified by userid.

URL:

https://api.inspiredlms.com/organizations/{orgID}/users/{userid}

Method:

GET

Response Type:

JSON

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/users/517244

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/users/517244"

Response:

You can't retrieve password of an user. So password's field code F016 will always show value as null.

HTTP/1.1 200 Ok

{
"ID": 517244,
"UserStatus": "Active",
"Profile": {
"F001": "John",
"F002": "",
"F003": "Doe",
"F004": "Emp001",
"F005": null,
"F006": "English",
"F007": "Manager",
"F008": "",
"F009": "",
"F010": "San Antonio",
"F011": "United States",
"F012": "Texas",
"F013": "",
"F014": "",
"F015": "john.doe@email.com",
"F016": null,
"F017": "",
"F018": "",
"F019": "Region 1",
"F019_ID": 13306,
"F020": "Division 1",
"F020_ID": 8463,
"F021": "Department 1",
"F021_ID": 15136,
"F022": "",
"F023": "(GMT-06.00) Central Time (US & Canada)",
"F024": "",
"F025": "",
"F026": "",
"F027": "",
"F031": "API",
"F032": "2013-10-23T13:30:38.22",
"F033": "",
"F034": ""
}
}


Create a User

Description:

Create a new user based on the parameters specified.

URL:

https://api.inspiredlms.com/organizations/{orgID}/users

Method:

POST

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
sendRegistrationMail boolean If true, system will also send registration email to user, after user account is created.
  • Is Required: No. If not passed, it will not send registration email.
  • Valid values are: true, false
changePasswordAtNextLogin boolean If true, system will force user to change his password when he logs in next time.
  • Is Required: No.
  • Valid values are: true, false
Pass one or more than one user profile field code and respective value(s) to update. string It accepts key value pair combination.
  • Is Required: Yes. It is must to send information to mandatory profile fields.
  • Each field code value is validated as per the rules mentioned at top of this page.

HTTP Request Example:

POST

https://api.inspiredlms.com/organizations/99999/users

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"userProfileData":[{"Key":"F001","Value":"John"},{"Key":"F003","Value":"Doe"},{"Key":"F015","Value":"john.burt@email.com"},{"Key":"F019","Value":"region 1"},{"Key":"F020","Value":"Division 1"},{"Key":"F021","Value":"Department 1"}],"sendRegistrationMail":true,"changePasswordAtNextLogin":true}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X POST -d "@createuser.json" "https://api.inspiredlms.com/organizations/99999/users"

here, content of @createreg.json file is:

{"userProfileData":[{"Key":"F001","Value":"John"},{"Key":"F003","Value":"Doe"},{"Key":"F015","Value":"john.doe@test.com"},{"Key":"F019","Value":"region 1"},{"Key":"F020","Value":"Division 1"},{"Key":"F021","Value":"Department 1"}],"sendRegistrationMail":true,"changePasswordAtNextLogin":true}

Response:

 If successful, 201 status code will be return along with ID of new user.

HTTP/1.1 201 Created

Location: https://api.inspiredlms.com/organizations/99999/users/123456

 

123456


Update User Profile

Description:

Modify user profile based on the parameters specified.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/users/{userid}

Method:

PUT

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
Pass one or more than one user profile field code and respective value(s) to update. string

It accepts key value pair combination. Pass only the field code and value which requires to be updated. System will remain rest of the profile information as it is.

Region(F019), Division(F020) and Department(F021) needs to be passed together. In other words, only F019 or F020 will not able to make any change in user profile.

 As mentioned at top of this page.

HTTP Request Example:

PUT

https://api.inspiredlms.com/organizations/99999/users/123456

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

[{"Key":"F001","Value":"John"},{"Key":"F003","Value":"Doe"}]

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X PUT -d "@updateuser.json" "https://api.inspiredlms.com/organizations/99999/users/123456"

here, content of @updateuser.json file is:

[{"Key":"F001","Value":"John"},{"Key":"F003","Value":"Doe"}]

Response:

HTTP/1.1 204 No Content


Inactivate a user

Description:

Inactivate the user account identified by userID.

URL:

https://api.inspiredlms.com/organizations/{orgID}/users/{userID}/Activate

Method:

DELETE

Response Type:

JSON

HTTP Request Example:

DELETE

https://api.inspiredlms.com/organizations/99999/users/123456/Activate

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X DELETE "https://api.inspiredlms.com/organizations/99999/users/123456/Activate"

Response:

HTTP/1.1 204 No Content


Activate a user

Description:

Activate the user account identified by userID.

URL:

https://api.inspiredlms.com/organizations/{orgID}/users/{userID}/Activate

Method:

PUT

Response Type:

JSON

HTTP Request Example:

PUT

https://api.inspiredlms.com/organizations/99999/users/123456/Activate

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X PUT -d "" "https://api.inspiredlms.com/organizations/99999/users/123456/Activate"

Response:

HTTP/1.1 204 No Content


Delete a user

Description:

Delete the user account identified by userID.

URL:

https://api.inspiredlms.com/organizations/{orgID}/users/{userID}

Method:

DELETE

Response Type:

JSON

 HTTP Request Example:

DELETE

https://api.inspiredlms.com/organizations/99999/users/123456

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X DELETE "https://api.inspiredlms.com/organizations/99999/users/123456"

Response:

HTTP/1.1 204 No Content


Purge a user

Description:

purge the user account identified by userID.

URL:

https://api.inspiredlms.com/organizations/{orgID}/users/{userID}/purge

Method:

DELETE

Response Type:

JSON

HTTP Request Example:

DELETE

https://api.inspiredlms.com/organizations/99999/users/123456/purge

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X DELETE "https://api.inspiredlms.com/organizations/99999/users/123456/purge"

Response:

HTTP/1.1 204 No Content


Reset Password and/or Force user to change password after login

Description:

set a new password for the user and/or force him to change his password in next login.

URL:

https://api.inspiredlms.com/organizations/{orgID}/users/{userID}/password

Method:

PUT

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
newPassword string new password of user account
  • Is Required: Yes.
  • Minimum Length: as per ilms settings.
  • Maximum Length: as per ilms settings.
changePasswordAtNextLogin boolean If true, system will force user to change his password when he logs in next time.
  • Is Required: No.
  • Valid values are: true, false

HTTP Request Example:

DELETE

https://api.inspiredlms.com/organizations/99999/users/123456/password

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"newpassword":"password123","changepasswordatnextlogin":"true"}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X PUT -d "@newpassword.json" "https://api.inspiredlms.com/organizations/99999/users/123456/password"

here, content of @newpassword.json file is:

{"newpassword":"password123","changepasswordatnextlogin":"true"}

Response:

HTTP/1.1 204 No Content


Groups 

Get All Groups
Get a Group
Get All Members / Users Of a Group
Add a Member / User in Group
Remove a Member / User from Group
Get All Courses Of a Group
Add a Course in Group
Remove a Course from Group
Modify Default Due Date and Requirement Type Settings For A Group's Course
Refresh a Group
Get All Members / Users Of a Group's Explicit Inclusion List
Add a User in Group's Explicit Inclusion List
Remove a User from a Group's Explicit Inclusion List
Get All Members / Users Of a Group's Explicit Exclusion List
Add a User in Group's Explicit Exclusion List
Remove a User from a Group's Explicit Exclusion List


Get All Groups

Description:

Get all the groups of an organization based on parameters specified. It supports pagination.

URL:

https://api.inspiredlms.com/organizations/{orgID}/groups

Method:

GET

Response Type:

JSON

Parameters:


 

Query String Parameter Data Type Description Validations
sort string

By default results are sorted in group name ascending order.

Use "sort=-name" to sort results in group name descending order.

  • Is Required: No

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/groups?page=3&per_page=2

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/groups?page=3&per_page=2"

Response:

Since it supports pagination, response may include link header if resultant records are more than the page_size.

HTTP/1.1 200 Ok

X-Total-Count: 10
first: https://api.inspiredlms.com/organizations/99999/groups?per_page=2&page=1
prev: https://api.inspiredlms.com/organizations/99999/groups?per_page=2&page=2
next: https://api.inspiredlms.com/organizations/99999/groups?per_page=2&page=4
last: https://api.inspiredlms.com/organizations/99999/groups?per_page=2&page=5

[
{
"ID": 2,
"Name": "Sales",
"Description": "Group for all sales persons.",
"NumberOfCourses": 1,
"NumberOfUsers": 20
},
{
"ID": 3,
"Name": "Manager",
"Description": "",
"NumberOfCourses": 5,
"NumberOfUsers": 3
}
]


Get a Group

Description:

Get a group of an organization specified by groupid.

URL:

https://api.inspiredlms.com/organizations/{orgID}/groups/{groupid}

Method:

GET

Response Type:

JSON

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/groups/2

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/groups/2"

Response:

HTTP/1.1 200 Ok

{
"ID": 2,
"Name": "Sales",
"Description": "Group for all sales persons.",
"NumberOfCourses": 1,
"NumberOfUsers": 20
}


Get All Members / Users Of a Group

Description:

Get all the users of a group based on the specified parameters. It supports pagination.

URL:

https://api.inspiredlms.com/organizations/{orgID}/groups/{groupID}/members

Method:

GET

Response Type:

JSON

Parameters:

Query String Parameter Data Type Description Validations
sort string get the results in specified sorting order. If nothing is passed, it returns result in F003 (user's last name) ascending order.
  • Supported user profile field code for sorting are: F001, F002, F003, F004, F006, F011, F012, F015, F019, F020, F021

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/groups/345/members?page=3&per_page=2

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/groups/345/members?page=3&per_page=2"

Response:

Since it supports pagination, response may include link header if resultant records are more than the page_size.

HTTP/1.1 200 Ok

X-Total-Count: 10
first: https://api.inspiredlms.com/organizations/99999/groups/345/members?per_page=2&page=1
prev: https://api.inspiredlms.com/organizations/99999/groups/345/members?per_page=2&page=2
next: https://api.inspiredlms.com/organizations/99999/groups/345/members?per_page=2&page=4
last: https://api.inspiredlms.com/organizations/99999/groups/345/members?per_page=2&page=5

[
{
"ID": 517244,
"UserStatus": "Active",
"Profile": {
"F001": "John",
"F002": "",
"F003": "Doe",
"F004": "Emp001",
"F005": null,
"F006": "English",
"F007": "Manager",
"F008": "",
"F009": "",
"F010": "San Antonio",
"F011": "United States",
"F012": "Texas",
"F013": "",
"F014": "",
"F015": "john.doe@email.com",
"F016": null,
"F017": "",
"F018": "",
"F019": "Region 1",
"F019_ID": 13306,
"F020": "Division 1",
"F020_ID": 8463,
"F021": "Department 1",
"F021_ID": 15136,
"F022": "",
"F023": "(GMT-06.00) Central Time (US & Canada)",
"F024": "",
"F025": "",
"F026": "",
"F027": "",
"F031": "API",
"F032": "2013-10-23T13:30:38.22",
"F033": "",
"F034": ""
}
},
{
"ID": 517226,
"UserStatus": "Active",
"Profile": {
"F001": "Demo",
"F002": "",
"F003": "User",
"F004": "Emp002",
"F005": null,
"F006": "English",
"F007": "",
"F008": "",
"F009": "",
"F010": "",
"F011": "US",
"F012": "NE",
"F013": "",
"F014": "",
"F015": "demo.user@email.com",
"F016": null,
"F017": "",
"F018": "",
"F019": "Region 1",
"F019_ID": 13306,
"F020": "Division 1",
"F020_ID": 8463,
"F021": "Department 1",
"F021_ID": 15136,
"F022": "",
"F023": "(GMT-06.00) Central Time (US & Canada)",
"F024": "",
"F025": "",
"F026": "",
"F027": "",
"F031": "LDAP",
"F032": "2013-10-17T12:34:34.61",
"F033": "",
"F034": ""
}
}
]


Add a Member / User in Group

Description:

Add a new user in group membership.

URL:

https://api.inspiredlms.com/organizations/{orgID}/groups/{groupID}/members

Method:

POST

Response Type:

JSON

HTTP Request Example:

POST

https://api.inspiredlms.com/organizations/99999/groups/{groupID}/members

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"userid":"444038"}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X POST -d "@addmember.json" "https://api.inspiredlms.com/organizations/99999/groups/345/members"

here, content of @addmember.json file is:

{"userid":"444038"}

Response:

HTTP/1.1 201 Created

Location: https://api.inspiredlms.com/organizations/99999/groups/345/members/444038


Remove a Member / User from Group

Description:

Remove a user's membership from group.

URL:

https://api.inspiredlms.com/organizations/{orgID}/groups/{groupID}/members/{userID}

Method:

DELETE

Response Type:

JSON

HTTP Request Example:

DELETE

https://api.inspiredlms.com/organizations/99999/groups/345/members/12345

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X DELETE "https://api.inspiredlms.com/organizations/99999/groups/345/members/12345"

Response:

HTTP/1.1 204 No Content


Get All Courses Of a Group

Description:

Get all the courses of a group based on the specified parameters. It supports pagination.

URL:

https://api.inspiredlms.com/organizations/{orgID}/groups/{groupID}/groupcourses

Method:

GET

Response Type:

JSON

Parameters:


 

Query String Parameter Data Type Description Validations
sort string

By default results are sorted in course name ascending order.

Use "sort=-coursename" to sort results in course name descending order.

Is Required: No

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/groups/345/groupcourses?page=1&per_page=2

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/groups/345/groupcourses?page=1&per_page=2"

Response:

Since it supports pagination, response may include link header if resultant records are more than the page_size.

HTTP/1.1 200 Ok

[
{
"ID": "i4pkE0es",
"Name": "Security",
"DefaultRequirementType": "Mandatory",
"DefaultDueDateSettings": {
"DefaultDueDate": null,
"DaysAfterEnrollment": 10
}
},
{
"ID": "VvptYCj4",
"Name": "Data Security",
"DefaultRequirementType": "Mandatory",
"DefaultDueDateSettings": {
"DefaultDueDate": "2012-12-21T00:00:00",
"DaysAfterEnrollment": null
}
}
]


Add a Course in Group

Description:

Add a course in group based on parameter specified.

URL:

https://api.inspiredlms.com/organizations/{orgID}/groups/{groupID}/groupcourses

Method:

POST

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
courseid string course id of the course which is required to be part of group.
  • Is Required: Yes

HTTP Request Example:

POST

https://api.inspiredlms.com/organizations/99999/groups/{groupID}/groupcourses

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"courseid":"WErt98k"}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X POST -d "@addcourse.json" "https://api.inspiredlms.com/organizations/99999/groups/345/groupcourses"

here, content of @addcoursejson file is:

{"courseid":"WErt98k"}

Response:

HTTP/1.1 201 Created

Location: https://api.inspiredlms.com/organizations/99999/groups/345/groupcourses/WErt98k


Remove a Course from Group

Description:

Remove a course from group.

URL:

https://api.inspiredlms.com/organizations/{orgID}/groups/{groupID}/groupcourses/{courseID}

Method:

DELETE

Response Type:

JSON

HTTP Request Example:

DELETE

https://api.inspiredlms.com/organizations/99999/groups/345/groupcourses/WErt98k

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X DELETE "https://api.inspiredlms.com/organizations/99999/groups/345/groupcourses/WErt98k"

Response:

HTTP/1.1 204 No Content


Modify Default Due Date and Requirement Type For A Group's Course

Description:

Remove a course from group.

URL:

https://api.inspiredlms.com/organizations/{orgID}/groups/{groupID}/groupcourses/{courseID}/settings

Method:

PUT

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
RequirementType string Set the requirement type "mandatory" or "optional" for the course under the group.
  • Is Required: Yes. 
  • Valid values: mandatory, optional
DefaultDueDate

iso8601 UTC string

Format: "yyyy-MM-ddTHH:mm:ss"

Set a default due date for the course. Pass null to remove any previous date set for the course.
  • Is Required: Yes. 
  • Valid values: iso8601 UTC string, or null.
DaysAfterEnrollment integer Set number of days after enrollment, after which course will be set to due for a user.
  • Is Required: Yes.
  • Valid values: any positive integer (1-999), or null

HTTP Request Example:

PUT

https://api.inspiredlms.com/organizations/99999/groups/345/groupcourses/WErt98k/settings

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"RequirementType":"mandatory","DefaultDueDateSettings":{"DefaultDueDate":null,"DaysAfterEnrollment":30}}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X PUT -d "@modifySettings.json" "https://api.inspiredlms.com/organizations/99999/groups/345/groupcourses/WErt98k"

here, content of @modifySettings.json file is:

{
"RequirementType": "mandatory",
"DefaultDueDateSettings": {
"DefaultDueDate": null,
"DaysAfterEnrollment": 30
}
}

Response:

HTTP/1.1 204 No Content


Refresh a Group

Description:

Refresh a group to update membership.

URL:

https://api.inspiredlms.com/organizations/{orgID}/groups/{groupID}/refresh

Method:

PUT

Response Type:

JSON

HTTP Request Example:

PUT

https://api.inspiredlms.com/organizations/99999/groups/345/refresh

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X PUT -d "" "https://api.inspiredlms.com/organizations/99999/groups/345/refresh"

Response:

HTTP/1.1 204 No Content


Get All Members / Users Of a Group's Explicit Inclusion List

Description:

Get all the users of a group's explicit inclusion list based on the specified parameters. Supports pagination.

URL:

https://api.inspiredlms.com/organizations/{orgID}/groups/{groupID}/explicitinclusionlistusers

Method:

GET

Response Type:

JSON

Parameters:

Besides standard pagination and sort parameters, it accepts search on any user profile field.

Query String Parameter Data Type Description Validations
sort string get the results in specified sorting order. If nothing is passed, it returns result in F003 ascending order.
  • Supported user profile field code for sorting are: F001, F002, F003, F004, F006, F011, F012, F015, F019, F020, F021

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/groups/345/explicitinclusionlistusers

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/groups/345/explicitinclusionlistusers"

Response:

Since it supports pagination, response may include link header if resultant records are more than the page_size.

HTTP/1.1 200 Ok

[
{
"ID": 517244,
"UserStatus": "Active",
"Profile": {
"F001": "John",
"F002": "",
"F003": "Doe",
"F004": "Emp001",
"F005": null,
"F006": "English",
"F007": "Manager",
"F008": "",
"F009": "",
"F010": "San Antonio",
"F011": "United States",
"F012": "Texas",
"F013": "",
"F014": "",
"F015": "john.doe@email.com",
"F016": null,
"F017": "",
"F018": "",
"F019": "Region 1",
"F019_ID": 13306,
"F020": "Division 1",
"F020_ID": 8463,
"F021": "Department 1",
"F021_ID": 15136,
"F022": "",
"F023": "(GMT-06.00) Central Time (US & Canada)",
"F024": "",
"F025": "",
"F026": "",
"F027": "",
"F031": "API",
"F032": "2013-10-23T13:30:38.22",
"F033": "",
"F034": ""
}
},
{
"ID": 517226,
"UserStatus": "Active",
"Profile": {
"F001": "Demo",
"F002": "",
"F003": "User",
"F004": "Emp002",
"F005": null,
"F006": "English",
"F007": "",
"F008": "",
"F009": "",
"F010": "",
"F011": "US",
"F012": "NE",
"F013": "",
"F014": "",
"F015": "demo.user@email.com",
"F016": null,
"F017": "",
"F018": "",
"F019": "Region 1",
"F019_ID": 13306,
"F020": "Division 1",
"F020_ID": 8463,
"F021": "Department 1",
"F021_ID": 15136,
"F022": "",
"F023": "(GMT-06.00) Central Time (US & Canada)",
"F024": "",
"F025": "",
"F026": "",
"F027": "",
"F031": "LDAP",
"F032": "2013-10-17T12:34:34.61",
"F033": "",
"F034": ""
}
}
]


Add a User in Group's Explicit Inclusion List

Description:

Add a new user in group's explicit inclusion list.

URL:

https://api.inspiredlms.com/organizations/{orgID}/groups/{groupID}/explicitinclusionlistusers

Method:

POST

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
sort string get the results in specified sorting order. If nothing is passed, it returns result in F003 ascending order.
  • Supported user profile field code for sorting are: F001, F002, F003, F004, F006, F011, F012, F015, F019, F020, F021

HTTP Request Example:

POST

https://api.inspiredlms.com/organizations/99999/groups/{groupID}/explicitinclusionlistusers

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"userid":"444038"}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X POST -d "@addmember.json" "https://api.inspiredlms.com/organizations/99999/groups/345/explicitinclusionlistusers"

here, content of @addmember.json file is:

{"userid":"444038"}

Response:

HTTP/1.1 201 Created

Location: https://api.inspiredlms.com/organizations/99999/groups/345/explicitinclusionlistusers/444038


Remove a User from a Group's Explicit Inclusion List

Description:

Remove a user from a group's explicit inclusion list.

URL:

https://api.inspiredlms.com/organizations/{orgID}/groups/{groupID}/explicitinclusionlistusers/{userID}

Method:

DELETE

Response Type:

JSON

HTTP Request Example:

DELETE

https://api.inspiredlms.com/organizations/99999/groups/345/explicitinclusionlistusers/12345

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X DELETE "https://api.inspiredlms.com/organizations/99999/groups/345/explicitinclusionlistusers/12345"

Response:

HTTP/1.1 204 No Content


Get All Members / Users Of a Group's Explicit Exclusion List

Description:

Get all the users of a group's explicit exclusion list based on the specified parameters. Supports pagination.

URL:

https://api.inspiredlms.com/organizations/{orgID}/groups/{groupID}/explicitexclusionlistusers

Method:

GET

Response Type:

JSON

Parameters:

Besides standard pagination and sort parameters, it accepts search on any user profile field.

Query String Parameter Data Type Description Validations
sort string get the results in specified sorting order. If nothing is passed, it returns result in F003 ascending order.
  • Supported user profile field code for sorting are: F001, F002, F003, F004, F006, F011, F012, F015, F019, F020, F021

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/groups/345/explicitexclusionlistusers

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/groups/345/explicitexclusionlistusers"

Response:

Since it supports pagination, response may include link header if resultant records are more than the page_size.

HTTP/1.1 200 Ok

[
{
"ID": 517244,
"UserStatus": "Active",
"Profile": {
"F001": "John",
"F002": "",
"F003": "Doe",
"F004": "Emp001",
"F005": null,
"F006": "English",
"F007": "Manager",
"F008": "",
"F009": "",
"F010": "San Antonio",
"F011": "United States",
"F012": "Texas",
"F013": "",
"F014": "",
"F015": "john.doe@email.com",
"F016": null,
"F017": "",
"F018": "",
"F019": "Region 1",
"F019_ID": 13306,
"F020": "Division 1",
"F020_ID": 8463,
"F021": "Department 1",
"F021_ID": 15136,
"F022": "",
"F023": "(GMT-06.00) Central Time (US & Canada)",
"F024": "",
"F025": "",
"F026": "",
"F027": "",
"F031": "API",
"F032": "2013-10-23T13:30:38.22",
"F033": "",
"F034": ""
}
},
{
"ID": 517226,
"UserStatus": "Active",
"Profile": {
"F001": "Demo",
"F002": "",
"F003": "User",
"F004": "Emp002",
"F005": null,
"F006": "English",
"F007": "",
"F008": "",
"F009": "",
"F010": "",
"F011": "US",
"F012": "NE",
"F013": "",
"F014": "",
"F015": "demo.user@email.com",
"F016": null,
"F017": "",
"F018": "",
"F019": "Region 1",
"F019_ID": 13306,
"F020": "Division 1",
"F020_ID": 8463,
"F021": "Department 1",
"F021_ID": 15136,
"F022": "",
"F023": "(GMT-06.00) Central Time (US & Canada)",
"F024": "",
"F025": "",
"F026": "",
"F027": "",
"F031": "LDAP",
"F032": "2013-10-17T12:34:34.61",
"F033": "",
"F034": ""
}
}
]


Add a User in Group's Explicit Exclusion List

Description:

Add a new user in group's explicit exclusion list.

URL:

https://api.inspiredlms.com/organizations/{orgID}/groups/{groupID}/explicitexclusionlistusers

Method:

POST

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
sort string get the results in specified sorting order. If nothing is passed, it returns result in F003 ascending order.
  • Supported user profile field code for sorting are: F001, F002, F003, F004, F006, F011, F012, F015, F019, F020, F021

HTTP Request Example:

POST

https://api.inspiredlms.com/organizations/99999/groups/345/explicitexclusionlistusers

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"userid":"444038"}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X POST -d "@adduser.json" "https://api.inspiredlms.com/organizations/99999/groups/345/explicitexclusionlistusers"

here, content of @adduser.json file is:

{"userid":"444038"}

Response:

HTTP/1.1 201 Created

Location: https://api.inspiredlms.com/organizations/99999/groups/345/explicitexclusionlistusers/444038


Remove a User from a Group's Explicit Exclusion List

Description:

Remove a user from a group's explicit exclusion list.

URL:

https://api.inspiredlms.com/organizations/{orgID}/groups/{groupID}/explicitexclusionlistusers/{userID}

Method:

DELETE

Response Type:

JSON

HTTP Request Example:

DELETE

https://api.inspiredlms.com/organizations/99999/groups/{groupID}/explicitexclusionlistusers/12345

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X DELETE "https://api.inspiredlms.com/organizations/99999/groups/{groupID}/explicitexclusionlistusers/12345"

Response:

HTTP/1.1 204 No Content


User Hierarchy - Region, Division, and Department

Region


Get All Regions

Description:

Get all the regions of an organization specified by orgID.

URL:

https://api.inspiredlms.com/organizations/{orgID}/regions

Method:

GET

Response Type:

JSON

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/regions

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/regions"

Response:

HTTP/1.1 200 Ok

X-Total-Count: 3

[
{
"ID": 13298,
"Name": "Region1",
"NumberOfUsers":10

},
{
"ID": 13299,
"Name": "Region2",
"NumberOfUsers":5 
},
{
"ID": 13320,
"Name": "Region3",
"NumberOfUsers":7 
}
]


Create a Region

Description:

Create a new region based on the parameters specified.

URL:

https://api.inspiredlms.com/organizations/{orgID}/regions

Method:

POST

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
name string Name of the region
  • Is Required: Yes
  • Maximum Length: 100 characters
  • Restricted Characters: % \ + ; " < > : ?
  • & # are restricted by functionality and not error if using iLMS connect

HTTP Request Example:

POST

https://api.inspiredlms.com/organizations/99999/regions

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"name":"MyRegion"}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X POST -d "@createreg.json" "https://api.inspiredlms.com/organizations/99999/regions"

here, content of @createreg.json file is:

{
"name": "MyRegion"
}

Response:

 If successful, 201 status code will be return along with ID of new region.

HTTP/1.1 201 Created

Location: https://api.inspiredlms.com/organizations/99999/regions/123456

123456


Update Region Name

Description:

Modify region name based on the parameters specified.

URL:

https://api.inspiredlms.com/organizations/{orgID}/regions/{regionID}

Method:

PUT

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
name string Name of the region
  • Is Required: Yes
  • Maximum Length: 100 characters
  • Restricted Characters: % \ + ; " < > : ?
  • & # are restricted by functionality and not error if using iLMS connect

HTTP Request Example:

PUT

https://api.inspiredlms.com/organizations/99999/regions/123456

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"name":"MyNewRegion"}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X PUT -d "@updatereg.json" "https://api.inspiredlms.com/organizations/99999/regions/123456"

here, content of @updatereg.json file is:

{
"name": "MyNewRegion"
}

Response:

HTTP/1.1 204 No Content


Delete a Region

Description:

Delete the region identified by regionID.

URL:

https://api.inspiredlms.com/organizations/{orgID}/regions/{regionID}

Method:

DELETE

Response Type:

JSON

HTTP Request Example:

DELETE

https://api.inspiredlms.com/organizations/99999/regions/123456

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X DELETE "https://api.inspiredlms.com/organizations/99999/regions/123456"

Response:

HTTP/1.1 204 No Content


Division 


Get All Divisions

Description:

Get all the divisions of a region specified by regionID.

URL:

https://api.inspiredlms.com/organizations/{orgID}/regions/{regionID}/divisions

Method:

GET

Response Type:

JSON

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/regions/123456/divisions

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/regions/123456/divisions"

Response:

HTTP/1.1 200 Ok

X-Total-Count: 3

[
{
"ID": 8685,
"Name": "Division1",
"NumberOfUsers":5

},
{
"ID": 8690,
"Name": "Division2",
"NumberOfUsers":15
},
{
"ID": 8691,
"Name": "Division3",
"NumberOfUsers":45
}
]


Create a Division

Description:

Create a new division inside a region based on the parameters specified.

URL:

https://api.inspiredlms.com/organizations/{orgID}/regions/{regionID}/divisions

Method:

POST

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
name string Name of the division
  • Is Required: Yes
  • Maximum Length: 100 characters
  • Restricted Characters: % \ + ; " < > : ?

HTTP Request Example:

POST

https://api.inspiredlms.com/organizations/99999/regions/123456/divisions

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"name":"MyDivision"}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X POST -d "@creatediv.json" "https://api.inspiredlms.com/organizations/99999/regions/123456/divisions"

here, content of @creatediv.json file is:

{
"name": "MyDivision"
}

Response:

HTTP/1.1 201 Created

Location: https://api.inspiredlms.com/organizations/99999/regions/123456/divisions/234567

234567


Update Division Name

Description:

Modify division name based on the parameters specified.

URL:

https://api.inspiredlms.com/organizations/{orgID}/regions/{regionID}/divisions/{divisionID}

Method:

PUT

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
name string Name of the division
  • Is Required: Yes
  • Maximum Length: 100 characters
  • Restricted Characters: % \ + ; " < > : ?
  • & # are restricted by functionality and not error if using iLMS connect

HTTP Request Example:

PUT

https://api.inspiredlms.com/organizations/99999/regions/123456/divisions/234567

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"name":"MyNewDivision"}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X PUT -d "@updatediv.json" "https://api.inspiredlms.com/organizations/99999/regions/123456/divisions/234567"

here, content of @updatediv.json file is:

{
"name": "MyNewDivision"
}

Response:

HTTP/1.1 204 No Content


Delete a Division

Description:

Delete the division identified by divisionID.

URL:

https://api.inspiredlms.com/organizations/{orgID}/regions/{regionID}/divisions/{divisionID}

Method:

DELETE

Response Type:

JSON

HTTP Request Example:

DELETE

https://api.inspiredlms.com/organizations/99999/regions/123456/divisions/234567

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X DELETE "https://api.inspiredlms.com/organizations/99999/regions/123456/divisions/234567"

Response:

HTTP/1.1 204 No Content


Department 


Get All Departments

 Description:

Get all the departments of a division and region specified by divisionID and regionID.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/regions/{regionID}/divisions/{divisionID}/departments

Method:

GET

Response Type:

JSON

 HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/regions/123456/divisions/{divisionID}/departments

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/regions/123456/divisions/234567/departments"

Response:

HTTP/1.1 200 Ok

X-Total-Count: 3

[
{
"ID": 9101,
"Name": "Department1",
"NumberOfUsers":36

},
{
"ID": 9102,
"Name": "Department2",
"NumberOfUsers":4 
},
{
"ID": 9105,
"Name": "Department3",
"NumberOfUsers":1 
}
]


Create a Department

Description:

Create a new department inside a division and region based on the parameters specified.

URL:

https://api.inspiredlms.com/organizations/{orgID}/regions/{regionID}/divisions/{divisionID}/departments

Method:

POST

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
name string Name of the department
  • Is Required: Yes
  • Maximum Length: 100 characters
  • Restricted Characters: % \ + ; " < > : ?
  • & # are restricted by functionality and not error if using iLMS connect

 HTTP Request Example:

POST

https://api.inspiredlms.com/organizations/99999/regions/123456/divisions/234567/departments

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"name":"MyDepartment"}

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X POST -d "@createdep.json" "https://api.inspiredlms.com/organizations/99999/regions/123456/divisions/234567/departments"

here, content of @createdep.json file is:

{
"name": "MyDepartment"
}

 Response:

HTTP/1.1 201 Created

Location: https://api.inspiredlms.com/organizations/99999/regions/123456/divisions/234567/departments/345678

345678


Update Department Name

Description:

Modify department name based on the parameters specified.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/regions/{regionID}/divisions/{divisionID}/departments/{deptID}

Method:

PUT

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
name string Name of the department
  • Is Required: Yes
  • Maximum Length: 100 characters
  • Restricted Characters: % \ + ; " < > : ?

 HTTP Request Example:

PUT

https://api.inspiredlms.com/organizations/99999/regions/123456/divisions/234567/departments/345678

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"name":"MyNewDepartment"}

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X PUT -d "@updatedep.json" "https://api.inspiredlms.com/organizations/99999/regions/123456/divisions/234567/departments/345678"

here, content of @updatedep.json file is:

{
"name": "MyNewDepartment"
}

 Response:

HTTP/1.1 204 No Content


Delete a Department

 Description:

Delete the department identified by deptID.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/regions/{regionID}/divisions/{divisionID}/departments/{deptID}

Method:

DELETE

Response Type:

JSON

 HTTP Request Example:

DELETE

https://api.inspiredlms.com/organizations/99999/regions/123456/divisions/234567/departments/345678

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X DELETE "https://api.inspiredlms.com/organizations/99999/regions/123456/divisions/234567/departments/345678"

 Response:

HTTP/1.1 204 No Content

Transcripts 

Get Transcripts Of A User

 Description:

Get the transcript of a user as per parameter specified.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/users/{userid}/transcripts

Method:

GET

Response Type:

JSON

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/users/123456/transcripts

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/users/123456/transcripts"

 Response:

HTTP/1.1 200 Ok

[

{
"CourseName": "Security Awareness",
"CourseID": "fO1uIKJO",
"SessionName": "",
"SessionID": 0,
"RequirementType": "Mandatory",
"LicenseExpirationDate": "2014-01-28T16:30:39.37",
"EnrollmentDate": "2013-12-09T16:30:39.37",
"DueDate": "2014-01-01T04:00:00",
"StartDate": null,
"CompletionDate": null,
"Score": 0,
"Status": "Not Started",
"TimeSpent": 0,
"CertificationStatus": "Never Certified",
"CertificationExpirationDate": null,
"Credits": 0.0,
"Hours": 0.0
},
{
"CourseName": "Data Security",
"CourseID": "wqivr6aA",
"SessionName": "",
"SessionID": 0,
"RequirementType": "Mandatory",
"LicenseExpirationDate": null,
"EnrollmentDate": "2013-12-09T16:30:48.213",
"DueDate": null,
"StartDate": "2013-12-13T05:21:20.84",
"CompletionDate": "2013-12-13T05:21:20.84",
"Score": 100,
"Status": "Pass",
"TimeSpent": 20,
"CertificationStatus": null,
"CertificationExpirationDate": null,
"Credits": 0.0,
"Hours": 0.0
}
]


Get Transcripts Of A User For A Specific Course

 Description:

Get the transcript of a user for a course as per parameter specified.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/users/{userID}/courses/{courseID}/transcripts

Method:

GET

Response Type:

JSON

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/users/123456/courses/fO1uIKJO/transcripts

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/users/123456/courses/fO1uIKJO/transcripts"

 Response:

HTTP/1.1 200 Ok

[
{
"CourseName": "Security Awareness",
"CourseID": "fO1uIKJO",
"SessionName": "",
"SessionID": 0,
"RequirementType": "Mandatory",
"LicenseExpirationDate": "2014-01-28T16:30:39.37",
"EnrollmentDate": "2013-12-09T16:30:39.37",
"DueDate": "2014-01-01T04:00:00",
"StartDate": null,
"CompletionDate": null,
"Score": 0,
"Status": "Not Started",
"TimeSpent": 0,
"CertificationStatus": null,
"CertificationExpirationDate": null,
"Credits": 0.0,
"Hours": 0.0
}

]


Get Transcripts Of A User For A Specific Curriculum

 Description:

Get the transcript of a user for a curriculum as per parameter specified.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/users/{userID}/curricula/{courseID}/transcripts

Method:

GET

Response Type:

JSON

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/users/123456/curricula/PP1uIKJO/transcripts

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/users/123456/curricula/PP1uIKJO/transcripts"

 Response:

HTTP/1.1 200 Ok

[
{
"CourseName": "Security_Curriculum",
"CourseID": "PP1uIKJO",
"SessionName": "",
"SessionID": 0,
"RequirementType": "Mandatory",
"LicenseExpirationDate": "2014-01-28T16:30:39.37",
"EnrollmentDate": "2013-12-09T16:30:39.37",
"DueDate": "2014-01-01T04:00:00",
"StartDate": null,
"CompletionDate": null,
"Score": 0,
"Status": "Not Started",
"TimeSpent": 0,
"CertificationStatus": null,
"CertificationExpirationDate": null,
"Credits": 0.0,
"Hours": 0.0
}

]


Get Transcripts Of A User For A Specific Session

 Description:

Get the transcript of a user for a specific session as per parameter specified.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/users/{userID}/courses/{courseID}/sessions/{sessionID}/transcripts

Method:

GET

Response Type:

JSON

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/users/123456/courses/iiOYhg6E/sessions/517378/transcripts

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/users/123456/courses/iiOYhg6E/sessions/517378/transcripts"

 Response:

HTTP/1.1 200 Ok

{


"CourseName": "ILT Test",
"CourseID": "iiOYhg6E",
"SessionName": "Sep 8, 2013 7:30 PM (CDT) to Sep 9, 2013 1:30 AM (CDT)",
"SessionID": 5119,
"RequirementType": "Mandatory",
"LicenseExpirationDate": null,
"DueDate": null,
"StartDate": null,
"CompletionDate": null,
"EnrollmentDate": "2013-07-13T07:54:27.59",
"Score": 0,
"Status": "Not Started",
"TimeSpent": 0,
"CertificationStatus": null,
"CertificationExpirationDate": null,
"Hours": 0,
"Credits": 0
}


Modify User's Transcript For A Course/Curriculum/Session

Description:

Modify the user's transcript for a course/curriculum/session identified by courseID and/or sessionID.

URL:

Course: https://api.inspiredlms.com/organizations/{orgID}/users/{userID}/courses/{courseID}/transcripts

Curriculum: https://api.inspiredlms.com/organizations/{orgID}/users/{userID}/curricula/{courseID}/transcripts

Session: https://api.inspiredlms.com/organizations/{orgID}/users/{userID}/courses/{courseID}/sessions/{sessionID}/transcripts

Method:

PUT

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
EnrollmentDate

iso8601 UTC string

Format: "yyyy-MM-ddTHH:mm:ss"

Modify enrollment date.
  • Is Required: No. 
  • Valid values: iso8601 UTC string
LicenseExpirationDate

iso8601 UTC string

Format: "yyyy-MM-ddTHH:mm:ss"

Modify license expiration date for the course. User will not be able to launch the course after this date.
  • Is Required: No. 
  • Valid values: iso8601 UTC string
StartDate

iso8601 UTC string

Format: "yyyy-MM-ddTHH:mm:ss"

Modify start date.
  • Is Required: No.
  • Valid values: iso8601 UTC string
  • Only valid if status is not "Not Started"
DueDate

iso8601 UTC string

Format: "yyyy-MM-ddTHH:mm:ss"

Modify due date. pass null to remove any due date already set.
  • Is Required: No. 
  • Valid values: iso8601 UTC string or null
CompletionDate

iso8601 UTC string

Format: "yyyy-MM-ddTHH:mm:ss"

Modify completion date.
  • Is Required: No. 
  • Valid values: iso8601 UTC string
  • Only valid if status is "Pass" or "Fail"
CertificationExpirationDate

iso8601 UTC string

Format: "yyyy-MM-ddTHH:mm:ss"

Modify the certification expiration date.
  • Is Required: No.
  • Valid values: iso8601 UTC string
  • Only valid when course is a certification enabled course.
RequirementType string Modify the requirement type.
  • Is Required: No.
  • Valid values: mandatory, optional
Status string Modify the course status of the course. It has high priority on other fields. For example, if status is set to "Not Started" system will ignore other dates such as completion date, start date which are ir-relevant with this status. In another case, if new status is "Pass" but no other dates are passed, system will set current date in start date, completion date with score as 100% etc.
  • Is Required: No.
  • Valid values: not started, pass, fail, waived
Score integer Modify the % score.
  • Is Required: No.
  • Valid values: 0 - 100
  • Only valid when course status is "pass" or "fail"

HTTP Request Example:

PUT

https://api.inspiredlms.com/organizations/99999/users/123456/transcripts?courseid=fO1uIKJO

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"enrollmentdate":"2013-10-10T10:00:00","startdate":"2013-10-12T10:00:00","completiondate":"2013-10-14T10:00:00","score":"100","status":"pass"}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X PUT -d "@modifyTranscript.json" "https://api.inspiredlms.com/organizations/99999/users/123456/transcripts?courseid=fO1uIKJO"

here, content of @modifyTranscript.json file is:

{
"enrollmentdate": "2013-10-10T10:00:00",
"startdate": "2013-10-12T10:00:00",
"completiondate": "2013-10-14T10:00:00",
"score": "100",
"status": "pass"
}

Response:

HTTP/1.1 204 No Content

Courses 

Get All Courses

 Description:

Get all the courses. It supports pagination.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/courses

Method:

GET

Response Type:

JSON

Parameters:

Query String Parameter Data Type Description Validations
courseType string Filter courses based on their type. Use from the followings:

iComposer: to return all icomposer courses

SCORM: to return all SCORM courses

ILT: to return all ILT courses

EVENTS: to return all even courses
  • Is Required: No. By default API returns all types of courses.
  • Other: Pass only one value at a time.
includeHistorical boolean If true, historical courses will also be included in the result set.
  • Is Required: No. By default API returns non-historical courses.
search string It will be a like search and look this text in course name, description, outline and keywords.
  • Is Required: No
sort boolean By default results are sorted in course name ascending order.

Use "sort=-name" to sort results in course name descending order.
  • Is Required: No

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/courses

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/courses"

 Response:

HTTP/1.1 200 Ok

X-Total-Count: 20
next: http://api.ilmsdev/organizations/824/courses?page=2&per_page=2
last: http://api.ilmsdev/organizations/824/courses?page=10&per_page=2

 

[
{
"ID": "p1gyJg4a",
"Name": "Security",
"Type": "iComposer",
"DeliveryType": "Web-based",
"DefaultRequirementType": "Mandatory",
"Credits": "10",
"Hours": "4",
"Status": "Active",
"DefaultDueDateSettings": {
"DefaultDueDate": null,
"DaysAfterEnrollment": 4
}
},
{
"ID": "x56QjLXI",
"Name": "Security Awareness",
"Type": "SCORM",
"DeliveryType": "Web-based",
"DefaultRequirementType": "Mandatory",
"Credits": "0",
"Hours": "0",
"Status": "Active",
"DefaultDueDateSettings": {
"DefaultDueDate": "2014-11-22T23:01:00",
"DaysAfterEnrollment": null
}
}
]


Get A Course

 Description:

Get a course based on the parameter specified.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/courses/{courseID}

Method:

GET

Response Type:

JSON

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/courses/p1gyJg4a

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/courses/p1gyJg4a"

 Response:

HTTP/1.1 200 Ok

{
"ID": "p1gyJg4a",
"Name": "Security",
"Type": "iComposer",
"DeliveryType": "Web-based",
"DefaultRequirementType": "Mandatory",
"Credits": "10",
"Hours": "4",
"Status": "Active",
"DefaultDueDateSettings": {
"DefaultDueDate": null,
"DaysAfterEnrollment": 4
}
}


Get Only Due Date Settings of a Course

 Description:

Get Due Date settings of a course based on the parameter specified.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/courses/{courseID}/duedate

Method:

GET

Response Type:

JSON

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/courses/p1gyJg4a/duedate

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/courses/p1gyJg4a/duedate"

 Response:

HTTP/1.1 200 Ok

{
"DefaultDueDate": null,
"DaysAfterEnrollment": 4
}


Modify Due Date Settings of a course

Description:

Modify the default due date settings of a course identified by courseID.

URL:

https://api.inspiredlms.com/organizations/{orgID}/courses/{courseID}/DueDate

Method:

PUT

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
DefaultDueDate iso8601 UTC string

Format: "yyyy-MM-ddTHH:mm:ss"
Set a default due date for the course. Pass null to remove any previous date set for the course.
  • Is Required: Yes. 
  • Valid values: iso8601 UTC string, or null.
DaysAfterEnrollment integer Set number of days after enrollment, after which course will be set to due for a user.
  • Is Required: Yes.
  • Valid values: any positive integer (1-999), or null

HTTP Request Example:

PUT

https://api.inspiredlms.com/organizations/99999/courses/p1gyJg4a/DueDate

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"DefaultDueDate":"2014-11-22T00:00:00","DaysAfterEnrollment":null}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X PUT -d "@modifyDueDate.json" "https://api.inspiredlms.com/organizations/99999/courses/p1gyJg4a/DueDate"

here, content of @modifyDueDate.json file is:

{
"DefaultDueDate": "2014-11-22T00:00:00",
"DaysAfterEnrollment": null
}

Response:

HTTP/1.1 204 No Content


Inactivate a course

Description:

Inactivate the course identified by courseID.

URL:

https://api.inspiredlms.com/organizations/{orgID}/courses/{courseID}

Method:

DELETE

Response Type:

JSON

HTTP Request Example:

DELETE

https://api.inspiredlms.com/organizations/99999/courses/p1gyJg4a/Activate

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X DELETE "https://api.inspiredlms.com/organizations/99999/courses/p1gyJg4a/Activate"

Response:

HTTP/1.1 204 No Content


Activate a course

Description:

Activate the course identified by courseID.

URL:

https://api.inspiredlms.com/organizations/{orgID}/courses/{courseID}/Activate

Method:

PUT

Response Type:

JSON

HTTP Request Example:

PUT

https://api.inspiredlms.com/organizations/99999/courses/p1gyJg4a/Activate

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X PUT -d "" "https://api.inspiredlms.com/organizations/99999/courses/p1gyJg4a/Activate"

Response:

HTTP/1.1 204 No Content

Curricula 

Get All Curricula/Search by Name

 Description:

Get all the curricula.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/curricula

Method:

GET

Response Type:

JSON

Parameters:

Query String Parameter Data Type Description Validations
name string It will be a like search and look this text in group name.
  • Is Required: No

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/curricula

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/curricula"

 Response:

HTTP/1.1 200 Ok

[
{
"ID": "dHg6Kdl8",
"Name": "Security Awareness Curriculum",
"DefaultDueDateSettings": {
"DefaultDueDate": "2014-11-22T23:01:00",
"DaysAfterEnrollment": null
}
},
{
"ID": "h0lHIuoD",
"Name": "Curriculum2",
"DefaultDueDateSettings": {
"DefaultDueDate": null,
"DaysAfterEnrollment": 30
}
}
]


Get A Curriculum

 Description:

Get a curriculum based on the parameter specified.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/curricula/{curriculumID}

Method:

GET

Response Type:

JSON

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/curricula/dHg6Kdl8

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/curricula/dHg6Kdl8"

 Response:

HTTP/1.1 200 Ok

{
"ID": "dHg6Kdl8",
"Name": "Security Awareness Curriculum",
"DefaultDueDateSettings": {
"DefaultDueDate": "2014-11-22T23:01:00",
"DaysAfterEnrollment": null
}
}


Modify Due Date Settings of a curriculum

Description:

Modify the default due date settings of a curriculum identified by curriculumID.

URL:

https://api.inspiredlms.com/organizations/{orgID}/curriculum/{curriculumID}/DueDate

Method:

PUT

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
DefaultDueDate iso8601 UTC string

Format: "yyyy-MM-ddTHH:mm:ss"
Set a default due date for the course. Pass null to remove any previous date set for the course.
  • Is Required: Yes. 
  • Valid values: iso8601 UTC string, or null.
DaysAfterEnrollment integer Set number of days after enrollment, after which course will be set to due for a user.
  • Is Required: Yes.
  • Valid values: any positive integer (1-999), or null

HTTP Request Example:

PUT

https://api.inspiredlms.com/organizations/99999/curriculum/dHg6Kdl8/DueDate

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"DefaultDueDate":"2014-11-22T00:00:00","DaysAfterEnrollment":null}

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X PUT -d "@modifyDueDate.json" "https://api.inspiredlms.com/organizations/99999/curriculum/dHg6Kdl8/DueDate"

here, content of @modifyDueDate.json file is:

{
"DefaultDueDate": "2014-11-22T00:00:00",
"DaysAfterEnrollment": null
}

 Response:

HTTP/1.1 204 No Content

Instructor-Lead Training Sessions

Get All Sessions of a ILT/Event

Description:

Get sessions of a ILT/event based on the parameters specified.

URL:

https://api.inspiredlms.com/organizations/{orgID}/courses/{courseid}/sessions

Method:

GET

Response Type:

JSON

Parameters:

Querystring Parameter Data Type Description Validations
sessionstartdate datetime Use this to return sessions whose start date is equal or in future than this.
  • Is Required: No
sessionenddate datetime Use this to return sessions whose end date is equal or in past than this.
  • Is Required: No
sort string results can be sort on following: sessionstartdate, sessionenddate, locationname, roomname

To return results in descending order, use dash before field value.

For example: sort=-sessionstartdate
  • Is Required: No. If not passed, results will return in session start date ascending order.

 it supports pagination. So standard pagination parameters (page & per_page) can be used in query string.

 HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/courses/pyOgaoIi/sessions?sessionstartdate=2009-10-10&sessionenddate=2014-01-01&sort=-sessionstartdate&page=1&per_page=5

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/courses/pyOgaoIi/sessions?sessionstartdate=2009-10-10&sessionenddate=2014-01-01&sort=-sessionstartdate&page=1&per_page=5"

Response:

HTTP/1.1 200 Ok

X-Total-Count: 8
next: http://api.ilmsdev/organizations/707/courses/pyOgaoIi/sessions?sessionstartdate=2009-10-10&sessionenddate=2014-01-01&sort=-sessionstartdate&page=2&per_page=5
last: http://api.ilmsdev/organizations/707/courses/pyOgaoIi/sessions?sessionstartdate=2009-10-10&sessionenddate=2014-01-01&sort=-sessionstartdate&page=2&per_page=5

[
{
"CourseName": "Security Awareness",
"CourseID": "pyOgaoIi",
"SessionID": 4855,
"StartDateTime": "2011-03-21T15:00:00",
"EndDateTime": "2011-03-21T21:00:00",
"RoomName": "Confrence 1",
"Location": {
"Name": " San Antonio",
"TimeZoneName": "(GMT-06.00) Central Time (US & Canada)"
},
"Instructors": [
{
"ID": 45921,
"F001": "John",
"F003": "Doe",
"F015": "john.doe@email.com",
"F004": ""
}
]
},
{
"CourseName": "Security Awareness",
"CourseID": "pyOgaoIi",
"SessionID": 4860,
"StartDateTime": "2011-02-15T15:00:00",
"EndDateTime": "2011-02-15T23:00:00",
"RoomName": "Confrence 1",
"Location": {
"Name": " San Antonio",
"TimeZoneName": "(GMT-06.00) Central Time (US & Canada)"
},
"Instructors": [
{
"ID": 45921,
"F001": "John",
"F003": "Doe",
"F015": "john.doe@email.com",
"F004": ""
}
]
},
{
"CourseName": "Security Awareness",
"CourseID": "pyOgaoIi",
"SessionID": 4827,
"StartDateTime": "2011-01-29T15:00:00",
"EndDateTime": "2011-01-29T23:00:00",
"RoomName": "Confrence 1",
"Location": {
"Name": " San Antonio",
"TimeZoneName": "(GMT-06.00) Central Time (US & Canada)"
},
"Instructors": [
{
"ID": 45921,
"F001": "John",
"F003": "Doe",
"F015": "john.doe@email.com",
"F004": ""
}
]
},
{
"CourseName": "Security Awareness",
"CourseID": "pyOgaoIi",
"SessionID": 4813,
"StartDateTime": "2011-01-01T15:00:00",
"EndDateTime": "2011-01-01T23:00:00",
"RoomName": "Confrence 1",
"Location": {
"Name": " San Antonio",
"TimeZoneName": "(GMT-06.00) Central Time (US & Canada)"
},
"Instructors": [
{
"ID": 45921,
"F001": "John",
"F003": "Doe",
"F015": "john.doe@email.com",
"F004": ""
}
]
},
{
"CourseName": "Security Awareness",
"CourseID": "pyOgaoIi",
"SessionID": 4798,
"StartDateTime": "2010-12-25T15:00:00",
"EndDateTime": "2010-12-25T23:00:00",
"RoomName": "Confrence 1",
"Location": {
"Name": " San Antonio",
"TimeZoneName": "(GMT-06.00) Central Time (US & Canada)"
},
"Instructors": [
{
"ID": 45921,
"F001": "John",
"F003": "Doe",
"F015": "john.doe@email.com",
"F004": ""
}
]
}
]


Get A Session

Description:

Get a session of a ILT/event based on the parameters specified.

URL:

https://api.inspiredlms.com/organizations/{orgID}/courses/{courseid}/sessions/sessionid

Method:

GET

Response Type:

JSON

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/courses/pyOgaoIi/sessions/4855

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/courses/pyOgaoIi/sessions/4855"

Response:

HTTP/1.1 200 Ok

{
"CourseName": "Security Awareness",
"CourseID": "pyOgaoIi",
"SessionID": 4855,
"StartDateTime": "2011-03-21T15:00:00",
"EndDateTime": "2011-03-21T21:00:00",
"RoomName": "Confrence 1",
"Location": {
"Name": " San Antonio",
"TimeZoneName": "(GMT-06.00) Central Time (US & Canada)"
},
"Instructors": [
{
"ID": 45921,
"F001": "John",
"F003": "Doe",
"F015": "john.doe@email.com",
"F004": ""
}
]
}


Enrollments 

Get All The Enrollments Of A Course

 Description:

Get all the enrollment records of a course. It supports pagination.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/courses/{courseID}/enrollments

Method:

GET

Response Type:

JSON

Parameters:

Query String Parameter Data Type Description Validations
includeInactiveUsers boolean If true, inactive users will also be included in the result set.
  • Is Required: No. By default API returns active users only.
sort boolean Get the results in specified sorting order. If nothing is passed, it returns result in F003 ascending order.
  • Is Required: No
  • Supported field code for sorting are: F001, F003, F004, F015, F019, F020, F021

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/courses/meOexN1A/enrollments?page=1&per_page=2

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/courses/meOexN1A/enrollments"

 Response:

HTTP/1.1 200 Ok

X-Total-Count: 20
next: http://api.ilmsdev/organizations/824/courses?page=2&per_page=2
last: http://api.ilmsdev/organizations/824/courses?page=10&per_page=2

[
{
"User": {
"ID": 517371,
"UserStatus": "Inactive",
"Profile_Basic": {
"F001": "John",
"F003": "Doe",
"F004": "emp001",
"F015": "john.doe@email.com",
"F006": "English",
"F019": "Demo Region",
"F019_ID": 8090,
"F020": "Demo Division",
"F020_ID": 3196,
"F021": "Demo Department",
"F021_ID": 4680
}
},
"CourseName": "Course 99",
"CourseID": "meOexN1A",
"SessionName": "",
"SessionID": null,
"RequirementType": "Mandatory",
"DueDate": null,
"StartDate": null,
"CompletionDate": null,
"Score": null,
"CourseStatus": "Not Started",
"EnrollmentDate": "2013-12-08T10:05:59.877",
"TimeSpent": 0
},
{
"User": {
"ID": 517372,
"UserStatus": "Inactive",
"Profile_Basic": {
"F001": "deepak",
"F003": "jain",
"F004": "",
"F015": "dep@testiel.com",
"F006": "English",
"F019": "",
"F019_ID": 8090,
"F020": "B3",
"F020_ID": 3196,
"F021": "B3",
"F021_ID": 4680
}
},
"CourseName": "Course 99",
"CourseID": "meOexN1A",
"SessionName": "",
"SessionID": null,
"RequirementType": "Mandatory",
"DueDate": null,
"StartDate": "2013-12-11T18:18:39.857",
"CompletionDate": "2013-12-11T18:18:39.857",
"Score": null,
"CourseStatus": "Pass",
"EnrollmentDate": "2013-12-08T22:00:38.897",
"TimeSpent": 10
}
]


Enroll User In A Course

 Description:

Enroll user in a course based on the parameter specified.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/courses/{courseID}/enrollments

Method:

POST

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
userID integer Identifier of user.
  • Is Required: Yes. 

 HTTP Request Example:

POST

https://api.inspiredlms.com/organizations/99999/courses/meOexN1A/enrollments

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"userid":"444038"}

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X POST -d "@enrolluser.json" "https://api.inspiredlms.com/organizations/99999/courses/meOexN1A/enrollments"

here, content of @enrolluser.json file is:

{"userid":"444038"}

Response:

HTTP/1.1 204 No Content


Un-enroll User From A Course

 Description:

Un-enroll user from a course based on the parameter specified.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/courses/{courseID}/enrollments

Method:

DELETE

Response Type:

JSON

HTTP Request Example:

DELETE

https://api.inspiredlms.com/organizations/99999/courses/meOexN1A/enrollments

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"userid":"444038"}

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X DELETE -d "@unenrolluser.json" "https://api.inspiredlms.com/organizations/99999/courses/meOexN1A/enrollments"

here, content of @unenrolluser.json file is:

{"userid":"444038"}

Response:

HTTP/1.1 204 No Content


Get All The Enrollments Of A Curriculum

 Description:

Get all the enrollment records of a curriculum. It supports pagination.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/curricula/{courseID}/Enrollments

Method:

GET

Response Type:

JSON

Parameters:

Query String Parameter Data Type Description Validations
includeInactiveUsers boolean If true, inactive users will also be included in the result set.
  • Is Required: No. By default API returns active users only.
sort boolean Get the results in specified sorting order. If nothing is passed, it returns result in F003 ascending order.
  • Is Required: No
  • Supported field code for sorting are: F001, F003, F004, F015, F019, F020, F021

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/curricula/h0lHIuoD/enrollments?page=1&per_page=2

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/curricula/h0lHIuoD/enrollments"

 Response:

HTTP/1.1 200 Ok

X-Total-Count: 20
next: http://api.ilmsdev/organizations/824/courses?page=2&per_page=2
last: http://api.ilmsdev/organizations/824/courses?page=10&per_page=2

 

[
{
"User": {
"ID": 517371,
"UserStatus": "Inactive",
"Profile_Basic": {
"F001": "John",
"F003": "Doe",
"F004": "emp001",
"F015": "john.doe@email.com",
"F006": "English",
"F019": "Demo Region",
"F019_ID": 8090,
"F020": "Demo Division",
"F020_ID": 3196,
"F021": "Demo Department",
"F021_ID": 4680
}
},
"CourseName": "Course 99",
"CourseID": "meOexN1A",
"SessionName": "",
"SessionID": null,
"RequirementType": "Mandatory",
"DueDate": null,
"StartDate": null,
"CompletionDate": null,
"Score": null,
"CourseStatus": "Not Started",
"EnrollmentDate": "2013-12-08T10:05:59.877",
"TimeSpent": 0
},
{
"User": {
"ID": 517372,
"UserStatus": "Inactive",
"Profile_Basic": {
"F001": "deepak",
"F003": "jain",
"F004": "",
"F015": "dep@testiel.com",
"F006": "English",
"F019": "",
"F019_ID": 8090,
"F020": "B3",
"F020_ID": 3196,
"F021": "B3",
"F021_ID": 4680
}
},
"CourseName": "Course 99",
"CourseID": "meOexN1A",
"SessionName": "",
"SessionID": null,
"RequirementType": "Mandatory",
"DueDate": null,
"StartDate": "2013-12-11T18:18:39.857",
"CompletionDate": "2013-12-11T18:18:39.857",
"Score": null,
"CourseStatus": "Pass",
"EnrollmentDate": "2013-12-08T22:00:38.897",
"TimeSpent": 10
}
]


Enroll User In A Curriculum

 Description:

Enroll user in a course based on the parameter specified.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/curricula/{courseID}/enrollments

Method:

POST

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
userID integer Identifier of user.
  • Is Required: Yes. 

 HTTP Request Example:

POST

https://api.inspiredlms.com/organizations/99999/curricula/h0lHIuoD/enrollments

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"userid":"444038"}

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X POST -d "@enrolluser.json" "https://api.inspiredlms.com/organizations/99999/curricula/h0lHIuoD/enrollments"

here, content of @enrolluser.json file is:

{"userid":"444038"}

Response:

HTTP/1.1 204 No Content


Un-enroll User From A Curriculum

 Description:

Un-enroll user from a course based on the parameter specified.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/curricula/{courseID}/enrollments

Method:

DELETE

Response Type:

JSON

HTTP Request Example:

DELETE

https://api.inspiredlms.com/organizations/99999/curricula/h0lHIuoD/enrollments

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"userid":"444038"}

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X DELETE -d "@unenrolluser.json" "https://api.inspiredlms.com/organizations/99999/curricula/h0lHIuoD/enrollments"

here, content of @unenrolluser.json file is:

{"userid":"444038"}

Response:

HTTP/1.1 204 No Content


Get All The Enrollments Of A Session

 Description:

Get all the enrollment records of a session. It supports pagination.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/courses/{courseID}/sessions/{sessionID}/enrollments

Method:

GET

Response Type:

JSON

Parameters:

Query String Parameter Data Type Description Validations
includeInactiveUsers boolean If true, inactive users will also be included in the result set.
  • Is Required: No. By default API returns active users only.
sort boolean Get the results in specified sorting order. If nothing is passed, it returns result in F003 ascending order.
  • Is Required: No
  • Supported field code for sorting are: F001, F003, F004, F015, F019, F020, F021

HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/courses/iiOYhg6E/sessions/1234/enrollments?page=1&per_page=2

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/courses/iiOYhg6E/sessions/1234/enrollments?page=1&per_page=2"

 Response:

HTTP/1.1 200 Ok

X-Total-Count: 20
next: http://api.ilmsdev/organizations/824/courses?page=2&per_page=2
last: http://api.ilmsdev/organizations/824/courses?page=10&per_page=2

 

[
{
"User": {
"ID": 517371,
"UserStatus": "Inactive",
"Profile_Basic": {
"F001": "John",
"F003": "Doe",
"F004": "emp001",
"F015": "john.doe@email.com",
"F006": "English",
"F019": "Demo Region",
"F019_ID": 8090,
"F020": "Demo Division",
"F020_ID": 3196,
"F021": "Demo Department",
"F021_ID": 4680
}
},
"CourseName": "ILT Test",
"CourseID": "iiOYhg6E",
"SessionName": "ILT Test :: Sep 8, 2014 7:30 PM (CDT) to Sep 9, 2014 1:30 AM (CDT)",
"SessionID": 1234,
"RequirementType": "Mandatory",
"DueDate": null,
"StartDate": null,
"CompletionDate": null,
"Score": null,
"CourseStatus": "Not Started",
"EnrollmentDate": "2013-12-08T10:05:59.877",
"TimeSpent": 0
},
{
"User": {
"ID": 517372,
"UserStatus": "Inactive",
"Profile_Basic": {
"F001": "deepak",
"F003": "jain",
"F004": "",
"F015": "dep@testiel.com",
"F006": "English",
"F019": "",
"F019_ID": 8090,
"F020": "B3",
"F020_ID": 3196,
"F021": "B3",
"F021_ID": 4680
}
},
"CourseName": "ILT Test",
"CourseID": "iiOYhg6E",
"SessionName": "ILT Test :: Sep 8, 2014 7:30 PM (CDT) to Sep 9, 2014 1:30 AM (CDT)",
"SessionID": 1234,
"RequirementType": "Mandatory",
"DueDate": null,
"StartDate": null,
"CompletionDate": null,
"Score": null,
"CourseStatus": "Not Started",
"EnrollmentDate": "2013-12-08T22:00:38.897",
"TimeSpent": 0
}
]


Enroll User In A Session

 Description:

Enroll user in a session based on the parameter specified.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/courses/{courseID}/sessions/{sessionID}/enrollments

Method:

POST

Response Type:

JSON

Parameters:

Parameter Data Type Description Validations
userID integer Identifier of user.
  • Is Required: Yes. 

 HTTP Request Example:

POST

https://api.inspiredlms.com/organizations/99999/courses/iiOYhg6E/sessions/1234/enrollments

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"userid":"444038"}

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X POST -d "@enrolluser.json" "https://api.inspiredlms.com/organizations/99999/courses/iiOYhg6E/sessions/1234/enrollments"

here, content of @enrolluser.json file is:

{"userid":"444038"}

Response:

HTTP/1.1 204 No Content


Un-enroll User From A Session

 Description:

Un-enroll user from a session based on the parameter specified.

 URL:

https://api.inspiredlms.com/organizations/{orgID}/courses/{courseID}/sessions/{sessionID}/enrollments

Method:

DELETE

Response Type:

JSON

HTTP Request Example:

DELETE

https://api.inspiredlms.com/organizations/99999/courses/iiOYhg6E/sessions/1234/enrollments

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

{"userid":"444038"}

 CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" -X DELETE -d "@unenrolluser.json" "https://api.inspiredlms.com/organizations/99999/courses/iiOYhg6E/sessions/1234/enrollments"

here, content of @unenrolluser.json file is:

{"userid":"444038"}

Response:

HTTP/1.1 204 No Content

Reports

Get Summary Report Of a Course, Curriculum or ILT Session

Description:

Get the summary report of a course, curriculum or ILT session based on the parameters specified.

URL:

https://api.inspiredlms.com/organizations/{orgID}/reports/enrollmentsummary?courseid={courseID}

https://api.inspiredlms.com/organizations/{orgID}/reports/enrollmentsummary?courseid={courseID}&sessionid={sessionID}

Method:

GET

Response Type:

JSON

Parameters:

Querystring Parameter Data Type Description Validations
courseid string represents ID of the course or curriculum
  • Is Required: Yes
sessionid integer represents ID of a ILT/Event session.

Use this parameter to get a report of a ILT/Event session.
  • Is Required: No
includeinactiveusers boolean true will include inactive users in report.
  • Is Required: No

 HTTP Request Example:

GET

https://api.inspiredlms.com/organizations/99999/reports/enrollmentsummary?courseid=plokiuytr&includeinactiveusers=true

HTTP 1.1

Content-type: application/json

Accept: application/json

APILoginID: YBA3hyozzqWGeA2koTvI1Q==

TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==

OrgID: 99999

CURL Request Example:

curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -H "APILoginID: YBA3hyozzqWGeA2koTvI1Q==" -H "TransactionKey: ggcyFzoFKxbUm+3DFd/N9Q==" -H "OrgID: 99999" "https://api.inspiredlms.com/organizations/99999/reports/enrollmentsummary?courseid=plokiuytr&includeinactiveusers=true"

Response:

If courseid represents a course:

HTTP/1.1 200 Ok

[
{
"CourseName": "Security Awareness",
"CourseType": "SCORM",
"CourseID": "plokiuytr",
"ParentCurriculumNameOfCourse": "",
"ParentCurriculumIDOfCourse": "",
"SessionID": 0,
"SessionName": "",
"Enrolled": 22,
"NotStarted": 19,
"InProgress": 0,
"Passed": 3,
"Failed": 0,
"Waived": 0
}
]

If courseid represents a curriculum. For a curriculum, output also includes all the sub-courses of that curriculum.

[
{
"CourseName": "Security",
"CourseType": "Curriculum",
"CourseID": "4mnvYSIi",
"ParentCurriculumNameOfCourse": "",
"ParentCurriculumIDOfCourse": "",
"SessionID": 0,
"SessionName": "",
"Enrolled": 5,
"NotStarted": 1,
"InProgress": 1,
"Passed": 1,
"Failed": 1,
"Waived": 1
},
{
"CourseName": "Security Awareness",
"CourseType": "iComposer",
"CourseID": "7E29dkwr",
"ParentCurriculumNameOfCourse": "Security",
"ParentCurriculumIDOfCourse": "4mnvYSIi",
"SessionID": 0,
"SessionName": "",
"Enrolled": 5,
"NotStarted": 1,
"InProgress": 1,
"Passed": 1,
"Failed": 1,
"Waived": 1
},
{
"CourseName": "Data Security",
"CourseType": "SCORM",
"CourseID": "Ux3oKZbz",
"ParentCurriculumNameOfCourse": "Security",
"ParentCurriculumIDOfCourse": "4mnvYSIi",
"SessionID": 0,
"SessionName": "",
"Enrolled": 5,
"NotStarted": 2,
"InProgress": 1,
"Passed": 1,
"Failed": 1,
"Waived": 0
}
]

If courseid represents a ILT/Event. For a IEL/EVENT, output also includes all the sessions of that ILT/Event.

[
{
"CourseName": "Security",
"CourseType": "ILT",
"CourseID": "pyOgaoIi",
"ParentCurriculumNameOfCourse": "",
"ParentCurriculumIDOfCourse": "",
"SessionID": 0,
"SessionName": "",
"Enrolled": 22,
"NotStarted": 12,
"InProgress": 0,
"Passed": 10,
"Failed": 0,
"Waived": 0
},
{
"CourseName": "Security",
"CourseType": "Session",
"CourseID": "pyOgaoIi",
"ParentCurriculumNameOfCourse": "",
"ParentCurriculumIDOfCourse": "",
"SessionID": 4746,
"SessionName": "Oct 14, 2010 3:00 AM to Oct 14, 2010 9:00 AM",
"Enrolled": 12,
"NotStarted": 12,
"InProgress": 0,
"Passed": 0,
"Failed": 0,
"Waived": 0
},
{
"CourseName": "Security",
"CourseType": "Session",
"CourseID": "pyOgaoIi",
"ParentCurriculumNameOfCourse": "",
"ParentCurriculumIDOfCourse": "",
"SessionID": 4760,
"SessionName": "Oct 20, 2010 10:00 AM to Oct 21, 2010 4:00 PM",
"Enrolled": 10,
"NotStarted": 0,
"InProgress": 0,
"Passed": 10,
"Failed": 0,
"Waived": 0
}
]

If sessionid is also passed along with courseid to get detail of a specific session.

[
{
"CourseName": "Security",
"CourseType": "Session",
"CourseID": "pyOgaoIi",
"ParentCurriculumNameOfCourse": "",
"ParentCurriculumIDOfCourse": "",
"SessionID": 4760,
"SessionName": "Oct 20, 2010 10:00 AM to Oct 21, 2010 4:00 PM",
"Enrolled": 10,
"NotStarted": 0,
"InProgress": 0,
"Passed": 10,
"Failed": 0,
"Waived": 0
}
]

Status Codes

Common status codes used in iLMS API

  • 200s - Success
  • 400s - Error Client Side
  • 500s - Error on Server Side

2xx - Success

Status Code Description
200 Ok The request is successful. The actual response will depend on the resource and request method. In a GET request, the response will contain the data respective to the requested resource.
201 Created This status confirms that a new resource is created. Response will have the unique ID of newly created resource. It is very common status code for "Post" request method.
204 No Content  This status code confirms that server successfully processed the request, but is not returning any content. It is a very common status code for "PUT" and "DELETE" request method.

4xx - Error Client Slide

Status Code Description
400 Bad Request There can be several reasons for getting this error. Generally it happens when request doesn't have all the parameters which is required to fulfill a request. Or it has invalid data. You should see the exact reason in the response.
401 Unauthorized Each request must have correct credentials information. Credential information is set of orgID, APILoginID, TransactionKey which is available in your iLMS account (Settings > API).
403 Forbidden  This status code appears when a request is made to a resource which is not available for the organization. In other words, that feature is not available to the organization.
404 Not Found Invalid URI. The resource you're looking for is not available or doesn't exist.
415 Unsupported Media Type iLMS API only supports "Application/JSON" media type. For any other media type, the unsupported media type error will be returned.

5xx - Error on Server Side

Status Code Description
500 Internal Server Error It appears when an unhandled error occurred. We're automatically informed about such type of errors and we fix such errors as early as possible.
503 Service Unavailable System might be temporary down due to up-gradation. Or your request can't be accepted at that point of time.

Region, Time, and Language Codes

Time Zone

Here is the list of all the available time zones

Full Name Short Name Offset
(GMT-05.00) Eastern Time (US & Canada) EST -5.00
(GMT-06.00) Central Time (US & Canada) CST -6.00
(GMT-07.00) Mountain Time (US & Canada) MST -7.00
(GMT-08.00) Pacific Time (US & Canada) PST -8.00
(GMT-12.00) International Date Line West IDLW -12.00
(GMT-11.00) Midway Island, Samoa SST -11.00
(GMT-10.00) Hawaii HST -10.00
(GMT-09.00) Alaska AKST -9.00
(GMT-08.00) Tijuana, Baja California) PST -8.00
(GMT-07.00) Chihuahua, La Paz, Mazatlan - Old MST -7.00
(GMT-07.00) Chihuahua, La Paz, Mazatlan - New MST -7.00
(GMT-07.00) Arizona MST -7.00
(GMT-06.00) Saskatchewan CST -6.00
(GMT-06.00) Guadalajara, Mexico City, Monterrey - Old CST -6.00
(GMT-06.00) Guadalajara, Mexico City, Monterrey - New CST -6.00
(GMT-06.00) Central America CST -6.00
(GMT-05.00) Indiana (East) EST -5.00
(GMT-05.00) Bogota, Lima, Quito, Rio Branco COT -5.00
(GMT-04.30) Caracas VET -4.30
(GMT-04.00) Santiago CLT -4.00
(GMT-04.00) Manaus AMT -4.00
(GMT-04.00) La Paz BOT -4.00
(GMT-04.00) Atlantic Time (Canada) AST -4.00
(GMT-03.30) Newfoundland NST -3.30
(GMT-03.00) Montevideo UYT -3.00
(GMT-03.00) Greenland WGT -3.00
(GMT-03.00) Georgetown ART -3.00
(GMT-03.00) Buenos Aires ART -3.00
(GMT-03.00) Brasilia BRT -3.00
(GMT-02.00) Mid-Atlantic GMT-02.00 -2.00
(GMT-01.00) Cape Verde Is. CVT -1.00
(GMT-01.00) Azores AZOT -1.00
(GMT00.00) Casablanca GMT  0.00
(GMT00.00) Greenwich Mean Time : Dublin, Edinburgh, Lisbon, London GMT  0.00
(GMT00.00) Monrovia, Reykjavik GMT  0.00
(GMT+01.00) Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna WET  1.00
(GMT+01.00) Belgrade, Bratislava, Budapest, Ljubljana, Prague CET  1.00
(GMT+01.00) Brussels, Copenhagen, Madrid, Paris CET  1.00
(GMT+01.00) Sarajevo, Skopje, Warsaw, Zagreb CET  1.00
(GMT+01.00) West Central Africa WAT  1.00
(GMT+02.00) Amman EET  2.00
(GMT+02.00) Athens, Bucharest, Istanbul EET  2.00
(GMT+02.00) Beirut EET  2.00
(GMT+02.00) Cairo EET  2.00
(GMT+02.00) Harare, Pretoria SAST  2.00
(GMT+02.00) Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius EET  2.00
(GMT+02.00) Jerusalem IST  2.00
(GMT+02.00) Minsk EET  2.00
(GMT+02.00) Windhoek WAT  2.00
(GMT+03.00) Baghdad AST  3.00
(GMT+03.00) Kuwait, Riyadh AST  3.00
(GMT+03.00) Moscow, St. Petersburg, Volgograd MSK  3.00
(GMT+03.00) Nairobi EAT  3.00
(GMT+03.00) Tbilisi GET  3.00
(GMT+03.00) Tehran IRST  3.00
(GMT+04.00) Abu Dhabi, Muscat GST  4.00
(GMT+04.00) Baku AZT  4.00
(GMT+04.00) Caucasus Standard Time GMT+04.00  4.00
(GMT+04.00) Port Louis MUT  4.00
(GMT+04.00) Yerevan AMT  4.00
(GMT+04.00) Kabul AFT  4.00
(GMT+05.00) Ekaterinburg SVX  5.00
(GMT+05.00) Islamabad, Karachi PKT  5.00
(GMT+05.00) Tashkent UZT  5.00
(GMT+05.30) Chennai, Kolkata, Mumbai, New Delhi IST  5.30
(GMT+05.30) Sri Jayawardenepura IST  5.30
(GMT+05.45) Kathmandu NPT  5.45
(GMT+06.00) Almaty, Novosibirsk NOVT  6.00
(GMT+06.00) Astana, Dhaka BST  6.00
(GMT+06.30) Yangon (Rangoon) MMT  6.30
(GMT+07.00) Bangkok, Hanoi, Jakarta WIB  7.00
(GMT+07.00) Krasnoyarsk KRAT  7.00
(GMT+08.00) Beijing, Chongqing, Hong Kong, Urumqi CST  8.00
(GMT+08.00) Irkutsk, Ulaan Bataar IRKT  8.00
(GMT+08.00) Kuala Lumpur, Singapore SGT  8.00
(GMT+08.00) Perth WST  8.00
(GMT+08.00) Taipei CST  8.00
(GMT+09.00) Osaka, Sapporo, Tokyo JST  9.00
(GMT+09.00) Seoul KST  9.00
(GMT+09.00) Yakutsk YAKT  9.00
(GMT+09.30) Adelaide CST  9.30
(GMT+09.30) Darwin CST  9.30
(GMT+10.00) Brisbane EST 10.00
(GMT+10.00) Canberra, Melbourne, Sydney EST 10.00
(GMT+10.00) Guam, Port Moresby PGT 10.00
(GMT+10.00) Hobart EST 10.00
(GMT+10.00) Vladivostok VLAT 10.00
(GMT+11.00) Magadan, Solomon Is., New Caledonia MAGT 11.00
(GMT+12.00) Auckland, Wellington NZST 12.00
(GMT+12.00) Fiji, Kamchatka, Marshall Is. FJT 12.00
(GMT+13.00) Nuku alofa TOT 13.00

Country

Here is the list of all the countries

Name Code
Afghanistan AF
Albania AL
Algeria DZ
American Samoa AS
Andorra AD
Angola AO
Anguilla AI
Antarctica AQ
Antigua and Barbuda AG
Argentina AR
Armenia AM
Aruba AW
Australia AU
Austria AT
Azerbaijan AZ
Bahamas BS
Bahrain BH
Bangladesh BD
Barbados BB
Belarus BY
Belgium BE
Belize BZ
Benin BJ
Bermuda BM
Bhutan BT
Bolivia BO
Bosnia and Herzegovina BA
Botswana BW
Brazil BR
British Indian Ocean Territory IO
British Virgin Islands VG
Brunei BN
Bulgaria BG
Burkina Faso BF
Burma (Myanmar) MM
Burundi BI
Cambodia KH
Cameroon CM
Canada CA
Cape Verde CV
Cayman Islands KY
Central African Republic CF
Chad TD
Chile CL
China CN
Christmas Island CX
Cocos (Keeling) Islands CC
Colombia CO
Comoros KM
Cook Islands CK
Costa Rica CR
Croatia HR
Cuba CU
Cyprus CY
Czech Republic CZ
Democratic Republic of the Congo CD
Denmark DK
Djibouti DJ
Dominica DM
Dominican Republic DO
Ecuador EC
Egypt EG
El Salvador SV
Equatorial Guinea GQ
Eritrea ER
Estonia EE
Ethiopia EI
Falkland Islands FK
Faroe Islands FO
Fiji FJ
Finland FI
France FR
French Polynesia PF
Gabon GA
Gambia GM
Georgia GE
Germany DE
Ghana GH
Gibraltar GI
Greece GR
Greenland GL
Grenada GD
Guam GU
Guatemala GT
Guinea GN
Guinea-Bissau GW
Guyana GY
Haiti HT
Holy See (Vatican City) VA
Honduras HN
Hong Kong HK
Hungary HU
Iceland IS
India IN
Indonesia ID
Iran IR
Iraq IQ
Ireland IE
Isle of Man IM
Israel IL
Italy IT
Ivory Coast CI
Jamaica JM
Japan JP
Jersey JE
Jordan JO
Kazakhstan KZ
Kenya KE
Kiribati KI
Kuwait KW
Kyrgyzstan KG
Laos LA
Latvia LV
Lebanon LB
Lesotho LS
Liberia LR
Libya LY
Liechtenstein LI
Lithuania LT
Luxembourg LU
Macau MO
Macedonia MK
Madagascar MG
Malawi MW
Malaysia MY
Maldives MV
Mali ML
Malta MT
Marshall Islands MH
Mauritania MR
Mauritius MU
Mayotte YT
Mexico MX
Micronesia FM
Moldova MD
Monaco MC
Mongolia MN
Montenegro ME
Montserrat MS
Morocco MA
Mozambique MZ
Namibia NA
Nauru NR
Nepal NP
Netherlands NL
Netherlands Antilles AN
New Caledonia NC
New Zealand NZ
Nicaragua NI
Niger NE
Nigeria NG
Niue NU
Norfolk Island NFK
North Korea KP
Northern Mariana Islands MP
Norway NO
Oman OM
Pakistan PK
Palau PW
Panama PA
Papua New Guinea PG
Paraguay PY
Peru PE
Philippines PH
Pitcairn Islands PN
Poland PL
Portugal PT
Puerto Rico PR
Qatar QA
Republic of the Congo CG
Romania RO
Russia RU
Rwanda RW
Saint Barthelemy BL
Saint Helena SH
Saint Kitts and Nevis KN
Saint Lucia LC
Saint Martin MF
Saint Pierre and Miquelon PM
Saint Vincent and the Grenadines VC
Samoa WS
San Marino SM
Sao Tome and Principe ST
Saudi Arabia SA
Senegal SN
Serbia RS
Seychelles SC
Sierra Leone SL
Singapore SG
Slovakia SK
Slovenia SI
Solomon Islands SB
Somalia SO
South Africa ZA
South Korea KR
Spain ES
Sri Lanka LK
Sudan SD
Suriname SR
Svalbard SJ
Swaziland SZ
Sweden SE
Switzerland CH
Syria SY
Taiwan TW
Tajikistan TJ
Tanzania TZ
Thailand TH
Timor-Leste TL
Togo TG
Tokelau TK
Tonga TO
Trinidad and Tobago TT
Tunisia TN
Turkey TR
Turkmenistan TM
Turks and Caicos Islands TC
Tuvalu TV
Uganda UG
Ukraine UA
United Arab Emirates AE
United Kingdom GB
United States US
Uruguay UY
US Virgin Islands VI
Uzbekistan UZ
Vanuatu VU
Venezuela VE
Vietnam VN
Wallis and Futuna WF
Western Sahara EH
Yemen YE
Zambia ZM
Zimbabwe ZW

US - States

Here is the list of all the sates for USA

Name Code
Alabama AL
Alaska AK
American Samoa AS
Arizona AZ
Arkansas AR
California CA
Colorado CO
Connecticut CT
Delaware DE
District Of Columbia DC
Federated States Of Micronesia FM
Florida FL
Georgia GA
Guam GU
Hawaii HI
Idaho ID
Illinois IL
Indiana IN
Iowa IA
Kansas KS
Kentucky KY
Louisiana LA
Maine ME
Marshall Islands MH
Maryland MD
Massachusetts MA
Michigan MI
Minnesota MN
Mississippi MS
Missouri MO
Montana MT
Nebraska NE
Nevada NV
New Hampshire NH
New Jersey NJ
New Mexico NM
New York NY
North Carolina NC
North Dakota ND
Northern Mariana Islands MP
Ohio OH
Oklahoma OK
Oregon OR
Palau PW
Pennsylvania PA
Puerto Rico PR
Rhode Island RI
South Carolina SC
South Dakota SD
Tennessee TN
Texas TX
Utah UT
Vermont VT
Virgin Islands VI
Virginia VA
Washington WA
West Virginia WV
Wisconsin WI
Wyoming WY

Canada - States (Provinces)

Here is the list of all the province codes for Canada. These codes will work in the "State" Field of the user profile. 

Name Code
Alberta AB
British Columbia BC
Manitoba MB
New Brunswick NB
New Foundland NF
Northwest Territories NT
Nova Scotia NS
Nunavut NU
Ontario ON
Prince Edward Island PE
Quebec PQ
Saskatchewan SK
Yukon YT

Languages

Here is the list of all the languages available in iLMS. To know what languages are available for your organization, please go to "Settings > Languages" option in your organization account in iLMS.

Name Code Character Set
 Brazilian Portuguese PT iso-8859-1
 Chinese ZH EUC-CN
 Czech CS iso-8859-2
 Dutch LN iso-8859-1
 English en utf-8
 English (UK) en utf-8
 French fr iso-8859-1
 French Canadian fr-CA iso-8859-1
 German ge iso-8859-1
 Greek gr iso-8859-7
 Italian IT iso-8859-1
 Japanese JA x-euc
 Korean KO euc-kr
 Latin American Spanish es-US iso-8859-1
 Malay MS iso-8859-1
 Portuguese PT iso-8859-1 
 Russian RU iso-8859-5
 Slovakian SK iso-8859-2
 Spanish sp iso-8859-1
 Thai TH windows-874
 Traditional Chinese TH-TW Big5
 Turkish TR iso-8859-9

Pagination

Pagination is supported in few APIs which may return multiple items. By default pagination is set for 100 items. You can use following parameters to take advantage of pagination:

  • per_page: how many items you want in the page? It is basically the size of the page. If you skip this parameter, 100 items will be returned by default.
  • page: specify which page number's result you're looking for. If you skip this parameter, results will always start from page 1.

You should always check headers especially Link Headers, for the information to retrieve additional pages/items.

  • X-TOTAL-COUNT: It tells how many items are available for the given resource.
  • Link Header: It returns a set of ready-made links for navigation.Based on the current page location, you may see these following link headers-

first: Shows the URL of the first page of the results. It doesn't come when current page is the first page itself.
prev: Shows the URL of immediate previous page of the results. It doesn't come when current page is the first page itself.
next: Shows the URL of immediate next page of the results. It doesn't come when current page is the last page itself.
last: Shows the URL of the last page of the results. It doesn't come when current page is the last page itself.

Example: If your organization have 2000 users, and you are at page 5 with page size as 50, you will see header like this-

X-TOTAL-COUNT: 2000

first: https://api.inspiredlms.com/organizations/99999/users?per_page=50&page=1
prev: https://api.inspiredlms.com/organizations/99999/users?per_page=50&page=4
next: https://api.inspiredlms.com/organizations/99999/users?per_page=50&page=6
last: https://api.inspiredlms.com/organizations/99999/users?per_page=50&page=40


Sorting

You can use "sort" in query string to specify sorting order.

For example-

  • To sort results on name in ascending order, you can use it like: sort=name
  • If you want results in descending order, then use dash. i.e. sort=-name