---
title: "Get a list of events"
method: GET
path: "/events"
tags: ["Events"]
---

# Get a list of events

`GET /events`

A list of all audit events collected to date, ordered by the date of the event in descending order. Events can be filtered by various criteria and can be returned as a csv file when the optional parameter 'asCsv' is set to true.

## Query parameters

- `asCsv` boolean
- `documentTypes` string[]
- `environments` string[]
- `eventAgents` string[]
- `eventCategories` string[]
- `eventGroups` string[]
- `excludeDifference` boolean
- `from` string, date-time
- `fromAutoId` integer
- `ids` string
- `includeInternalEvents` boolean
- `projectGroups` string[]
- `projects` string[]
- `regarding` string[]
- `regardingAny` string[]
- `skip` integer
- `tags` string[]
- `take` integer
- `tenants` string[]
- `to` string, date-time
- `toAutoId` integer
- `user` string
- `users` string[]

## Response `200`

OK

## Other responses

- `400` — Bad request. Either the payload was not structurally valid or business rules did not permit the operation.
- `404` — Not found. One or more of the entities involved in the operation was not found.

---

[API](https://skmtc.net/octopus/apis/octopus-server-api.md) · [All operations](https://skmtc.net/octopus/apis/octopus-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/octopus/octopus-server-api/versions/bc9158facfc7/schema)