---
title: "Query Cookie Consent Audit Log"
method: GET
path: "/v1/cookie-consent/audit-log"
tags: ["cmp"]
---

# Query Cookie Consent Audit Log

`GET /v1/cookie-consent/audit-log`

## Request

- Base URL: `https://api.osano.com`
- URL: `https://api.osano.com/v1/cookie-consent/audit-log`
- Auth: API key in header `x-osano-api-key`
- TypeScript: <https://skmtc.dev/osano/apis/osano-api-reference/docs/v1/cookie-consent/audit-log/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Query parameters

- `ids` string
- `configIds` string
- `eventTypes` string
- `changeType` 'text_customization' | 'style' | 'iab' | 'setting' | 'rule'
- `actor` string
- `startDate` string, date-time
- `endDate` string, date-time
- `limit` integer
- `next` string

## Response `200`

Success

- object
  - `items` object[]
    - `id` string, uuid, required: Unique identifier of the audit event.
    - `module` 'CMP', required: The Osano module the event belongs to. Currently always CMP.
    - `eventType` string, required: Machine-readable event type.
    - `actor` string, nullable: Email of the user who performed the action, when known.
    - `timestamp` string, date-time, required: UTC ISO-8601 time the event occurred.
    - `metadata` object, nullable: Event-specific free-form payload (e.g. changed fields, before/after values). Shape varies by eventType. For change events, a derived `pathLabel` is added next to `path` with the human-readable field name (e.g. "Enable Do Not Sell Default").
    - `resources` object[], required: The resource(s) this event acted on.
      - `isPrimary` boolean, required: Whether this is the primary resource for the event.
      - `resourceId` string, required: Identifier of the resource (for CMP, the config ID).
      - `resourceType` string, required
      - `resourceName` string, nullable
  - `next` string: Pagination token for the next page. Absent when there are no more results.

## Other responses

- `400`: Bad Request

## Changes

- **2026-11-06** `ac31099cf83e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/osano/apis/osano-api-reference/changes/v1/cookie-consent/audit-log/get.md)

---

[API](https://skmtc.dev/osano/apis/osano-api-reference.md) - [All operations](https://skmtc.dev/osano/apis/osano-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/osano/apis/osano-api-reference/revisions/ac31099cf83e?raw)