---
title: "Retrieve audit events filtered by search criteria"
method: GET
path: "/api/v1/auditlog/events"
tags: ["Audit Log"]
---

# Retrieve audit events filtered by search criteria

`GET /api/v1/auditlog/events`

Required scope: `audit-log:read`

## Query parameters

- `operatorId` integer, nullable — Limit results to a certain operator
- `userId` string, nullable — Limit results to events caused by the user with this id. Supports comma-separated values for multiple IDs (e.g. '85,1').
- `teamId` integer, nullable — Limit results to events caused in the context of the team with this id
- `entityType` string, nullable — Only return events caused on this type of entity. Supports comma-separated values for multiple types (e.g. 'Team,ChargePoint').
- `entityId` string, nullable — Only return events on the entity with this ID (use in conjunction with entityType)
- `action` string, nullable — Only return events that logged this action. Supports comma-separated values for multiple actions (e.g. 'CREATE,UPDATE').
- `search` string, nullable — Free-text search in matching events
- `toDate` string, date-time, nullable — Only return events before this point in time (ISO 8601 format)
- `fromDate` string, date-time, nullable — Only return events after this point in time (ISO 8601 format)
- `perPage` integer, nullable — The maximum number of results to return
- `after` string, nullable — Cursor (event id) to retrieve results ordered after a certain event. Use this with a cursor from `meta.after` to retrieve the next page of results.
- `before` string, nullable — Cursor (event id) to retrieve results ordered before a certain event. Use this with a cursor from `meta.before` to retrieve the previous page of results. This parameter is ignored if `after`is provided in the request as well.

## Response `200`

List of events that match the criteria

- CursorBasedResponse1
  - `data` AuditEvent[], required
    - `id` string, required — A unique identifier used for single retrieval and paging
    - `timestamp` string, date-time, required — The time (UTC) the action was taken
    - `operatorId` integer, required — The operator under which the action was taken
    - `user` object, required — User details (at the time of the event) of the user that performed the action
    - `teamId` integer, nullable — The team under which the action was taken, if any
    - `action` string, required — The action (verb) that was performed, like CREATE, UPDATE, DELETE
    - `entityId` string, required — The ID of the entity (subject) that the event applies to
    - `entityType` string, required — The type of the entity (subject) that the event applies to, like Operator, Team, OperatorUser, TeamMember
    - `metadata` object, required — Additional data + context for the action taken
  - `meta` CursorBasedPageMeta, required
    - `itemCount` integer, nullable — The number of items in the result
    - `perPage` integer — The requested maximum number of items returned
    - `after` string, nullable — A cursor to retrieve the next page of items in a new request
    - `before` string, nullable — A cursor to retrieve the previous page of items in a new request

## Other responses

- `400` — The request is invalid
- `401` — Unauthorized access
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

[API](https://skmtc.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/revisions/517e18f11015/schema)