---
title: "Return a list of employee personals."
method: GET
path: "/employees/personals"
tags: ["Employees"]
---

# Return a list of employee personals.

`GET /employees/personals`

This endpoint returns a list with the **personal** sections of the existing employees. Additionally, custom fields from this section will also be included.

## Query parameters

- `firstName` string
- `lastName` string
- `displayName` string
- `gender` 'Male' | 'Female' | 'Other'
- `birthdate` string
- `nationality` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- object
  - `data` object[]
    - `_id` string — The _id of the Kenjo employee.
    - `firstName` string — The name of the Kenjo employee. This field is required.
    - `lastName` string — The surname of the Kenjo employee. This field is required.
    - `displayName` string — The composition of firstName and lastName of the Kenjo employee.
    - `gender` string — The employee gender. Only is valid one of the following values 'Male' (male), 'Female' (female) or 'Other' (other).
    - `birthdate` string — The employee birth date. Format YYYY-MM-DDThh:00:00.000Z.
    - `nationality` string — The employee nationality. The nationality must be the first letter in uppercase. Example "Spanish", "Brazilian"
    - `delegatedApproverId` string — The id of the employee who will act as the delegated approver for this employee.

## Other responses

- `400` — BAD REQUEST. This is a wrong request in the client side due to invalid body or params.
- `401` — UNAUTHORIZED. The Authorization header is incorrect, not provided or the token expired.

---

[API](https://skmtc.net/kenjo/apis/kenjo-api.md) · [All operations](https://skmtc.net/kenjo/apis/kenjo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kenjo/kenjo-api/revisions/58772b78268e/schema)