---
id: events
title: events
---

Lists events, including discarded-record tombstones. Requires the events:read scope.

```graphql
events(
  after: String
  first: Int = 100
  updatedSince: DateTime
): EventCollection!
```

### Arguments

#### [`events.after`](#after) · [`String`](/docs/developers/api-reference/management/v1/types/scalars/string) **scalar** {#after}

Return records after this opaque cursor from the previous page.

#### [`events.first`](#first) · [`Int`](/docs/developers/api-reference/management/v1/types/scalars/int) **scalar** {#first}

Number of records to return. Values are limited to a maximum of 100.

#### [`events.updatedSince`](#updated-since) · [`DateTime`](/docs/developers/api-reference/management/v1/types/scalars/date-time) **scalar** {#updated-since}

Include records updated at or after this timestamp (inclusive).

### Type

#### [`EventCollection`](/docs/developers/api-reference/management/v1/types/objects/event-collection) **object**

One deterministic page from the Management v1 change feed.