> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://learning.postman.com/llms.txt.

# Set up event reporting in the API Catalog

Use the `--report-events` option with the Postman CLI commands to surface run and lint results in the API Catalog. Inspect the results in the [**CI Pipeline Run Report**](/docs/api-catalog/explore/#test). This feature enables your team to review collection and specification results without needing local access to the machine that ran the command.

To access the report, in the API Catalog, click the service you're interested in, open the **Test** tab, find your run in the **CI Pipeline Runs** table, and click **View report**.

<img alt="CI Pipeline Run Report" src="https://assets.postman.com/postman-docs/v12/catalog-ci-pipeline-run-report-v12.png" />

You can surface collection and specification events when you use the `--report-events` option with the following commands:

* [`postman collection run`](/docs/postman-cli/postman-cli-collections#postman-collection-run)
* [`postman spec lint`](/docs/postman-cli/postman-cli-governance/#postman-spec-lint)

## Prerequisites

To upload event data successfully, ensure the following requirements are met:

* You're authenticated with the Postman CLI. Run `postman login` before running your command.
* If you're linting a spec, the specification resolves to a specification ID in Postman Cloud.
* If you're linting a spec, the specification is one of the following supported types:
  * OpenAPI 2.0
  * OpenAPI 3.0
  * OpenAPI 3.1

## Lint a specification with event reporting

You can lint a specification by local file path or by specification ID. Add the `--report-events` option to have either approach upload the results to the [API Catalog](/docs/api-catalog/explore/#test).

### Lint a local specification file

To lint a local specification file, run this command from the root of your collection:

```bash
cd "/path/to/your-collection"
postman spec lint "postman/specs/My API/index.yaml" --report-events
```

### Lint by specification ID

To lint a specification by its ID, run this command:

```bash
postman spec lint <spec-id> --report-events
```

## Run a collection with event reporting

You can run a collection by local path or by cloud collection UID. Add the `--report-events` option to have either approach upload the results to the [API Catalog](/docs/api-catalog/explore/#test).

### Run a local Git-native collection

To run a local Git-native collection, run this command from the root of your collection:

```bash
cd "/path/to/your-collection"
postman collection run "postman/collections/My Collection" --report-events
```

### Run a collection by cloud UID

To run a collection by its cloud UID, run this command:

```bash
postman collection run <collection-uid> --report-events
```