Early Access (EA)This API is currently in Early Access and available only to approved EA participants. Do not rely on this version for production workloads unless explicitly authorized. If you have any feedback, please share with your designated Early Adoption program representative.
Summary Description
The List Employee Skills endpoint returns a paginated list of the skills assigned to one employee, including each skill's issued date, expiration date, and current expiration status.
Use Cases
- Show an employee's skills and certifications in your application.
- Check whether an employee holds a required skill and whether it is Active, Up for Renewal, or Expired.
- Get the employeeSkillKey for an assignment before updating, renewing, or deleting it.
Company Set Behavior
Employee skills are stored per person (personId), not per Employee ID. Calling this endpoint for one Employee ID returns all skills for that person, including skills that were added through the person's other Employee IDs in other Company IDs within the company set. The companyId and employeeId on each returned record are the values from the request.
Filtering and Sorting
Filtering and sorting are not supported on this endpoint.
401Unauthorized. The bearer token is missing, invalid, or expired. Request a new access token and try again.
403Forbidden. The token is valid, but the API client is not authorized to access this API or this company.
404Not Found. The Employee ID was not found in the company.
429Too Many Requests. The API client exceeded the rate limit of 3 requests per second. Wait briefly, then retry using a backoff strategy.
504Gateway Timeout. The request did not complete within the 30-second gateway timeout. Retry the request; for list endpoints, try a smaller limit.