Get aptitudes by employee

This endpoint returns all aptitudes for an employee.

GET /api/v1/businesses/{businessId}/people/{employeeId}/aptitudes

If the provided data —both businessId and employeeId— is correct, the response will contain the aptitudes for the employee across all products where they have any defined aptitude. The following information will be detailed:

  • productId: external identifier of the product or section where the employee has defined aptitudes.

  • aptitudes: list of aptitudes.

    • locationId: external identifier of the task to which the aptitude refers.

    • level: level of competency for the task, ranging from 0 (not competent) to 3 (expert).

Here is an example of a response:

[
    {
        "productId": "008",
        "aptitudes": [
            {
                "locationId": "06",
                "level": 3
            }
        ]
    },
    {
        "productId": "0001-G",
        "aptitudes": [
            {
                "locationId": "02",
                "level": 3
            },
            {
                "locationId": "01",
                "level": 2
            }
        ]
    }
]

As shown in the example, if an employee has aptitudes in several products, all of them will appear in the list.

Considerations

If the employee ID does not exist in the business, the request will return a 404 Not Found error, specifying Person not found in the message.

If no aptitudes are defined for the employee, the request will return an empty array [].

What is an aptitude?

What is a task?