---
title: "List the audit events for bundles."
method: GET
path: "/bundle-events"
tags: ["Private"]
---

# List the audit events for bundles.

`GET /bundle-events`

## Request

- Base URL: `/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/bundle-events`
- Auth: API key in header `Authorization`

Audit log of bundle changes and views.

## Query parameters

- `bundle` string
- `after` string, date-time
- `before` string, date-time
- `limit` integer
- `offset` integer

## Response `200`

The list of change audit events for the bundle.

- EventsList: The list of change events which form the change and audit log for a bundle.
  - `count` integer: The number of items returned.
  - `limit` integer: The number of items requested.
  - `offset` integer: The offset of the first item to retrieve, starting at 0. Use this parameter as a pagination mechanism along with the limit parameter
  - `total_count` integer: The total number of items available.
  - `items` Event[]
    - `created_at` string, date-time: The date and time the event occurred.
    - `requested_by` object, required: The user who made the request.
      - `id` string, required: The ID of the user.
      - `email` string, email: The email of the user. This is only populated if the user is a human user.
    - `action` 'CREATE' | 'READ' | 'UPDATE' | 'DELETE', required: The action taken by the user.
    - `resource` string, required: The path of the API resource that was called.
    - `data` object: The state of the resource following a change action. This only applies `create` and `update` actions. This will be either a `Bundle` or `ContentItem` object, but as OpenAPI 2.0 does not support `oneOf`, no schema is shown.

## Other responses

- `400`: Unable to process request due to a malformed or invalid request body or query parameter.
- `401`: Authentication information is missing or invalid.
- `403`: Access denied.
- `404`: The requested resource does not exist.
- `500`: Failed to process the request due to an internal error.

## Changes

> 31 revisions in range; 2 not diffed.

- **2025-04-30** `39ab0233bf90`: 2 warning, 2 info
  - deleted the `query` request parameter `after_filter`
  - deleted the `query` request parameter `before_filter`
  - added the new optional `query` request parameter `after`
  - added the new optional `query` request parameter `before`
- **2025-04-30** `ef2686afc3f9`: 1 warning, 2 info
  - deleted the `path` request parameter `id`
  - added the new optional `query` request parameter `bundle`
  - added the non-success response with the status `400`

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/bundle-administration/changes/bundle-events/get.md)

---

[API](https://skmtc.dev/office-of-national-statistics/apis/bundle-administration.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/bundle-administration/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/bundle-administration/revisions/4ac833f533b1?raw)