OSosano
cmp

Query Cookie Consent Audit Log

Changed on

Returns Cookie Consent (CMP) audit log events for the authenticated customer, in reverse-chronological order (most recent first). Supports filtering by config ID(s), event type(s), change type, actor, and a date range. Use the "next" token from the response to page through large result sets; paging is cursor-based and stable across concurrent inserts.

get/v1/cookie-consent/audit-log

Request

Query parameters

idsstring

Comma-separated list of audit event IDs to fetch specific events (e.g. the changeIds recorded on a cmp.configPublished event). When omitted, no ID filter is applied.

configIdsstring

Comma-separated list of Cookie Consent Configuration IDs to filter events by (e.g. id1,id2). When omitted, events across all configs are returned.

eventTypesstring

Comma-separated list of event types to filter by (e.g. cmp.configUpdated,cmp.configPublished, cmp.ruleUpdated, cmp.ruleCreated).

changeType'text_customization' | 'style' | 'iab' | 'setting' | 'rule'

Filter change events by the type of change recorded in the event metadata (metadata.changeType). One of text_customization, style, iab, setting, rule. Distinct from eventTypes, which filters on the machine-readable event type.

actorstring

Filter events by the acting user (email, case-insensitive).

startDatestring date-time

Return events at or after this UTC ISO-8601 timestamp (inclusive).

endDatestring date-time

Return events strictly before this UTC ISO-8601 timestamp (exclusive).

limitinteger

The maximum number of events to return per page.

nextstring

The pagination token from the previous response. Send it on its own to fetch the next page; the original filters are encoded in the token.

Response

Success

nextstring

Pagination token for the next page. Absent when there are no more results.

Example response

{
  "items": [
    {
      "module": "CMP",
      "eventType": "cmp.configPublished",
      "resources": [
        {
          "resourceType": "CMP"
        }
      ]
    }
  ]
}

Changes