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]
}'
{
"companyIds": ["11111111-1111-4111-8111-111111111111"],
"periodFrom": "2026-01",
"periodTo": "2026-06",
"aggregation": "monthly",
"layerIds": ["44444444-4444-4444-8444-444444444444"],
"costCenterCodes": [100]
}
{
"values": [
{
"rowId": "77777777-7777-4777-8777-777777777777",
"period": "2026-01",
"value": 12000
},
{
"rowId": "77777777-7777-4777-8777-777777777777",
"period": "2026-02",
"value": null
}
]
}
Reports
Values
One number per row and period.
POST
/
v1
/
reports
/
{reportId}
/
values
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]
}'
{
"companyIds": ["11111111-1111-4111-8111-111111111111"],
"periodFrom": "2026-01",
"periodTo": "2026-06",
"aggregation": "monthly",
"layerIds": ["44444444-4444-4444-8444-444444444444"],
"costCenterCodes": [100]
}
{
"values": [
{
"rowId": "77777777-7777-4777-8777-777777777777",
"period": "2026-01",
"value": 12000
},
{
"rowId": "77777777-7777-4777-8777-777777777777",
"period": "2026-02",
"value": 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]
}'
{
"companyIds": ["11111111-1111-4111-8111-111111111111"],
"periodFrom": "2026-01",
"periodTo": "2026-06",
"aggregation": "monthly",
"layerIds": ["44444444-4444-4444-8444-444444444444"],
"costCenterCodes": [100]
}
{
"values": [
{
"rowId": "77777777-7777-4777-8777-777777777777",
"period": "2026-01",
"value": 12000
},
{
"rowId": "77777777-7777-4777-8777-777777777777",
"period": "2026-02",
"value": null
}
]
}
Bearer and the API key. See Authentication.Path parameters
Report id from Reports.
Body
Lines use the same object. Bookings addkey and period. The API rejects unknown fields. Rolling forecast, compare, and reporting-month are not valid fields.
monthly, quarterly, or yearly. The period in the response is then 2026-03, 2026-Q1, or 2026.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.Response
Rows of typedata, calculated, and constant only. header and spacer are omitted. Join value to the structure on rowId.
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.