---
title: "Get all employee fields."
method: GET
path: "/company/people/fields"
tags: ["Metadata"]
---

# Get all employee fields.

`GET /company/people/fields`

This endpoint retrieves only metadata about the employee fields and includes all employee fields. Calling this endpoint does not require any permissions for the service user performing this action. <br/><br/>However, fetching the actual data requires setting the relevant permissions for the service user, including permissions to access employee data and relevant categories. <br />To learn more, see  <a href="https://apidocs.hibob.com/reference/post_people-search">Search for employees</a> .

## Response `200`

Successful response.

- Field[]
  - `id` string — ID of the field.
  - `categoryId` string — ID of the field category.
  - `categoryDisplayName` string — Display name of the field category.
  - `category` string — To be deprecated. Use categoryId instead.
  - `name` string — Name of the field.
  - `description` string — Description of the field.
  - `jsonPath` string — A dot-separated path of this field value in the employee JSON returned by the /v1/profiles endpoint.
  - `type` string — The type of the field. Supported field types: text, text-area, number, date, list, multi-list, hierarchy-list, currency, employee-reference, document.
  - `typeData` object
    - `listId` string — The ID of the list in the /v1/company/named-lists endpoint.
  - `historical` boolean — When true, this field keeps the history of its values, each being active starting from a certain date. The default value is false.

---

[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)