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

# takedowns command — list takedown records with filters

> List ChainPatrol takedown records from the terminal with the same filters as the app's Takedowns view: status, liveness, brand, assignee, and date ranges.

```bash theme={null}
chainpatrol takedowns list [--org <slug>] [filters]
```

## takedowns list

List takedowns for an organization with the same level of filtering as the app's Takedowns
view. Defaults to takedowns updated in the last 30 days.

Works with both authentication modes: with an API key the organization comes from the key,
and with a session you pass `--org`.

| Option                                        | Description                                                                                  |
| --------------------------------------------- | -------------------------------------------------------------------------------------------- |
| `--org <slug>`                                | Organization slug. Omit when using an organization-scoped API key.                           |
| `--query <text>`                              | Search asset content (substring match).                                                      |
| `--from <iso>` / `--to <iso>`                 | Filter on `Takedown.updatedAt`.                                                              |
| `--started-from <iso>` / `--started-to <iso>` | Filter on "started at" — the earliest `IN_PROGRESS` event.                                   |
| `--asset-type <list>`                         | Comma list: `URL`, `TWITTER`, `TELEGRAM`, …                                                  |
| `--takedown-status <list>`                    | Comma list: `TODO`, `IN_PROGRESS`, `COMPLETED`, `CANCELLED`, `PENDING_INPUT`, …              |
| `--liveness-status <list>`                    | Comma list: `ALIVE`, `DEAD`, `UNKNOWN`.                                                      |
| `--brand <ids>`                               | Comma list of brand IDs.                                                                     |
| `--assignee <ids>`                            | Comma list of assignee user IDs.                                                             |
| `--hide-automated-takedowns`                  | Hide takedowns handled by the platform-takedown automation.                                  |
| `--hide-automated-liveness-checks`            | Hide takedowns whose asset liveness is checked automatically.                                |
| `--sort-by <key>`                             | `updatedAt`, `createdAt`, `takedownStatus`, `takedownUpdatedAt`, `assigneeId`, or `brandId`. |
| `--sort-direction <dir>`                      | `asc` or `desc`. Defaults to `desc`.                                                         |
| `--per-page <n>`                              | Page size, 1–100. Defaults to 10. `--limit` is also accepted.                                |
| `--next-page <cursor>`                        | Cursor returned by a previous response.                                                      |

```bash theme={null}
# the open queue
chainpatrol takedowns list --org acme --takedown-status TODO,IN_PROGRESS --per-page 50

# still-live URLs
chainpatrol takedowns list --org acme --asset-type URL --liveness-status ALIVE

# by brand and owner
chainpatrol takedowns list --org acme --brand 12,34 --assignee 7

# manual work started since April
chainpatrol takedowns list --org acme --started-from 2026-04-01 --hide-automated-takedowns

# a quarter's records as a spreadsheet
chainpatrol takedowns list --org acme --from 2026-01-01 --to 2026-04-01 \
  --per-page 100 --output csv > q1-takedowns.csv
```

<Tip>
  `--from`/`--to` filter on when the takedown was last *updated*, while
  `--started-from`/`--started-to` filter on when work actually began. For "how much did we
  start this month", use the latter.
</Tip>

## Related

* [`GET /organization/takedowns`](/docs/external-api/takedowns-list)
* [Takedowns concept](/docs/concepts/takedowns)
* [`queues snapshot`](/docs/cli/commands/queues) for the aggregate view