> ## Documentation Index
> Fetch the complete documentation index at: https://help.lobyco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Savings History

> Show customers how much they saved — reading the aggregated savings endpoints from web or app.

Show a customer the total value of their benefits over a period of time. The Savings History endpoints are an **aggregation layer**: they consolidate Bonus Accounting with the Lobyco promotional services — Offers, Games and Challenges — so your app or website doesn't have to query each service separately.

## Before you start

* Authentication must be working — see [API Authentication](/integration/quick-start/api-authentication).
* The endpoints serve web and app channels (`/web/v1/…`) and return `application/json`.

## Read the savings

<Steps>
  <Step>
    ### Fetch the statements

    [GET /web/v1/statements](/api-reference/savings-history/member-savings/get-web-v1-statements)

    Retrieve the customer's savings statements for the period. The list is paginated — see below.
  </Step>

  <Step>
    ### Fetch the statistics

    [GET /web/v1/statistics](/api-reference/savings-history/member-savings/get-web-v1-statistics)

    Retrieve the aggregated totals to headline the savings view.
  </Step>
</Steps>

## Pagination

List endpoints use **cursor-based** pagination:

1. Include the `limit` parameter to set the page size.
2. Read the `NextCursor` field from the response.
3. Pass that value as the `cursor` parameter on the next request.
4. Stop when `NextCursor` is null or empty.

## Localization

Use the `Accept-Language` header (for example `en`, `dk`) to control the language of the localized display names in the response. It defaults to `en`.

## Failure and edge cases

Because this is an aggregation over several services, a benefit appears here once its source service has recorded it — a just-completed purchase may take a moment to show up in the savings view.

## Related

* [Savings History API reference](/api-reference/savings-history)
* [Bonus](/api-reference/bonus) and [Promotion Platform](/api-reference/promotion-platform) — the underlying data