Get all competence statuses for a user
Resource URL
URL: user/competenceStatus
Parameters
string username | Username |
string password | Password |
int userId | Unique identifier of the user |
string userExternalId | Unique external identifier of the user. Either userId or userExternalId must be filled. |
string competenceType | Limit the result to competences of this type. Possible values:
Default value: no filter |
boolean showActiveRequirementsOnly optional | If true, the method will only return the statuses for the user's active requirements.Default value: false |
string language optional | Language, available values are: no, en, pr Default value: no |
Return value
The method returns a list of statuses for the users competence requirements and other competence completions. Each item in the list has the following properties:
completionDate | yyyy-MM-dd - the date when competence was completed. Empty value indicates, that the competence is not yet completed |
validUntilDate | yyyy-MM-dd - if a competence has validity period this indicates the time it expires |
status | Status of the competence.
|
requirementReferenceId | Identifier of the requirement (if requirement exists) |
competenceId | Id of the competence |
competenceExternalId | Exsternal Id of the competence. Null if no external Id is defined |
competenceName | Name of the competence |
Example request
URL | https://www.trainingportal.no/mintra/rest/user/competenceStatus |
POST DATA | userId=123456&language=en&username=username&password=secret |
{"competences":
[
{
"status":"COMPLETED",
"requirementReferenceId":"41654228-9bd3-435f-9682-feee",
"competenceId":23518,
"competenceExternalId":null,
"competenceName":"Heart starter",
"completionDate":"2015-04-02",
"validUntilDate":null
},
{
"status":"COMPLETED",
"requirementReferenceId":"eea234-3e58-4dd2-a634-0c54fd5c7dd2",
"competenceId":136,
"competenceExternalId":null,
"competenceName":"Theory & Exam: Portable Radio",
"completionDate":"2014-10-12",
"validUntilDate":"2016-10-12"
}
]
}