
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 |
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article


