> ## Documentation Index > Fetch the complete documentation index at: https://developers.criteo.com/llms.txt > Use this file to discover all available pages before exploring further. # /experimental/retail-media/retailers/{retailer-id}/change-history-entries > Returns a paginated collection of changes to Retail Media objects under the requested retailer. Use `event-types` and `entity-types` to narrow the results. Requests for inaccessible or unknown retailers return `403`. Changes outside the caller's access are omitted. Offsite campaign-level changes are not returned; offsite line-item changes are included. Actor information is limited to role labels; user identifiers are not returned. Results are returned in descending order by `occurredAt`. The relative order of entries with identical `occurredAt` values is unspecified. Additional `eventType`, entity `type`, and change `field` values may be returned. Clients must tolerate values they do not recognize. ## OpenAPI ````yaml https://api.criteo.com/experimental/retailmedia/open-api-specifications.json get /experimental/retail-media/retailers/{retailer-id}/change-history-entries openapi: 3.0.1 info: title: Criteo API description: Criteo API - RetailMedia version: Experimental servers: - url: https://api.criteo.com security: - oauth: [] tags: - name: Accounts - name: Analytics - name: Audience - name: Balance - name: Campaign - name: Catalog - name: Gateway - name: OnSiteRecommendation - name: ThirdPartyAccounts paths: /experimental/retail-media/retailers/{retailer-id}/change-history-entries: get: tags: - Campaign summary: >- /experimental/retail-media/retailers/{retailer-id}/change-history-entries description: > Returns a paginated collection of changes to Retail Media objects under the requested retailer. Use `event-types` and `entity-types` to narrow the results. Requests for inaccessible or unknown retailers return `403`. Changes outside the caller's access are omitted. Offsite campaign-level changes are not returned; offsite line-item changes are included. Actor information is limited to role labels; user identifiers are not returned. Results are returned in descending order by `occurredAt`. The relative order of entries with identical `occurredAt` values is unspecified. Additional `eventType`, entity `type`, and change `field` values may be returned. Clients must tolerate values they do not recognize. operationId: ListRetailerChangeHistoryEntries parameters: - name: campaign-ids in: query description: > When provided, only changes for these external opaque campaign identifiers are returned. Entries for campaigns outside the caller's retailer access are excluded without revealing whether the campaign exists. Omission is equivalent to an empty array. style: form schema: type: array items: type: string - name: end-time in: query description: >- Inclusive upper bound on change time, in UTC (ISO-8601 date-time). Defaults to the request time when omitted. schema: type: string format: date-time - name: entity-types in: query description: > Restrict results to changes on the given entity types (see the entity `type` field). Unknown values are not errors; they simply match no entries. Omission is equivalent to an empty array. style: form schema: type: array items: type: string - name: event-types in: query description: > Restrict results to specific change-event types (see `eventType`). When omitted, all supported event types may be returned. Unknown values are not errors; they simply match no entries. Omission is equivalent to an empty array. style: form schema: type: array items: type: string - name: limit in: query description: Maximum number of change-history entries to return in a single page. schema: maximum: 100 minimum: 1 type: integer format: int32 default: 25 - name: line-item-ids in: query description: > When provided, only changes for these external opaque line-item identifiers are returned. Entries for line items outside the caller's retailer access are excluded without revealing whether the line item exists. Omission is equivalent to an empty array. style: form schema: type: array items: type: string - name: offset in: query description: Zero-based index of the first change-history entry to return. schema: minimum: 0 type: integer format: int32 default: 0 - name: retailer-id in: path description: >- External opaque identifier of the retailer whose change history is requested. required: true schema: type: string - name: start-time in: query description: >- Inclusive lower bound on change time, in UTC (ISO-8601 date-time). Defaults to 7 days before the request time when omitted. schema: type: string format: date-time responses: '200': description: Change history entries retrieved. content: application/json: schema: $ref: >- #/components/schemas/EntityResourceCollectionOutcomeV2OfChangeHistoryEntryResponseAndSdkPageMetadata security: - oauth: - RetailMedia_Campaign_Read components: schemas: EntityResourceCollectionOutcomeV2OfChangeHistoryEntryResponseAndSdkPageMetadata: type: object properties: data: type: array items: $ref: '#/components/schemas/EntityResourceOfChangeHistoryEntryResponse' nullable: true errors: type: array items: $ref: '#/components/schemas/CommonProblem' description: Errors that occured during this call. nullable: true meta: $ref: '#/components/schemas/SdkPageMetadata' warnings: type: array items: $ref: '#/components/schemas/CommonProblem' description: Warnings that occured during this call. nullable: true additionalProperties: false description: >- A top-level object that encapsulates a Criteo API response for several entities and metadata. EntityResourceOfChangeHistoryEntryResponse: type: object properties: attributes: $ref: '#/components/schemas/ChangeHistoryEntryResponse' id: type: string description: Unique id of the entity. nullable: true type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A domain entity exposed by the API, identified by a unique id. CommonProblem: type: object properties: code: type: string description: A machine-readable error code, expressed as a string value. nullable: true detail: type: string description: >- A human-readable explanation specific to this occurrence of the problem nullable: true instance: type: string description: A URI that identifies the specific occurrence of the problem. nullable: true source: type: object additionalProperties: type: string description: >- A machine-readable structure to reference to the exact location(s) causing the error(s) nullable: true stackTrace: type: string nullable: true title: type: string description: A short human-readable description of the problem type nullable: true traceId: type: string description: The request correlation ID this problem comes from. nullable: true traceIdentifier: type: string description: >- The request correlation ID this problem comes from. (deprecated, use traceId instead) nullable: true type: enum: - unknown - access-control - authentication - authorization - availability - deprecation - quota - validation type: string description: The problem's category. nullable: true description: Common problem object. SdkPageMetadata: required: - offset - limit type: object properties: count: type: integer description: Total number of items across all pages in the collection. format: int32 nullable: true limit: type: integer description: The number of elements to be returned. format: int32 offset: type: integer description: The (zero-based) starting offset in the collection. format: int32 additionalProperties: false description: Offset based pagination metadata. nullable: true ChangeHistoryEntryResponse: required: - occurredAt - eventType - actorRole - entity - changes type: object properties: actorRole: allOf: - $ref: '#/components/schemas/ActorRole' description: >- Role label of the actor that performed the change. No user identifiers are exposed. changes: type: array items: $ref: '#/components/schemas/ChangedField' description: Old and new values for each field changed as part of this event. entity: allOf: - $ref: '#/components/schemas/ChangeHistoryEntity' description: Primary entity affected by the change. eventType: type: string description: > Semantic type of the configuration change, `` style — for example `campaignCreated`, `lineItemUpdated`, `balanceUpdated`. Additional values may be returned. occurredAt: type: string description: UTC timestamp when the change occurred (ISO-8601). format: date-time additionalProperties: false description: A single configuration change. nullable: true ActorRole: enum: - unknown - internal - external - api - automatedTask type: string description: Role label exposed to external callers for the actor of a change. ChangedField: required: - field - previousValue - newValue type: object properties: field: type: string description: > Name of the field that changed, in camelCase — for example `name`, `status`, `budget`, `bid`, `startDate`, or `endDate`. newValue: type: string description: > Display-safe value after the change, serialized as a string for consistent display across primitive field types. Null when the field was cleared or removed. nullable: true previousValue: type: string description: > Display-safe value before the change, serialized as a string for consistent display across primitive field types. Null when the field did not exist previously. nullable: true additionalProperties: false description: A single field change included in a change-history entry. ChangeHistoryEntity: required: - type - id type: object properties: campaignId: type: string description: > External opaque campaign identifier when the changed entity belongs to a campaign (for example a line item). Omitted otherwise; omission and `null` have the same meaning. nullable: true id: type: string description: External opaque identifier of the entity that changed. type: type: string description: > Type of entity that changed, such as `campaign`, `lineItem`, `balance`, `audience`, `audienceSegment`, `creative`, or `targetingList`. Additional values may be returned. additionalProperties: false description: Entity associated with a change-history entry. securitySchemes: oauth: type: oauth2 flows: clientCredentials: tokenUrl: https://api.criteo.com/oauth2/token scopes: RetailMedia_Accounts_Read: >- Grants Read access to the capabilities from the Accounts domain, for RetailMedia applications RetailMedia_Analytics_Read: >- Grants Read access to the capabilities from the Analytics domain, for RetailMedia applications RetailMedia_Audience_Manage: >- Grants Manage access to the capabilities from the Audience domain, for RetailMedia applications RetailMedia_Balance_Read: >- Grants Read access to the capabilities from the Balance domain, for RetailMedia applications RetailMedia_Campaign_Manage: >- Grants Manage access to the capabilities from the Campaign domain, for RetailMedia applications RetailMedia_Campaign_Read: >- Grants Read access to the capabilities from the Campaign domain, for RetailMedia applications RetailMedia_Catalog_Manage: >- Grants Manage access to the capabilities from the Catalog domain, for RetailMedia applications RetailMedia_Catalog_Read: >- Grants Read access to the capabilities from the Catalog domain, for RetailMedia applications RetailMedia_OnSiteRecommendation_Read: >- Grants Read access to the capabilities from the OnSiteRecommendation domain, for RetailMedia applications RetailMedia_ThirdPartyAccounts_Manage: >- Grants Manage access to the capabilities from the ThirdPartyAccounts domain, for RetailMedia applications authorizationCode: authorizationUrl: https://api.criteo.com/oauth2 tokenUrl: https://api.criteo.com/oauth2/token scopes: RetailMedia_Accounts_Read: >- Grants Read access to the capabilities from the Accounts domain, for RetailMedia applications RetailMedia_Analytics_Read: >- Grants Read access to the capabilities from the Analytics domain, for RetailMedia applications RetailMedia_Audience_Manage: >- Grants Manage access to the capabilities from the Audience domain, for RetailMedia applications RetailMedia_Balance_Read: >- Grants Read access to the capabilities from the Balance domain, for RetailMedia applications RetailMedia_Campaign_Manage: >- Grants Manage access to the capabilities from the Campaign domain, for RetailMedia applications RetailMedia_Campaign_Read: >- Grants Read access to the capabilities from the Campaign domain, for RetailMedia applications RetailMedia_Catalog_Manage: >- Grants Manage access to the capabilities from the Catalog domain, for RetailMedia applications RetailMedia_Catalog_Read: >- Grants Read access to the capabilities from the Catalog domain, for RetailMedia applications RetailMedia_OnSiteRecommendation_Read: >- Grants Read access to the capabilities from the OnSiteRecommendation domain, for RetailMedia applications RetailMedia_ThirdPartyAccounts_Manage: >- Grants Manage access to the capabilities from the ThirdPartyAccounts domain, for RetailMedia applications ````