Get employees by product
This endpoint retrieves information about all employees who have an active service association within a product.
GET /api/v2/businesses/{businessId}/products/{productId}/employeesIf the data included in the request is correct —both businessId and productId— the response will contain the list of employees in the product with all the defined information for them.
Response example
[
{
"name": "Theodore",
"surname": "Hayes",
"email": "theohayes@bsn.com",
"birthday": "1989-09-10",
"employeeId": "209_14",
"virtual": false
},
{
"name": "Melanie",
"surname": "Jenkins",
"employeeId": "555",
"virtual": false
},
{
"name": "Andrea",
"surname": "Meyer",
"employeeId": "444",
"metadata": {},
"virtual": false
},
{
"name": "Mariane",
"surname": "Ortega Acevedo",
"birthday": "2004-01-02",
"employeeId": "1006350",
"virtual": false
}
][
{
"name": "ARIANA",
"surname": "VISMARA",
"group": "Responsible",
"employeeId": "1493432",
"metadata": {
"language": "english"
},
"virtual": false
},
{
"name": "CLARA",
"surname": "SANDERS",
"group": "Merchandising",
"employeeId": "5690921",
"metadata": {
"or": "WOMAN"
},
"virtual": false
},
{
"name": "MAYA",
"surname": "SANTORO",
"group": "General",
"employeeId": "9454863",
"virtual": false
}
]Details
-
name: employee’s first name.
-
surname: employee’s last name(s).
-
group: group the employee belongs to.
-
email: employee’s email address.
-
birthday: date of birth in
yyyy-MM-ddformat. -
employeeId: employee identifier in the external system.
-
metadata: additional data about the employee. The structure of this field must be previously configured at the business level by the Orquest team.
-
seniority: employee’s seniority date in
yyyy-MM-ddformat. -
virtual: determines whether this is a real employee or a virtual one used, for example, to run simulations.
As shown in the example, the request will return the information defined in the system, so there may be non-mandatory fields that do not appear in the response.
Metadata will only appear in businesses that have previously configured this information.
Considerations
If the product indicated in the URL does not exist in the business, the request will return a 404 Not Found error, specifying not exits in the message.
If there are no employees in the indicated product, or the employees do not have active service associations, the request will return an empty array [].
Even if metadata is defined at the business level, only those metadata with an assigned value will be included in the response. In other words, if a metadata field does not have a defined value for an employee, that field will not appear in the response for that employee.