---
title: "Get provider events"
method: GET
path: "/events/provider"
tags: ["events"]
---

# Get provider events

`GET /events/provider`

Returns an array with one or more provider events applying the specified filters. This API is only available if you configure an "eventsearcher" plugin

## Query parameters

- `start_timestamp` integer
- `end_timestamp` integer
- `actions` ProviderEventAction[]
- `username` string
- `ip` string
- `object_name` string
- `object_types` ProviderEventObjectType[]
- `instance_ids` string[]
- `from_id` string
- `role` string
- `csv_export` boolean
- `omit_object_data` boolean
- `limit` integer
- `order` 'ASC' | 'DESC'

## Response `200`

successful operation

- ProviderEvent[]
  - `id` string
  - `timestamp` integer — unix timestamp in nanoseconds
  - `action` 'add' | 'update' | 'delete'
  - `username` string
  - `ip` string
  - `object_type` 'user' | 'folder' | 'group' | 'admin' | 'api_key' | 'share' | 'event_action' | 'event_rule' | 'role'
  - `object_name` string
  - `object_data` string, byte — base64 of the JSON serialized object with sensitive fields removed
  - `role` string
  - `instance_id` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error
- `default` — Unexpected Error

---

[API](https://skmtc.net/kanton-bern/apis/sftpgo.md) · [All operations](https://skmtc.net/kanton-bern/apis/sftpgo/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kanton-bern/sftpgo/revisions/d8d616a479b0/schema)