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

# Values

> One number per row and period.

```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` and the API key. See [Authentication](https://docs.fyvel.io/en/api/authentication.md).

## Path parameters

**reportId** `string` *required*

Report id from [Reports](https://docs.fyvel.io/en/api/reports.md).

## Body

[Lines](https://docs.fyvel.io/en/api/report-lines.md) use the same object. [Bookings](https://docs.fyvel.io/en/api/report-bookings.md) add `key` and `period`. The API rejects unknown fields. Rolling forecast, compare, and reporting-month are not valid fields.

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

One or more company ids. Several return one consolidated figure.

**periodFrom** `string` *required*

Inclusive, format `YYYY-MM`.

**periodTo** `string` *required*

Inclusive, format `YYYY-MM`. Must not be before `periodFrom`.

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

`monthly`, `quarterly`, or `yearly`. The period in the response is then `2026-03`, `2026-Q1`, or `2026`.

**layerIds** `string[]`

Booking layers. An empty array leaves the default layers out. Without `layerIds` and without `layerGroupIds`, the call uses the default layers of the first company in `companyIds`.

**layerGroupIds** `string[]`

Layer groups. Combined with `layerIds`.

**costCenterCodes** `number[]`

Cost center codes, positive integers. The result is one P\&L for that selection.

**costCenterGroupIds** `string[]`

Cost center groups. Expanded into codes.

**costCenter2Codes** `string[]`

Cost object codes.

**costCenter2GroupIds** `string[]`

Cost object groups.

**displayCurrency** `string`

Three letters, for a consolidated result.

## Response

Rows of type `data`, `calculated`, and `constant` only. `header` and `spacer` are omitted. Join `value` to the [structure](https://docs.fyvel.io/en/api/report.md) on `rowId`.

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

**rowId** `string` *required*

Row id from the structure.

**period** `string` *required*

Period matching `aggregation`.

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

Amount. `null` when the cell has no value yet.

While the numbers are still being rebuilt, the call returns 503 and `REFRESH_PENDING` instead of a page of zeros. Repeat the same call after a short wait. Large companies can take up to a minute.

An invalid filter returns 400 and `INVALID_FILTER`. An unknown report id returns 400 and `INVALID_REPORT`.


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