> For the complete documentation index, see [llms.txt](https://developer.celigo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.celigo.com/cli/commands/event-reports.md).

# event-reports

Manage event reports — async exports of integration event data that build in the background and are downloaded via a signed URL.

**REST API**: [Event reports](https://developer.celigo.com/api/api-reference/event-reports)

```
celigo event-reports <subcommand> [args] [flags]
```

Supports all [global flags](/cli/getting-started/global-flags.md).

## Subcommands

| Subcommand        | Purpose                                                       |
| ----------------- | ------------------------------------------------------------- |
| `list`            | List all event reports.                                       |
| `get <id>`        | Get an event report by ID.                                    |
| `create`          | Create an event report from a JSON body (stdin, or `--file`). |
| `signed-url <id>` | Get the signed download URL for an event report.              |
| `cancel <id>`     | Cancel an in-progress event report.                           |

***

## `celigo event-reports list`

List all event reports in the account.

**Signature**

```bash
celigo event-reports list [flags]
```

**Flags**

| Flag | Type | Default | Description |
| ---- | ---- | ------- | ----------- |

No command-specific flags. Uses global flags only.

**Example**

```bash
celigo event-reports list --format table
```

**Corresponds to**: `GET /v1/eventreports` (operationId: `listEventReports`)

***

## `celigo event-reports get`

Get one event report by ID.

**Signature**

```bash
celigo event-reports get <id>
```

**Arguments**

| Argument | Type   | Required | Description      |
| -------- | ------ | -------- | ---------------- |
| `<id>`   | string | Yes      | Event report ID. |

**Example**

```bash
celigo event-reports get 5f83a9b2c7d3e8f1a2b3c4d5
```

**Corresponds to**: `GET /v1/eventreports/{_id}` (operationId: `getEventReportById`)

***

## `celigo event-reports create`

Create an event report. Reads the JSON body from stdin, or from a file with `--file`.

**Signature**

```bash
celigo event-reports create [flags]
```

**Flags**

| Flag                | Type   | Default | Description                                                             |
| ------------------- | ------ | ------- | ----------------------------------------------------------------------- |
| `-f, --file <path>` | string | stdin   | Read the JSON body from a file instead of stdin (`-` also means stdin). |

**Request body**

Reads JSON on stdin (or from `--file`). See the `POST /v1/eventreports` schema for the full payload shape.

**Example**

```bash
cat report.json | celigo event-reports create
celigo event-reports create --file report.json
```

**Corresponds to**: `POST /v1/eventreports` (operationId: `createEventReport`)

***

## `celigo event-reports signed-url`

Get the signed download URL for a completed event report.

**Signature**

```bash
celigo event-reports signed-url <id>
```

**Arguments**

| Argument | Type   | Required | Description      |
| -------- | ------ | -------- | ---------------- |
| `<id>`   | string | Yes      | Event report ID. |

**Example**

```bash
celigo event-reports signed-url 5f83a9b2c7d3e8f1a2b3c4d5
```

**Corresponds to**: `GET /v1/eventreports/{_id}/signedurl` (operationId: `getEventReportSignedUrl`)

***

## `celigo event-reports cancel`

Cancel an in-progress event report.

**Signature**

```bash
celigo event-reports cancel <id> [flags]
```

**Arguments**

| Argument | Type   | Required | Description      |
| -------- | ------ | -------- | ---------------- |
| `<id>`   | string | Yes      | Event report ID. |

**Flags**

| Flag        | Type    | Default | Description        |
| ----------- | ------- | ------- | ------------------ |
| `-y, --yes` | boolean | `false` | Skip confirmation. |

**Example**

```bash
celigo event-reports cancel 5f83a9b2c7d3e8f1a2b3c4d5 -y
```

**Corresponds to**: `PUT /v1/eventreports/{_id}/cancel` (operationId: `cancelEventReport`)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.celigo.com/cli/commands/event-reports.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.