---
title: Faults CLI reference
description: View and manage Honeybadger faults (errors) from the command line.
url: https://docs.honeybadger.io/resources/cli/faults/
---

The `faults` command lets you view and manage faults (errors) in your projects.

All faults commands require `--project-id`.

## List faults

```shell
hb faults list --project-id 12345
```

### With search and ordering

```shell
# Search for specific error classes
hb faults list --project-id 12345 --query "class:RuntimeError"


# Sort by frequency instead of recency
hb faults list --project-id 12345 --order frequent


# Limit results
hb faults list --project-id 12345 --limit 10
```

**Required flags:**

* `--project-id` — Project ID

**Optional flags:**

* `-q, --query` — Search query string
* `--order` — Sort order: `recent` or `frequent` (default: `recent`)
* `--limit` — Maximum results (default: 25, max: 25)
* `-o, --output` — Output format: `table` or `json` (default: `table`)

## Get fault details

```shell
hb faults get --project-id 12345 --id 67890
```

**Required flags:**

* `--project-id` — Project ID
* `--id` — Fault ID

**Optional flags:**

* `-o, --output` — Output format: `text` or `json` (default: `text`)

## List notices for a fault

View individual error occurrences for a fault:

```shell
hb faults notices --project-id 12345 --id 67890
hb faults notices --project-id 12345 --id 67890 --limit 10
```

**Required flags:**

* `--project-id` — Project ID
* `--id` — Fault ID

**Optional flags:**

* `--limit` — Maximum results (default: 25, max: 25)
* `-o, --output` — Output format: `table` or `json` (default: `table`)

## Get fault counts

Get aggregated fault counts for a project:

```shell
hb faults counts --project-id 12345
```

**Required flags:**

* `--project-id` — Project ID

**Optional flags:**

* `-o, --output` — Output format: `text` or `json` (default: `text`)

## List affected users

View users affected by a specific fault:

```shell
hb faults affected-users --project-id 12345 --id 67890


# Search for a specific user
hb faults affected-users --project-id 12345 --id 67890 --query "user@example.com"
```

**Required flags:**

* `--project-id` — Project ID
* `--id` — Fault ID

**Optional flags:**

* `-q, --query` — Search query to filter users
* `-o, --output` — Output format: `table` or `json` (default: `table`)

---

## Try Honeybadger for FREE

Intelligent logging, error tracking, and Just Enough APM™ in one dev-friendly platform. Find and fix problems before users notice.

[Start free trial](https://app.honeybadger.io/users/sign_up)

[See plans and pricing](https://www.honeybadger.io/plans/)