Getting a List of Courses (Page-by-Page)
AVAILABLE WITH BUSINESS SUBSCRIPTION
Request: GET /contents
You will retrieve a list of course that were originally uploaded to the account. Content copied from other courses won't appear in the response.
Learn how to get a list of all course modules in the Getting a List of Course Modules article.
Permissions to Run the Request
Account Owner, Account Administrators, Department Administrators, as well as Course Authors and users with a custom role with access to the project containing this course.
For users with a custom role, allow "View and enroll users into training programs."
Request Headers
Header | Description |
---|---|
Authorization (required) | Access token. You can obtain a token by making a request. |
Parameter | Description |
pageSize (optional) | The number of entries per page. If not indicated, equal to 1000 |
pageToken (optional) | The token to continue to the next page |
Response Headers and Parameters
Header | Description |
---|---|
contentItems | An array that contains a list of courses, learning tracks, or standalone content |
contentItem | An array that contains data about the course, learning tracks, or standalone content |
contentItemId | ID of the course, learning track, or standalone content |
title | Title of the course, learning track, or standalone content |
subtitle | Subtitle of the course learning track, or standalone content |
description | Description of the course, learning track, or standalone content |
userId | User ID to whom the course, learning path or standalone content is assigned |
addedDate | Date of adding the course, learning track, or standalone content |
viewUrl | Link to view the course, learning track, or standalone content |
type | Type of content |
nextPageToken | The token to continue to the next page with content |
Response Codes
Code | Text | Description |
---|---|---|
200 | OK | The request has been successfully processed |
400 | Bad Request | A request error |
401 | Unauthorized | An authorization error |
403 | Permission Denied | The user doesn't have enough permissions to complete the request |
Return Values
After the request is successfully processed, the system returns an object with the following properties:
Parameter | Type | Description |
---|---|---|
nextPageToken | string | The token needed to continue to the next page. |
Sample Request
GET/contents?pageSize=1000&pageToken=Mg https/1.1
Host: api-learn.ispringlearn.com
Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE
Sample Response
https/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<response>
<contentItems>
<contentItem>
<contentItemId>c74a3bc3-f593-11e9-a66a-0a580af40186</contentItemId>
<title>Sales Strategy</description>
<subtitle>A course to improve your sales skills</subtitle>
<description>Things to remember when meeting a client.</description>
<userId>b6981094-f593-11e9-a66a-0a580af40186</userId>
<addedDate>2016-10-24T11:18:23+00:00</addedDate>
<viewUrl>https://myaccount.ispringlearn.com/view/22751-AE13s-h3T3K-ViCzL</viewUrl>
<type>Course</type>
</contentItem>
<contentItem>
...
</contentItem>
</contentItems>
<nextPageToken>string</nextPageToken>
</response>