---
title: "/2026-01/retail-media/balances/{balanceId}/history"
method: GET
path: "/2026-01/retail-media/balances/{balanceId}/history"
tags: ["Balance"]
---

# /2026-01/retail-media/balances/{balanceId}/history

`GET /2026-01/retail-media/balances/{balanceId}/history`

Gets the balance's historical change data.

## Path parameters

- `balanceId` string, required

## Query parameters

- `limit` integer
- `limitToChangeTypes` string
- `offset` integer

## Response `200`

Success

- PageOfBalanceHistoryChangeDataCaptureV1 — A wrapper class to return a single page of items with metadata for offset and limit based paging.
  - `data` BalanceHistoryChangeDataCaptureV1[], required
    - `changeDetails` ChangeDetailsV1, required — Change details of a property of the balance.
      - `changeValue` string, nullable — Change detail of a property of the insertion order.
      - `currentValue` string, nullable — Current value of a property of the insertion order.
      - `previousValue` string, nullable — Previous value of a property of the insertion order.
    - `changeType` 'BalanceCreated' | 'BalanceAdded' | 'BalanceRemoved' | 'BalanceUncapped' | 'BalanceCapped' | 'EndDate' | 'StartDate' | 'BalanceName' | 'PoNumber' | 'ValueAdd' | 'Unknown', required — Represent the type of change states of the history.
    - `dateOfModification` string, date-time, required — Date when data change has occured.
    - `memo` string, nullable — Memo associate with the insertion order modification.
    - `modifiedByUser` string, required — Username who modified the insertion order.
  - `meta` Metadata, nullable, required — Metadata related to the current request.
    - `count` integer, nullable
    - `limit` integer, required — The number of elements to be returned.
    - `offset` integer, required — The (zero-based) starting offset in the collection.

---

[API](https://skmtc.net/criteo/apis/criteo-api.md) · [All operations](https://skmtc.net/criteo/apis/criteo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/criteo/criteo-api/revisions/c1721589426a/schema)