List of Employee Skills expiring soon:
[GET] /employee-skills?sort=-id&expiresOn:after=2023-02-08&include=employee
Where expiresOn:after= is followed by a value for your business definition of “soon”. Take the current date, and subtract the days of warning programmatically and include it in the call.
Including the employee data will give you the unique identifiers (to match with a third party system) and phone/email address to contact them and remind them.
Sample result record:
{
"skillDateLabel": "Expiry date",
"expiryDate": "2024-11-18T05:00:00+00:00",
"expiresOn": "2024-11-18T05:00:00+00:00",
"skillDateLabelValue": "2024-11-18T05:00:00+00:00",
"skillLabel1": "Firearm Permit number",
"skillLabel1Value": "123456",
"skillLabel2": "",
"skillLabel2Value": "",
"skillCustomFields": {
"dateLabel": {
"type": "DateTime",
"label": "Expiry date",
"value": "2024-11-18 05:00:00"
},
"label1": {
"type": "string",
"label": "Firearm Permit number",
"value": "123456"
}
},
"status": "ACTIVE",
"comments": "",
"skill": 1,
"id": 346,
"employee": {
"jobTitle": "Security Guard",
"region": 6,
"employmentProfile": 216,
"address": 1124,
"id": 1269,
"customId": "0060",
"firstName": "Emad",
"lastName": "El",
"name": "Emad El",
"primaryPhone": "",
"secondaryPhone": "",
"email": "",
"status": "ACTIVE",
"avatar": "https://innovation.staffr.net/rest/v1/avatar/employees/1269/e8a849b23c584c77a3b0aa70fc7db392"
}
}