> ## 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.

# Personnel costs

> One row per employee and month.

```json 200 theme={null}
{
  "costs": [
    {
      "employeeId": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",
      "month": "2026-03",
      "fte": 1,
      "gross": 5000,
      "amount": 4200,
      "allocation": [
        { "costCenter": 100, "percent": 60, "amount": 2520 },
        { "costCenter": 110, "percent": 40, "amount": 1680 }
      ]
    }
  ]
}
```

**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). Load the master through [Employees](https://docs.fyvel.io/en/api/employees.md).

## Query parameters

**from** `string` *required*

First month, `YYYY-MM`. Must not be after `to`.

**to** `string` *required*

Last month, `YYYY-MM`.

## Response

FTE, gross, and amount belong to the month, not to one cost center. The split stays in `allocation`.

**costs** `object[]` *required*

**employeeId** `string` *required*

Employee id.

**month** `string` *required*

Month, `YYYY-MM`.

**fte** `number | null` *required*

Full-time equivalent in that month.

**gross** `number | null` *required*

Gross in that month.

**amount** `number` *required*

Personnel cost in that month.

**allocation** `object[]` *required*

Split across cost centers.

**costCenter** `number` *required*

Cost center code.

**percent** `number` *required*

Share in percent.

**amount** `number | null` *required*

Amount for this cost center. `null` when none is stored.

If `from` or `to` is missing, or the range is invalid, the call returns 400 and `INVALID_PERIOD`. 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.