> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fyvel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Employees

> One row per employee.

```json 200 theme={null}
{
  "employees": [
    {
      "employeeId": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",
      "employeeNumber": "12",
      "name": "Ada Admin",
      "title": "Sales",
      "planningGroup": "Sales",
      "defaultFte": 1,
      "defaultAllocation": [
        { "costCenter": 100, "percent": 60 },
        { "costCenter": 110, "percent": 40 }
      ]
    }
  ]
}
```

**Authorization** `string` *required*

`Bearer` and the API key. See [Authentication](https://docs.fyvel.io/en/api/authentication.md).

## Path parameters

**companyId** `string` *required*

Company id from [Companies](https://docs.fyvel.io/en/api/companies.md).

## Response

**employees** `object[]` *required*

**employeeId** `string` *required*

Employee id. The same id is on [personnel costs](https://docs.fyvel.io/en/api/personnel-costs.md).

**employeeNumber** `string | null` *required*

Personnel number.

**name** `string | null` *required*

Name.

**title** `string | null` *required*

Position.

**planningGroup** `string | null` *required*

Planning group name. `null` when no group is set.

**defaultFte** `number | null` *required*

Default full-time equivalent.

**defaultAllocation** `object[] | null` *required*

Default split. `null` when no valid split is stored.

**costCenter** `number` *required*

Cost center code.

**percent** `number` *required*

Share in percent.

An unknown or forbidden company returns 400 `INVALID_COMPANY` or 403 `FORBIDDEN`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.