---
title: "/2026-01/retail-media/accounts/{account-id}/campaigns"
method: GET
path: "/2026-01/retail-media/accounts/{account-id}/campaigns"
tags: ["Campaign"]
---

# /2026-01/retail-media/accounts/{account-id}/campaigns

`GET /2026-01/retail-media/accounts/{account-id}/campaigns`

## Request

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

Gets page of campaign objects for the given account id

## Path parameters

- `account-id` string, required

## Query parameters

- `limitToId` string[]
- `pageIndex` integer
- `pageSize` integer

## Response `200`

Success

- JsonApiPageResponseOfCampaignV202301: A wrapper class to return a single page of <typeparamref name="T" /> with metadata
  - `data` JsonApiBodyWithIdOfInt64AndCampaignV202301AndCampaignV202301[], required
    - `attributes` CampaignV202301: A Retail Media Campaign used to represent an advertiser's marketing objective
      - `accountId` string, long-id, required
      - `budget` number, double, nullable
      - `budgetRemaining` number, double, nullable
      - `budgetSpent` number, double, nullable
      - `clickAttributionScope` 'unknown' | 'sameSku' | 'sameSkuCategory' | 'sameSkuCategoryBrand', nullable
      - `clickAttributionWindow` '7D' | '14D' | '30D' | 'unknown'
      - `companyName` string, nullable
      - `createdAt` string, date-time, required
      - `dailyPacing` number, double, nullable
      - `drawableBalanceIds` string[]
      - `endDate` string, date-time, nullable
      - `isAutoDailyPacing` boolean, required
      - `monthlyPacing` number, double, nullable
      - `name` string, required
      - `onBehalfCompanyName` string, nullable
      - `promotedBrandIds` string[]
      - `retailerId` integer, nullable
      - `startDate` string, date-time, nullable
      - `status` 'unknown' | 'active' | 'inactive' | 'scheduled' | 'ended'
      - `type` 'unknown' | 'auction' | 'preferred'
      - `updatedAt` string, date-time, required
      - `viewAttributionScope` 'unknown' | 'sameSku' | 'sameSkuCategory' | 'sameSkuCategoryBrand', nullable
      - `viewAttributionWindow` 'none' | '1D' | '7D' | '14D' | '30D' | 'unknown'
    - `id` string, long-id, required
    - `type` string, required
  - `errors` CommonError[]
    - `code` string, nullable: (REQUIRED) A machine-readable unique error code, expressed as a string value. The format used must be kebab-case.
    - `detail` string, nullable: (RECOMMENDED) A human-readable explanation specific to this occurrence of the problem.
    - `instance` string, nullable: (REQUIRED) A URI reference that identifies the specific occurrence of the problem.
    - `source` object, nullable: (OPTIONAL) A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable: (NEVER IN PRODUCTION) A human-readable stacktrace produced by the implementation technology
    - `title` string, nullable: (RECOMMENDED) A short, human-readable summary of the problem type.
    - `traceId` string, nullable: (REQUIRED) The Correlation ID provided by the Gateway. It is also a unique identifier for this particular occurrence of the problem.
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable: (REQUIRED) The classification of the error.
  - `metadata` PageMetadata, required: Metadata related to the current request
    - `currentPageIndex` integer, required
    - `currentPageSize` integer, required
    - `nextPage` string, nullable
    - `previousPage` string, nullable
    - `totalItemsAcrossAllPages` integer, nullable
    - `totalPages` integer, nullable
  - `warnings` CommonWarning[]
    - `code` string, nullable: (REQUIRED) A machine-readable unique error code, expressed as a string value. The format used must be kebab-case.
    - `detail` string, nullable: (RECOMMENDED) A human-readable explanation specific to this occurrence of the problem.
    - `instance` string, nullable: (REQUIRED) A URI reference that identifies the specific occurrence of the problem.
    - `source` object, nullable: (OPTIONAL) A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable: (NEVER IN PRODUCTION) A human-readable stacktrace produced by the implementation technology
    - `title` string, nullable: (RECOMMENDED) A short, human-readable summary of the problem type.
    - `traceId` string, nullable: (REQUIRED) The Correlation ID provided by the Gateway. It is also a unique identifier for this particular occurrence of the problem.
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable: (REQUIRED) The classification of the error.

---

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