---
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`

## Request

- Base URL: `https://api.criteo.com`
- URL: `https://api.criteo.com/2026-01/retail-media/balances/{balanceId}/history`
- Auth: OAuth 2
  - Authorization code: `https://api.criteo.com/oauth2`
  - Client credentials
  - Token URL: `https://api.criteo.com/oauth2/token` scopes: `RetailMedia_Balance_Read`

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.dev/criteo/apis/criteo-api.md) - [All operations](https://skmtc.dev/criteo/apis/criteo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/criteo/apis/criteo-api/revisions/c1721589426a?raw)