Skip to main content
GET
/2026-07/retail-media/accounts/{accountId}/balances

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

FlowAuthorization Code
Authorization URL
https://api.criteo.com/oauth2
Token URL
https://api.criteo.com/oauth2/token
FlowClient Credentials
Token URL
https://api.criteo.com/oauth2/token
Scopes1
RetailMedia_Balance_Read
Grants Read access to the capabilities from the Balance domain, for RetailMedia applications

Path Parameters

accountId
string
required

The account to get balances for.

Query Parameters

limit
integer<int32>
default:25

The number of elements to be returned.

Required range: 1 <= x <= 500
limit-to-id
string[]

The balance ids which the result is limited to.

Maximum array length: 50
offset
integer<int32>
default:0

The (zero-based) starting offset in the collection.

Required range: 0 <= x <= 2147483647

Response

200 - application/json

Success

A top-level object that encapsulates a Criteo API response for several entities and metadata.

data
(object | null)[] | null

A domain entity exposed by the API, identified by a unique id.

errors
object[] | null
read-only

Errors that occured during this call.

metadata
object | null

Metadata related to the current request.

warnings
object[] | null
read-only

Warnings that occured during this call.