--- title: "Read company employee fields by employee ID." method: POST path: "/people/{identifier}" tags: ["People"] --- # Read company employee fields by employee ID. `POST /people/{identifier}` Single-employee read endpoint (not bulk search): returns field data for one employee identified by backend ID or email in the path in a single response. No pagination. For many employees in one call, use Search for employees. See Pagination and result scope. This endpoint uses POST (not GET) because the request body selects fields.

Before using this endpoint — see the People read API contract and People API (rate limits, permissions table, troubleshooting):

Field IDs (requests): use dot notation from Fields metadata (e.g. root.id). This is the canonical field ID — stable when a field moves categories; not a live category path. Use metadata categoryId for permissions.
Field keys (responses): slash notation (e.g. /root/id). The same employee may also include nested category objects (e.g. work.siteId alongside /work/siteId).
Silent omission: entries in fields[] without permission or with invalid IDs are omitted (200 OK, no warning).
Permissions: grant the service user View on each field's category (categoryId from metadata), not per field ID.
Default fields: if fields[] is omitted, returns fields from root, about, employment, and work (subject to permissions).
Custom fields: not included in default responses; request each metadata id in fields[] and grant category permission. See Custom employee fields (category fields).
Scope: employee fields only — not table rows (Employee Tables) or positions (Workforce Planning).

Testing notes:

Use the testing widget's Try It! option to test this endpoint.
Use Examples > Request Example to see body parameters.
Explore the response payload using the Example in the Response panel (human-readable and machine-format).

## Path parameters - `identifier` string, required ## Request body - ReadSingleEmployeeRequestReference - `fields` string[] — An optional list of field IDs to return. Use dot notation as returned by Fields metadata (e.g. root.id, work.department). This is the canonical field ID. When not specified, a default set of fields and categories are returned including:

Basic employee fields like: name, id, avatar URL, creation date, etc.

Basic categories:

About
Work

Fields without service-user permission or with unknown IDs are silently omitted (200 OK). Response keys use slash notation (e.g. /root/id). See People read API contract.
The complete fields schema is described in the 200 response status section. - `humanReadable` string — A flag that determines the data format to be returned in the response payload. Use this flag to convert "machine format" numeric IDs, such as "1644513820829" to the "human readable" values.

Flag values:

If not sent: will return only machine-format values. If you pass an invalid value it will be ignored and consdiered empty.

Possible values:

APPEND - include the additional "humanReadable" JSON node in the response.

REPLACE - supply only humanReadable values in the JSON response instead of machine-readable values.
## Response `200` Employee - Employees — Employee read response for Search for employees. Contains all matching employees for the request in one employees array (not split across pages). Machine-format field values use slash-notation keys (e.g. /root/id) with a value property. The same employee object may also include nested category objects (e.g. work.siteId). Request field IDs use dot notation from metadata (e.g. root.id). See People read API contract. - `employees` union[] — All employees matching the search request and service user scope for this call. - union - EmployeeResponseReadable - `fullName` string — The full name of the Employee (first name + surname). - `displayName` string — Employee's display name. This defaults to first name & last name but can be customized. - `creationDateTime` string — The full timestamp of creation of the Employee. - `work` WorkPartReadable - `shortStartDate` string, date — The employee's employment start date without the year - `startDate` string, date — The employee's employment start date without the year - `manager` string — The full name of the employee's manager. - `tenureDuration` string — The tenure duration of the employee. - `durationOfEmployment` string — The tenure duration of the employee. - `reportsToIdInCompany` string — The ID in company of the manager. - `employeeIdInCompany` string — The ID of the manager. - `reportsTo` string — The full name of the person the employee reports to. - `tenureDurationYears` string — The tenture duration in years. - `department` string — The department this employee belong to. - `siteID` string — The ID of the site the employee belongs to. - `tenureYears` string — The tenture in years. - `isManager` string — Is the employee a manager (Yes/No). - `title` string — The employee's title. - `site` string — The employee's site. - `originalStartDate` string — The original date the employee started to work - `activeEffectiveDate` string — The active effective date the employee started to work - `secondLevelManager` string — The full name of the manager in the second level - `daysOfPreviousService` string — The number of days in previous service - `yearsOfService` string — The number of years in service - `avatarUrl` string — The URL of the source of the avatar image. - `secondName` string — Employee's surname. - `about` AboutPartReadable - `foodPreferences` string — Employee's food preferences. - `superpowers` string — Employee's super powers. - `hobbies` string — A list of the employee's hobbies. - `about` string — Employee's about sentence. - `avatar` string — Image URL of the employee's avatar. - `companyId` string — The ID of the employee's company. - `email` string, email — Employee's email address. - `surname` string — Employee's surname. - `coverImageUrl` string — The URL of the cover image. - `id` string — A unique identifier representing a specific employee. - `firstName` string — Employee's first name. - EmployeeResponseMachineFormat - `fullName` string — The full name of the Employee (first name + surname). - `/work/indirectReports` string[] — The internal IDs of the people the Employee reports to indirectly. - `/about/avatar` object — The avatar URL of the employee. - `value` string - `/work/reportsTo/email` object — The email of the person the employee reports to. - `value` string - `displayName` string — Employee's display name. This defaults to first name & last name but can be customized. - `/root/firstName` object — The first name of the employee. - `value` string - `/work/employeeIdInCompany` object — The internal ID of the employee. - `value` number - `/work/tenureDurationYears` object — The tenure duration in exact years of the employee. - `value` number - `/about/foodPreferences` object — The food preferences of the employee. - `value` string - `/work/site` object — The site name of the employee. - `value` string - `/work/tenureYears` object — The tenure duration in years of the employee (rounded value). - `value` string - `creationDateTime` string — The full timestamp of creation of the Employee. - `hobbies` object - `value` string[] — An array of the employee's hobbies. - `/root/email` object — The employee's email. - `value` string - `/work/title` object — The employee's title. - `value` string - `employee` object - `payrollManager` string - `hrbp` string - `itAdmin` string - `buddy` string - `work` object - `shortStartDate` string, date — The employee's employment start date without the year - `startDate` string, date — The employee's employment start date without the year - `manager` string — The full name of the employee's manager. - `tenureDuration` object — The tenure duration of the employee. - `periodISO` string - `sortFactor` number - `humanize` string - `custom` string[] — The custom fields of the employee. - `durationOfEmployment` object — The tenure duration of employment of the employee. - `periodISO` string - `sortFactor` number - `humanize` string - `reportsToIdInCompany` number — The ID in company of the manager. - `employeeIdInCompany` number — The ID of the manager. - `reportsTo` object — The full name of the person the employee reports to. - `displayName` string - `email` string - `surname` string - `firstName` string - `id` string - `workMobile` string — The work mobile number. - `workPhone` string — The work phone number. - `indirectReports` number — The person this employee reports to indirectly. - `siteID` number — The ID of the site the employee belongs to. - `tenureDurationYears` number — The tenture duration in years. - `department` string — The department this employee belong to. - `tenureYears` number — The tenture in years. - `isManager` string — Is the employee a manager (Yes/No). - `title` string — The employee's title. - `site` string — The employee's site. - `originalStartDate` string — The original date the employee started to work - `activeEffectiveDate` string — The active effective date the employee started to work - `directReports` number — The internal ID of the person this employee reports to directly - `secondLevelManager` string — The ID of the manager in the second level - `daysOfPreviousService` number — The number of days in previous service - `yearsOfService` number — The number of years in service - `avatarUrl` string — The URL of the source of the avatar image. - `secondName` string — Employee's surname. - `about` object - `foodPreferences` string[] — Employee's food preferences. - `socialData` object — Employee's social data. - `linkedin` string - `twitter` string - `facebook` string - `superpowers` string[] — Employee's super powers. - `hobbies` string[] — A list of the employee's hobbies. - `about` string — Employee's about sentence. - `avatar` string — Image URL of the employee's avatar. - `/root/fullName` object — The employee's full name. - `value` string - `companyId` number — The ID of the employee's company. - `/root/coverImageUrl` object — The employee's cover image. - `value` string - `/work/secondLevelManager` object — The ID of the second level manager of the employee. - `value` string - `/work/directReports` object — The number of people the employee reports to directly. - `value` number - `/work/yearsOfService` object — The number of years the employee has been in service. - `value` number - `/work/daysOfPreviousService` object — The number of years the employee has been in service previously. - `value` number - `/about/about` object — Employee's about sentence. - `value` string - `/root/avatarUrl` object — The url for the avatar file of the employee. - `value` string - `/work/shortStartDate` object — The start date of the employee in a short format (without the year). - `value` string - `/work/activeEffectiveDate` object — The date the employee bacame active. - `value` string - `/root/id` object — The ID of the employee. - `value` string - `email` string, email — Employee's email address. - `/work/manager` object — The ID of the employee's manager. - `value` string - `surname` string — Employee's surname. - `/work/reportsTo` object — The details of the person the employee reports to. - `value` object - `displayName` string - `email` string - `surname` string - `firstName` string - `id` string - `/root/companyId` object — The ID of the employee's company. - `value` number - `/root/displayName` object — The display name of the employee. - `value` string - `/work/department` object — The department of the employee. - `value` string - `/work/isManager` object — The department of the employee. - `value` boolean - `/work/originalStartDate` object — The original date the employee started work. - `value` string - `coverImageUrl` string — The URL of the cover image. - `/work/reportsToIdInCompany` object — The ID of the person this employee reports to. - `value` number - `/work/tenureDuration` object — The tenture duration of the employee. - `value` object - `periodISO` string - `sortFactor` number - `humanize` string - `/about/superpowers` object — The super powers of the employee. - `value` string[] - `id` string — A unique identifier representing a specific employee. - `firstName` string — Employee's first name. - `/work/siteId` object — The site ID of the employee's site. - `value` number - `/work/durationOfEmployment` object — The duration of the employee's employment. - `value` object - `periodISO` string - `sortFactor` number - `humanize` string ## Other responses - `400` — Bad request. The request contains incorrect parameters or syntax errors. Please review the request body - `403` — Forbidden. The service user does not have permissions to access this table or employees. Check the permissions as explained in the endpoint description. - `429` — "Too Many Requests" error. This indicates that you've exceeded the rate limit for requests. Please verify that you are using the correct endpoint with the POST method. Additionally, check the HTTP headers for rate limit information, such as the number of requests allowed and the time until the limit resets. For more details, see Rate Limiting. - `default` — Unexpected error. --- [API](https://skmtc.net/hibob/apis/employee-data-api.md) · [All operations](https://skmtc.net/hibob/apis/employee-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hibob/employee-data-api/versions/0781ebbdda91/schema)