
LEARNING PROGRAMS
A "learning program" brings together several courses into a structured pathway in which users register by cohort. It is represented by a tile in the catalogue and can issue a certificate when it is completed. A learning program in the API is named "program". | ![]() |
Learning programs: program/get
https://www.domaine.com/lmsapi/program/get
![]() | Returns an object representing a learning program in your environment. |
Request
Example of request call content for information on a learning program:
{
"id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d"
}Field descriptions
| Name | Required | Comments/description |
| id | X | Unique identifier of the learning program. (String type) |
Response
Example of response call content for information on a learning program:
{
"id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
"creationDate": "2018-11-20T09:30:19.417",
"name": "Programme de Test",
"minParticipants": 4,
"maxParticipants": 0,
"description": "",
"coverId": "",
"subscriptionType": 0,
"enrolmentType": 0,
"authorizationType": 0,
"needAdminApproval": true,
"visibilityType": 0,
"startDate": "0001-01-01T00:00:00",
"endDate": "0001-01-01T00:00:00",
"showAvailableSubscriptions": true,
"providerId": "eYlMGw7Dsq7EEUb%2f7tbtNg%3d%3d",
"certificateId": "",
"categoryId": "eWAFhEFBmzdeDcziVz93Ag%3d%3d",
"credits": 0.00,
"keywords": "",
"createdByUserID": "4zwet3FOX5xXfHX7YFuR8w%3d%3d",
"shortDescription": "",
"status": 0,
"language": 1,
"externalLink": "",
"taxEnabled": true,
"isSinglePayment": true,
"expirationType": 0,
"daysToComplete": 0,
"dateToComplete": "0001-01-01T00:00:00",
"catalogLink": "UrlToPublicCatalog",
"lastModificationDate": "0001-01-01T00:00:00",
"taxCountryId": 123,
"taxStateId": 321,
"customFields": {
"Champ1": "Snow",
"Test": ""
}
}Field descriptions
Name | Comments/description |
id | This is the unique database identifier. (String type) |
creationDate | Creation date of the learning program. (get only) String type (YYYY-MM-DDTHH:MM:SSZ) |
name | Name of the learning program as displayed in the portal. (String type, between 5 and 250 characters)
|
minParticipants | Minimum number of registered users required for the learning program to take place. (Number type) A value of 0 means no minimum |
maxParticipants | Maximum number of users who can register (if the waiting list is not enabled) (Number type) A value of 0 means no maximum |
description | Description of the learning program; this will be displayed in the catalogue and in the learning program. (String type) |
coverId | The identifier of the cover image of your learning program. Your item can be associated with only one cover image. (String type) |
subscriptionType | Determines whether the learning program accepts registrations:
|
enrolmentType | Accepted registration types:
|
authorizationType | Accepted authorization types:
|
| needAdminApproval | Boolean - By default this value is "false". This value determines whether the course requires an approver to be set at the time of registration |
visibilityType | Visibility type in the catalogues
(Number type) |
startDate
| This value is required if the specific SubscriptionType (2) is selected. It determines the start of the range during which registrations are accepted. (Date type YYYY-MM-DDTHH:MM:SSZ) |
endDate | This value is required if the specific SubscriptionType (2) is selected. It determines the end of the range during which registrations are accepted. (Date type YYYY-MM-DDTHH:MM:SSZ) |
showAvailableSubscriptions | By default this value is "false". Displays the number of available and total seats in the catalogue when users register. (Boolean type) |
providerId | The identifier of the service provider with which your learning program is associated. Your item can be associated with only one service provider. (String type) |
certificateId
| Identifier of the certificate associated with the learning program. It is awarded automatically based on the completion criteria of the learning program. (String type) |
categoryId | The identifier of the category with which your learning program is associated. Your item can be associated with only one category. (String type) |
credits | Number of credits associated with the successful completion of this learning program. (Number type) |
keywords | Search keywords for the learning program. Maximum 250 characters. |
createdByUserID | The identifier of the user who created the learning program. (String type). |
shortDescription | Short description of the learning program; this will be displayed in the catalogue. (String type) |
status | Status of the learning program.
(Number type) |
language | Language of the learning program.
(Number type) |
externalLink | Redirect URL applied to the "register" link to redirect the user to an external site for registration. Maximum 250 characters. |
taxEnabled | Indicates whether taxes are enabled on the learning program. (Boolean type) |
taxCountryId | Number indicating the country of the learning program
Number type (See Appendix 3: Countries and States/Provinces) |
taxStateId | Number indicating the state of the learning program
Number type (See Appendix 3: Countries and States/Provinces) |
isSinglePayment | Indicates whether payment is made at the learning program level. (Boolean type) |
expirationType | Expiration type for the registrations of the cohorts of the learning program.
(Number type) |
daysToComplete | Number of days after registration before it expires. (Number type) |
dateToComplete | Deadline for the expiration of all the registrations of the learning program. (Number type) |
catalogLink | URL to the public catalogue page for this learning program. The URL provided points to the default portal.
(Get only) |
lastModificationDate | Date of the last modification of the learning program Cannot be modified. Available in get and getlist. |
| customFields | Custom fields linked to the program. |
Learning programs: program/getlist
https://www.domaine.com/lmsapi/program/getlist
![]() | Returns the list of all the learning programs in your environment. |
Request
Example of request call content for the list of learning programs:
{
"filterDate": "YYYY-MM-DDTHH:MM:SSZ",
"filterEditDate": "YYYY-MM-DDTHH:MM:SSZ"
}Field descriptions
| Name | Required | Comments/description |
| filterDate | Optional parameter corresponding to the creation date of the element. The method returns the list of objects that were created after the date passed as a filter. Type: String (YYYY-MM-DDTHH:MM:SSZ) | |
| filterEditDate | Optional parameter corresponding to the last modification date of the element. The method returns the list of objects that were modified after the date passed as a filter. A modification made to a learning program may correspond to:
|
Response
Example of response call content for the list of learning programs:
[
{
"id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
"creationDate": "2018-11-20T09:30:19.417",
"name": "Programme de Test",
"minParticipants": 4,
"maxParticipants": 0,
"description": "",
"coverId": "",
"subscriptionType": 0,
"enrolmentType": 0,
"authorizationType": 0,
"needAdminApproval": true,
"visibilityType": 0,
"startDate": "0001-01-01T00:00:00",
"endDate": "0001-01-01T00:00:00",
"showAvailableSubscriptions": true,
"providerId": "eYlMGw7Dsq7EEUb%2f7tbtNg%3d%3d",
"certificateId": "",
"categoryId": "eWAFhEFBmzdeDcziVz93Ag%3d%3d",
"credits": 0.00,
"keywords": "",
"createdByUserID": "4zwet3FOX5xXfHX7YFuR8w%3d%3d",
"shortDescription": "",
"status": 0,
"language": 1,
"externalLink": "",
"isSinglePayment": true,
"expirationType": 0,
"daysToComplete": 0,
"dateToComplete": "0001-01-01T00:00:00",
"catalogLink": "UrlToPublicCatalog",
"lastModificationDate": "0001-01-01T00:00:00",
"taxEnabled": true,
"taxCountryId": 123,
"taxStateId": 321,
"customFields": {
"Champ1": "Snow",
"Test": ""
}
}
]Field descriptions
Name | Comments/description |
id | This is the unique database identifier. (String type) |
creationDate | Creation date of the learning program. (get only) String type (YYYY-MM-DDTHH:MM:SSZ) |
name | Name of the learning program as displayed in the portal. (String type, between 5 and 250 characters)
|
minParticipants | Minimum number of registered users required for the learning program to take place. (Number type) A value of 0 means no minimum |
maxParticipants | Maximum number of users who can register (if the waiting list is not enabled) (Number type) A value of 0 means no maximum |
description | Description of the learning program; this will be displayed in the catalogue and in the learning program. (String type) |
coverId | The identifier of the cover image of your learning program. Your item can be associated with only one cover image. (String type) |
subscriptionType | Determines whether the learning program accepts registrations:
|
enrolmentType | Accepted registration types:
|
authorizationType | Accepted authorization types:
|
| needAdminApproval | Boolean - By default this value is "false". This value determines whether the course requires an approver to be set at the time of registration |
visibilityType | Visibility type in the catalogues
(Number type) |
startDate
| This value is required if the specific SubscriptionType (2) is selected. It determines the start of the range during which registrations are accepted. (Date type YYYY-MM-DDTHH:MM:SSZ) |
endDate | This value is required if the specific SubscriptionType (2) is selected. It determines the end of the range during which registrations are accepted. (Date type YYYY-MM-DDTHH:MM:SSZ) |
showAvailableSubscriptions | By default this value is "false". Displays the number of available and total seats in the catalogue when users register. (Boolean type) |
providerId | The identifier of the service provider with which your learning program is associated. Your item can be associated with only one service provider. (String type) |
certificateId
| Identifier of the certificate associated with the learning program. It is awarded automatically based on the completion criteria of the learning program. (String type) |
categoryId | The identifier of the category with which your learning program is associated. Your item can be associated with only one category. (String type) |
credits | Number of credits associated with the successful completion of this learning program. (Number type) |
keywords | Search keywords for the learning program. Maximum 250 characters. |
createdByUserID | The identifier of the user who created the learning program. (String type). |
shortDescription | Short description of the learning program; this will be displayed in the catalogue. (String type) |
status | Status of the learning program.
(Number type) |
language | Language of the learning program.
(Number type) |
externalLink | Redirect URL applied to the "register" link to redirect the user to an external site for registration. Maximum 250 characters. |
taxEnabled | Indicates whether taxes are enabled on the learning program. (Boolean type) |
taxCountryId | Number indicating the country of the learning program
Number type (See Appendix 3: Countries and States/Provinces) |
taxStateId | Number indicating the state of the learning program
Number type (See Appendix 3: Countries and States/Provinces) |
isSinglePayment | Indicates whether payment is made at the learning program level. (Boolean type) |
expirationType | Expiration type for the registrations of the cohorts of the learning program.
(Number type) |
daysToComplete | Number of days after registration before it expires. (Number type) |
dateToComplete | Deadline for the expiration of all the registrations of the learning program. (Number type) |
catalogLink | URL to the public catalogue page for this learning program. The URL provided points to the default portal.
(Get only) |
lastModificationDate | Date of the last modification of the learning program Cannot be modified. Available in get and getlist. |
| customFields | Custom fields linked to the program. |
Learning programs: program/geturl
https://www.domaine.com/lmsapi/program/geturl
![]() | Returns the list of public catalogue URLs for this learning program. |
Request
Example of request call content for the list of public catalogue URLs for a learning program:
{
"id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
"filterId" : "aoflemrnQ2A8DFaNy22zA%3d%3d"
}Field descriptions
| Name | Required | Comments/description |
| id | X | Unique identifier of the learning program. (String type) |
| filterId | Portal identifier used to receive only the URL of this learning program for that specific portal. (String type) |
Response
Example of response call content for the list of public catalogue URLs for a learning program:
[
{
"portalId": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
"url": "UrlPourLePortail"
},
{
"portalId": "h89s6rd8hVQ2A8DFaNy22zA%3d%3d",
"url": "UrlPourLePortail"
}
]Field descriptions
| Name | Comments/description |
| portalId | Unique identifier of the portal for which the URL is returned. (String type) |
| url | URL to the public catalogue page of this learning program for the corresponding portal. (String type) |
Learning programs: program/getadminbranches
https://www.domaine.com/lmsapi/program/getadminbranches
![]() | Returns the list of administrative branches associated with a learning program. |
Request
Example of request call content for the list of administrative branches associated with a learning program:
{
"id": "68a9Y6p%2bhVsJJBRcIMOo0w%3d%3d"
}Field descriptions
| Name | Required | Comments/description |
| id | X | Unique identifier of the learning program. (String type) |
Response
Example of response call content for the list of administrative branches associated with a learning program:
[
"vrj0IrWe0HF%2bK9OKGpDF5A%3d%3d",
"6d7yavtJwLemtOAO2HF5BQ%3d%3d"
]Field descriptions
| Name | Comments/description |
| branches | List of the unique identifiers of the administrative branches associated with the learning program. (List of strings type) |
Learning programs: program/addadminbranches
https://www.domaine.com/lmsapi/program/addadminbranches
![]() | Adds administrative branches to a learning program. |
Request
Example of request call content to add administrative branches to a learning program:
{
"id": "68a9Y6p%2bhVsJJBRcIMOo0w%3d%3d",
"branches": [
"vrj0IrWe0HF%2bK9OKGpDF5A%3d%3d",
"6d7yavtJwLemtOAO2HF5BQ%3d%3d"
]
}Field descriptions
| Name | Required | Comments/description |
| id | X | Unique identifier of the learning program. (String type) |
| branches | X | List of the unique identifiers of the administrative branches. (List of strings type) |
Response
Example of response call content when adding administrative branches to a learning program:
{
"id": "68a9Y6p%2bhVsJJBRcIMOo0w%3d%3d"
}Field descriptions
| Name | Comments/description |
| id | Unique identifier of the learning program to which the branches were added. (String type) |
Learning programs: program/removeadminbranches
https://www.domaine.com/lmsapi/program/removeadminbranches
![]() | Removes administrative branches from a learning program. |
Request
Example of request call content to remove administrative branches from a learning program:
{
"id": "68a9Y6p%2bhVsJJBRcIMOo0w%3d%3d",
"branches": [
"vrj0IrWe0HF%2bK9OKGpDF5A%3d%3d",
"6d7yavtJwLemtOAO2HF5BQ%3d%3d"
]
}Field descriptions
| Name | Required | Comments/description |
| id | X | Unique identifier of the learning program. (String type) |
| branches | X | List of the unique identifiers of the administrative branches. (List of strings type) |
Response
Example of response call content when removing administrative branches from a learning program:
{
"id": "68a9Y6p%2bhVsJJBRcIMOo0w%3d%3d"
}Field descriptions
| Name | Comments/description |
| id | Unique identifier of the learning program from which the branches were removed. (String type) |
Learning program error code descriptions
Number | Message | Comments/description |
1400 | Required id | You must provide an identifier for the learning program. |
1401 | Invalid id | The identifier provided for the learning program is invalid. |
1402 | Invalid filterId | The identifier provided to perform the filter is invalid. |
| 1405 | Invalid name length | The name provided for the learning program must contain between 3 and 250 characters inclusively. |
1432 | Missing required branches | The "branches" parameter is required. |
1433 | Invalid branchId | A branch identifier is invalid. |
1434 | Cannot remove all branches | All administrative branches of a program cannot be removed. |
| 1435 | Cannot add branches | The administrative branches cannot be added to a program because some branches have already been added. |
| 1436 | Cannot remove branches | The administrative branches of a program cannot be removed because some branches are not associated. |
| 1437 | Invalid language | The value provided for the language is invalid. |
| 1438 | Invalid authorizationType | The value provided for the authorization type does not match the information provided |


