---
title: "/2026-01/retail-media/accounts/{account-id}/balances/{balance-id}/change-dates"
method: POST
path: "/2026-01/retail-media/accounts/{account-id}/balances/{balance-id}/change-dates"
tags: ["Balance"]
---

# /2026-01/retail-media/accounts/{account-id}/balances/{balance-id}/change-dates

`POST /2026-01/retail-media/accounts/{account-id}/balances/{balance-id}/change-dates`

## Request

- Base URL: `https://api.criteo.com`
- URL: `https://api.criteo.com/2026-01/retail-media/accounts/{account-id}/balances/{balance-id}/change-dates`
- Auth: OAuth 2
  - Authorization code: `https://api.criteo.com/oauth2`
  - Client credentials
  - Token URL: `https://api.criteo.com/oauth2/token` scopes: `RetailMedia_Balance_Manage`

Change dates of a balance for the given account id

## Path parameters

- `account-id` string, required
- `balance-id` string, required

## Request body

- ChangeDatesOfBalanceV2Request: A top-level object that encapsulates a Criteo API request for a single entity
  - `data` ResourceOfChangeDatesOfBalanceV2: A class that represents a domain entity exposed by an API
    - `attributes` ChangeDatesOfBalanceV2: An object that represents the available options to modify schedule of a balance.
      - `endDate` string: End date of the balance in the format YYYY-MM-DD.
      - `memo` string: Memo.
      - `startDate` string: Start date of the balance in the format YYYY-MM-DD.
    - `id` string: Id of the entity
    - `type` string: Canonical type name of the entity

## Response `200`

Success

- BalanceResponseV2Response, nullable: A top-level object that encapsulates a Criteo API response for a single entity
  - `data` ResourceOfBalanceResponseV2, nullable: A class that represents a domain entity exposed by an API
    - `attributes` BalanceResponseV2, nullable: A Retail Media Balance used to determine the funds available for any or all campaigns in an account
      - `balanceType` 'unknown' | 'capped' | 'uncapped', required: Type of the balance.
      - `createdAt` string, date-time: Creation time of the balance.
      - `deposited` number, double, nullable: Amount of billable funds allotted to the balance.
      - `endDate` string, nullable: End date of the balance in the format YYYY-MM-DD.
      - `memo` string, nullable: Memo.
      - `name` string, required: Name of the balance.
      - `poNumber` string, nullable: Purchase Order number.
      - `privateMarketBillingType` 'notApplicable' | 'billByRetailer' | 'billByCriteo' | 'unknown', required: Billing type for Private Market of the balance.
      - `remaining` number, double, nullable: Amount of remaining funds of the balance.
      - `spendType` 'Onsite' | 'Offsite' | 'OffsiteAwareness', required: Spend Type of the balance.
      - `spent` number, double, nullable: Amount of spent funds of the balance.
      - `startDate` string, required: Start date of the balance in the format YYYY-MM-DD.
      - `status` 'unknown' | 'scheduled' | 'active' | 'ended': Status of the balance.
      - `updatedAt` string, date-time: Update time of the balance.
    - `id` string, nullable: Id of the entity
    - `type` string, nullable: Canonical type name of the entity
  - `errors` CommonProblem[]
    - `code` string, nullable: A machine-readable error code, expressed as a string value.
    - `detail` string, nullable: A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable: A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable: A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `title` string, nullable: A short human-readable description of the problem type
    - `traceId` string, nullable: The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable: The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable: The problem's category.
  - `warnings` CommonProblem[]
    - `code` string, nullable: A machine-readable error code, expressed as a string value.
    - `detail` string, nullable: A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable: A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable: A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `title` string, nullable: A short human-readable description of the problem type
    - `traceId` string, nullable: The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable: The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable: The problem's category.

---

[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)