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

# Werte

> Eine Zahl pro Zeile und Periode.

```bash cURL theme={null}
curl --request POST \
  --url https://api.fyvel.io/v1/reports/{reportId}/values \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "companyIds": ["11111111-1111-4111-8111-111111111111"],
  "periodFrom": "2026-01",
  "periodTo": "2026-06",
  "aggregation": "monthly",
  "layerIds": ["44444444-4444-4444-8444-444444444444"],
  "costCenterCodes": [100]
}'
```

```json Body theme={null}
{
  "companyIds": ["11111111-1111-4111-8111-111111111111"],
  "periodFrom": "2026-01",
  "periodTo": "2026-06",
  "aggregation": "monthly",
  "layerIds": ["44444444-4444-4444-8444-444444444444"],
  "costCenterCodes": [100]
}
```

```json 200 theme={null}
{
  "values": [
    {
      "rowId": "77777777-7777-4777-8777-777777777777",
      "period": "2026-01",
      "value": 12000
    },
    {
      "rowId": "77777777-7777-4777-8777-777777777777",
      "period": "2026-02",
      "value": null
    }
  ]
}
```

**Authorization** `string` *required*

`Bearer` und der API-Schlüssel. Siehe [Authentifizierung](https://docs.fyvel.io/api/authentication.md).

## Path parameters

**reportId** `string` *required*

Berichts-ID aus [Berichte](https://docs.fyvel.io/api/reports.md).

## Body

Dieselbe Form nutzen [Zeilen](https://docs.fyvel.io/api/report-lines.md). [Buchungen](https://docs.fyvel.io/api/report-bookings.md) ergänzen `key` und `period`. Unbekannte Felder lehnt die API ab. Rolling Forecast, Vergleich und Monatsreporting sind keine gültigen Felder.

**companyIds** `string[]` *required*

Eine oder mehrere Gesellschafts-IDs. Mehrere ergeben eine konsolidierte Zahl.

**periodFrom** `string` *required*

Inklusive, Format `YYYY-MM`.

**periodTo** `string` *required*

Inklusive, Format `YYYY-MM`. Darf nicht vor `periodFrom` liegen.

**aggregation** `string` (default: monthly)

`monthly`, `quarterly` oder `yearly`. Die Periode in der Antwort ist dann `2026-03`, `2026-Q1` oder `2026`.

**layerIds** `string[]`

Buchungsebenen. Ein leeres Array lässt die Standard-Ebenen weg. Ohne `layerIds` und ohne `layerGroupIds` gelten die Standard-Ebenen der ersten Gesellschaft in `companyIds`.

**layerGroupIds** `string[]`

Ebenengruppen. Werden mit `layerIds` vereinigt.

**costCenterCodes** `number[]`

Kostenstellen-Codes, positive ganze Zahlen. Das Ergebnis ist eine GuV für diese Auswahl.

**costCenterGroupIds** `string[]`

Kostenstellengruppen. Werden in Codes aufgelöst.

**costCenter2Codes** `string[]`

Kostenträger-Codes.

**costCenter2GroupIds** `string[]`

Kostenträgergruppen.

**displayCurrency** `string`

Drei Buchstaben, für ein konsolidiertes Ergebnis.

## Response

Nur Zeilen vom Typ `data`, `calculated` und `constant`. `header` und `spacer` fehlen. Hänge `value` über `rowId` an die [Struktur](https://docs.fyvel.io/api/report.md).

**values** `object[]` *required*

**rowId** `string` *required*

Zeilen-ID aus der Struktur.

**period** `string` *required*

Periode passend zu `aggregation`.

**value** `number | null` *required*

Betrag. `null`, solange für die Zelle kein Wert vorliegt.

Wenn die Zahlen noch neu aufgebaut werden, antwortet der Aufruf mit 503 und `REFRESH_PENDING` statt mit lauter Nullen. Denselben Aufruf nach kurzer Zeit wiederholen. Große Gesellschaften können bis zu einer Minute brauchen.

Ein ungültiger Filter antwortet mit 400 und `INVALID_FILTER`. Ein unbekannter Bericht antwortet mit 400 und `INVALID_REPORT`.


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