curl --request POST \
--url https://api.fyvel.io/v1/reports/{reportId}/bookings \
--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],
"key": "account:aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
"period": "2026-03",
"page": 1,
"pageSize": 50
}'
{
"companyIds": ["11111111-1111-4111-8111-111111111111"],
"periodFrom": "2026-01",
"periodTo": "2026-06",
"aggregation": "monthly",
"layerIds": ["44444444-4444-4444-8444-444444444444"],
"costCenterCodes": [100],
"key": "account:aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
"period": "2026-03",
"page": 1,
"pageSize": 50
}
{
"reportId": "66666666-6666-4666-8666-666666666666",
"snapshot": false,
"pagination": {
"page": 1,
"pageSize": 50,
"hasNext": false,
"hasPrevious": false
},
"bookings": [
{
"bookingId": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
"date": "2026-03-18",
"reportingPeriod": "2026-03-01",
"documentNumber": "INV-100",
"text": "License March",
"debit": null,
"credit": 8000,
"amount": 8000,
"costCenter": "100",
"accountNumber": 8400,
"accountName": "Revenue",
"offsetAccountNumber": 1200,
"offsetAccountName": "Bank",
"manual": false
}
]
}
Reports
Bookings
Postings behind one line and one period.
POST
/
v1
/
reports
/
{reportId}
/
bookings
curl --request POST \
--url https://api.fyvel.io/v1/reports/{reportId}/bookings \
--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],
"key": "account:aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
"period": "2026-03",
"page": 1,
"pageSize": 50
}'
{
"companyIds": ["11111111-1111-4111-8111-111111111111"],
"periodFrom": "2026-01",
"periodTo": "2026-06",
"aggregation": "monthly",
"layerIds": ["44444444-4444-4444-8444-444444444444"],
"costCenterCodes": [100],
"key": "account:aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
"period": "2026-03",
"page": 1,
"pageSize": 50
}
{
"reportId": "66666666-6666-4666-8666-666666666666",
"snapshot": false,
"pagination": {
"page": 1,
"pageSize": 50,
"hasNext": false,
"hasPrevious": false
},
"bookings": [
{
"bookingId": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
"date": "2026-03-18",
"reportingPeriod": "2026-03-01",
"documentNumber": "INV-100",
"text": "License March",
"debit": null,
"credit": 8000,
"amount": 8000,
"costCenter": "100",
"accountNumber": 8400,
"accountName": "Revenue",
"offsetAccountNumber": 1200,
"offsetAccountName": "Bank",
"manual": false
}
]
}
curl --request POST \
--url https://api.fyvel.io/v1/reports/{reportId}/bookings \
--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],
"key": "account:aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
"period": "2026-03",
"page": 1,
"pageSize": 50
}'
{
"companyIds": ["11111111-1111-4111-8111-111111111111"],
"periodFrom": "2026-01",
"periodTo": "2026-06",
"aggregation": "monthly",
"layerIds": ["44444444-4444-4444-8444-444444444444"],
"costCenterCodes": [100],
"key": "account:aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
"period": "2026-03",
"page": 1,
"pageSize": 50
}
{
"reportId": "66666666-6666-4666-8666-666666666666",
"snapshot": false,
"pagination": {
"page": 1,
"pageSize": 50,
"hasNext": false,
"hasPrevious": false
},
"bookings": [
{
"bookingId": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
"date": "2026-03-18",
"reportingPeriod": "2026-03-01",
"documentNumber": "INV-100",
"text": "License March",
"debit": null,
"credit": 8000,
"amount": 8000,
"costCenter": "100",
"accountNumber": 8400,
"accountName": "Revenue",
"offsetAccountNumber": 1200,
"offsetAccountName": "Bank",
"manual": false
}
]
}
Bearer and the API key. See Authentication.Path parameters
Report id from Reports.
Body
The values filter plus the cell fields.costCenterCodes and costCenterGroupIds limit the postings to those cost centers, the same way they do for values. Use the same selection, or the postings will not add up to the number.
key from the lines, account:<id> or category:<id>. header, spacer, and calculated have no bookings.One cell from the response:
2026-03, 2026-Q1, or 2026. It must match aggregation and fall inside the filter. Omit it to use periodFrom and periodTo, the whole row.Page, from 1 to 100. See Pagination. Pages are ordered by date and booking id, newest first.
Response
true when a selected layer is a snapshot. bookings is then empty. That is not zero activity.See Pagination.
key or a period outside the filter returns 400 and INVALID_REQUEST.