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

# Personalkosten

> Eine Zeile pro Mitarbeiter und Monat.

```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` und der API-Schlüssel. Siehe [Authentifizierung](https://docs.fyvel.io/api/authentication.md).

## Path parameters

**companyId** `string` *required*

Gesellschafts-ID aus [Gesellschaften](https://docs.fyvel.io/api/companies.md). Den Stamm lädst du über [Mitarbeiter](https://docs.fyvel.io/api/employees.md).

## Query parameters

**from** `string` *required*

Erster Monat, `YYYY-MM`. Darf nicht nach `to` liegen.

**to** `string` *required*

Letzter Monat, `YYYY-MM`.

## Response

FTE, Brutto und Betrag gehören zum Monat, nicht zu einer Kostenstelle. Die Verteilung bleibt in `allocation`.

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

**employeeId** `string` *required*

Mitarbeiter-ID.

**month** `string` *required*

Monat, `YYYY-MM`.

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

Vollzeitäquivalent in diesem Monat.

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

Brutto in diesem Monat.

**amount** `number` *required*

Personalkosten in diesem Monat.

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

Verteilung auf Kostenstellen.

**costCenter** `number` *required*

Kostenstellen-Code.

**percent** `number` *required*

Anteil in Prozent.

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

Betrag dieser Kostenstelle. `null`, wenn keiner gespeichert ist.

Fehlen `from` oder `to`, oder ist die Spanne ungültig, antwortet der Aufruf mit 400 und `INVALID_PERIOD`. Eine unbekannte oder nicht erlaubte Gesellschaft antwortet mit 400 `INVALID_COMPANY` oder 403 `FORBIDDEN`.


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