---
title: "ezgh trails events"
description: "Look up events, newest first (the last 7 days unless --from says otherwise)."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ezgh trails events

{/* Generated by ezgh-cli's internal/tools/clidocs from the ezgh command tree. Don't edit: change the command's help in ezgh-cli and regenerate. */}

```sh
ezgh trails events [flags]
```

Look up Trails events, newest first, with the filters the console has. Without `--from`, the last 7 days. Times are RFC 3339, a date, or a duration ago (2h, 7d).

`--principal` takes a principal ID, or a user's email or a bot's slug or name, which are looked up in your organization. `--project` filters to one project (ID, slug or name).

Part of [`ezgh trails`](/cli/reference/trails).

## Examples

```sh
ezgh trails events --from 2h --event-source organizations.ezghcloud.com
ezgh trails events --principal ada@acme.test --read-only=false --all -o json
ezgh trails events get 0199a3d0-3c4d-7e5f-a061-7c8d9e0f1a2b
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--access-key` | string |  | only calls made with this API key ID |
| `--all` | boolean |  | follow nextCursor through every page |
| `--cursor` | string |  | start from this page (a previous page's nextCursor) |
| `--error-code` | string |  | only calls that failed with this code |
| `--event-name` | string |  | only this event (CreateProject…) |
| `--event-source` | string |  | only this service's events (organizations.ezghcloud.com, trails.ezghcloud.com…) |
| `--event-type` | string |  | ApiCall, ServiceEvent or SignIn |
| `--from` | string |  | events at or after this time (default: 7 days ago) |
| `--has-error` | string |  | true: only failed calls; false: only successful ones (`--has-error` alone means `true`) |
| `--limit` | int |  | items per page, 1 to 200 (default 50) |
| `--principal` | string |  | only this caller: a principal ID, a user's email, or a bot |
| `--read-only` | string |  | true: only reads; false: only changes (`--read-only` alone means `true`) |
| `--resource` | string |  | only events that touched this resource name |
| `--to` | string |  | events before this time |

This command also takes the [global flags](/cli/reference#global-flags).

## Subcommands

| Command | Description |
| --- | --- |
| [`ezgh trails events get`](/cli/reference/trails-events-get) | Show one event in full |

Source: https://docs.ezghcloud.com/cli/reference/trails-events/index.mdx