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

# Lines

> Accounts and categories under one data row.

```bash cURL theme={null}
curl --request POST \
  --url https://api.fyvel.io/v1/reports/{reportId}/rows/{rowId}/lines \
  --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}
{
  "lines": [
    {
      "key": "category:99999999-9999-4999-8999-999999999999",
      "label": "Licenses",
      "values": {
        "2026-01": 8000,
        "2026-02": 7500
      }
    },
    {
      "key": "account:aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
      "label": "8400 · Revenue",
      "values": {
        "2026-01": 4000,
        "2026-02": 4100
      }
    }
  ]
}
```

**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).

**rowId** `string` *required*

Row id from the [structure](https://docs.fyvel.io/en/api/report.md). Only rows of type `data` can be opened.

## Body

The [values filter](https://docs.fyvel.io/en/api/report-values.md), with no extra fields. `costCenterCodes` and `costCenterGroupIds` limit the lines to those cost centers, the same way they do for values. Use the same selection, or the lines will not match the number.

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

One or more company ids.

**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`.

**layerIds** `string[]`

Booking layers.

**layerGroupIds** `string[]`

Layer groups.

**costCenterCodes** `number[]`

Cost center codes. The lines include only these cost centers.

**costCenterGroupIds** `string[]`

Cost center groups.

**costCenter2Codes** `string[]`

Cost object codes.

**costCenter2GroupIds** `string[]`

Cost object groups.

**displayCurrency** `string`

Three letters, for a consolidated result.

## Response

**lines** `object[]` *required*

**key** `string` *required*

`category:<id>` or `account:<id>`. You need that value for [bookings](https://docs.fyvel.io/en/api/report-bookings.md).

**label** `string` *required*

Account or category, as shown in the report.

**values** `object` *required*

Amount per period. The keys are the same periods as the [values](https://docs.fyvel.io/en/api/report-values.md).

Other row types return 400 and `ROW_NOT_EXPANDABLE`. An unknown row returns 404 and `ROW_NOT_FOUND`.


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