Fiest Developers

Get an accounting summary

Returns the raw Services provider accounting projection for an inclusive business-date range of at most 31 days.

GET/v1/restaurants/{restaurantId}/accounting-summary

Returns the raw Services provider accounting projection for an inclusive business-date range of at most 31 days. It does not apply Dashboard payment corrections. All monetary values use integer euro cents. For bookkeeping, also read payment-report for the identical business period. Require balanced accounting reconciliation and ready correction status, compare raw totals and VAT evidence, and use adjusted methods once without adding raw and adjusted sales. Expired gift card balances booked as income in the period are reported separately in giftCardExpiryIncome at 0% VAT; they are not sales and are not part of totals, payment methods, VAT rows or reconciliation. Book them once as their own income line. giftCardExpiryIncome is null when this deployment cannot read the gift card ledger; null does not mean zero. Organization-boundary tokens also require fiest.organization.read.

Quick request

curl -X GET "https://example.com/v1/restaurants/11111111-1111-4111-8111-111111111111/accounting-summary?organization_id=33333333-3333-4333-8333-333333333333&start_date=2026-07-01&end_date=2026-07-27" \  -H "Authorization: Bearer $FIEST_ACCESS_TOKEN"
{  "data": {    "refundReporting": {      "policy": "refund-event-date/v1",      "legacyTiming": false,      "incompleteEvidence": false    },    "restaurantId": "11111111-1111-4111-8111-111111111111",    "period": {      "startDate": "2026-01-01",      "endDate": "2026-01-31",      "timeZone": "Europe/Helsinki",      "dayStartHour": 4    },    "currency": "EUR",    "totals": {      "grossBeforeRefundsMinor": 4417630,      "refundsMinor": 9630,      "grossSalesMinor": 4408000,      "netSalesMinor": 3769568,      "vatMinor": 638432,      "discountsMinor": 21400,      "tipsMinor": 12800,      "deferredGiftCardSalesMinor": 65000,      "orderCount": 728,      "paymentTransactionCount": 728    },    "paymentMethods": [      {        "key": "card",        "label": "Card",        "transactionCount": 459,        "grossBeforeRefundsMinor": 2800000,        "refundsMinor": 5000,        "grossSalesMinor": 2795000,        "netSalesMinor": 2390000,        "vatMinor": 405000      },      {        "key": "cash",        "label": "Cash",        "transactionCount": 132,        "grossBeforeRefundsMinor": 800000,        "refundsMinor": 1630,        "grossSalesMinor": 798370,        "netSalesMinor": 690000,        "vatMinor": 108370      },      {        "key": "online",        "label": "Online",        "transactionCount": 90,        "grossBeforeRefundsMinor": 600000,        "refundsMinor": 3000,        "grossSalesMinor": 597000,        "netSalesMinor": 510000,        "vatMinor": 87000      },      {        "key": "edenred",        "label": "Edenred",        "transactionCount": 47,        "grossBeforeRefundsMinor": 217630,        "refundsMinor": 0,        "grossSalesMinor": 217630,        "netSalesMinor": 179568,        "vatMinor": 38062      }    ],    "vatBreakdown": [      {        "category": "reduced",        "label": "14%",        "rateBasisPoints": 1400,        "grossSalesMinor": 3200000,        "netSalesMinor": 2807018,        "vatMinor": 392982      },      {        "category": "standard",        "label": "25.5%",        "rateBasisPoints": 2550,        "grossSalesMinor": 1208000,        "netSalesMinor": 962550,        "vatMinor": 245450      }    ],    "reconciliation": {      "paymentGrossMinor": 4408000,      "salesGrossMinor": 4408000,      "differenceMinor": 0,      "paymentVatMinor": 638432,      "salesVatMinor": 638432,      "vatDifferenceMinor": 0,      "balanced": true,      "exactTenderRefundsMinor": 9630,      "proportionallyAllocatedRefundsMinor": 0,      "unattributedPaymentGrossMinor": 0,      "attributionComplete": true    },    "giftCardExpiryIncome": {      "grossMinor": 12500,      "vatMinor": 0,      "cardCount": 3    }  }}

Authorization

fiestOAuth fiest.restaurant.read, fiest.accounting.read
AuthorizationBearer <token>

OAuth 2.1 authorization code with PKCE. Partner clients and redirect URIs must be approved by Fiest before use.

In: header

Scope: fiest.restaurant.read, fiest.accounting.read

Path Parameters

restaurantId*string

A restaurant identifier returned by the authorized restaurant list.

Formatuuid

Query Parameters

organization_id?string

An organizationId returned by GET /v1/organizations. Required for restaurant-scoped calls when a Management portfolio authorization covers more than one organization; omitted for a single-restaurant authorization and optional for a one-organization grant.

Formatuuid
start_date*string

First restaurant business date, inclusive.

Formatdate
end_date*string

Last restaurant business date, inclusive. It cannot be in the future, and the range may contain at most 31 days.

Formatdate

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

List authorized Management organizations

Returns every organization and reviewed restaurant snapshot in a bounded Management portfolio authorization.

Get a correction-aware payment report

Returns raw payment-method totals plus adjusted totals only when the immutable Dashboard correction ledger and current source VAT/count evidence reconcile.