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

# List the audit events for bundles.

`GET /bundle-events`

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.

---

[API](https://skmtc.net/office-of-national-statistics/apis/bundle-administration.md) · [All operations](https://skmtc.net/office-of-national-statistics/apis/bundle-administration/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/office-of-national-statistics/bundle-administration/revisions/4ac833f533b1/schema)