> ## 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. # reports command — create, list, and search reports > Create ChainPatrol reports from the terminal, browse an organization's report queue with full filtering, and search by asset content to avoid duplicates. ```bash theme={null} chainpatrol reports ``` ## reports create Create a report with one or more assets. ```bash theme={null} chainpatrol reports create [--org ] [options] ``` | Option | Description | | -------------------------------- | ----------------------------------------------------------------------------- | | `--org ` | Organization slug. Defaults to the saved or environment org. | | `--title ` | Report title. | | `--description ` | Report description. | | `--contact-info ` | Reporter contact info. | | `--asset ` | Asset to include. Repeatable. `status` is `BLOCKED`, `ALLOWED`, or `UNKNOWN`. | | `--attachment-url ` | Attachment URL. Repeatable. | | `--external-submission-link ` | External submission link. | | `--payload-file ` | JSON file containing the full report payload. | | `--dry-run` | Print the payload without submitting it. | ```bash theme={null} # a single asset chainpatrol reports create --org acme \ --title "New phishing campaign" \ --description "Detected from CLI" \ --asset "https://phish.example:BLOCKED" # several assets and an attachment chainpatrol reports create --org acme --title "Batch report" \ --asset "https://a.example:BLOCKED" \ --asset "https://b.example:ALLOWED" \ --attachment-url "https://cdn.example/screenshot1.png" # preview first, then submit chainpatrol reports create --org acme --title "Batch report" \ --asset "https://a.example:BLOCKED" --dry-run --output markdown ``` For fields the flags do not cover — `externalReporter`, enrichments, `rawAssetsInput` — pass a payload file: ```bash theme={null} chainpatrol reports create --payload-file ./report-payload.json --json ``` ## reports list List recent reports for an organization, with the same filtering as the app's Reports view. ```bash theme={null} chainpatrol reports list --org [filters] ``` | Option | Description | | --------------------------------------------- | ------------------------------------------------------- | | `--org ` | Organization slug. | | `--limit ` | Page size, 1–20. | | `--cursor ` | Pagination cursor. | | `--status ` | Report status: `TODO`, `IN_PROGRESS`, or `CLOSED`. | | `--search ` | Search by title or description. | | `--reporter-query ` | Search by reporter name (legacy). | | `--reported-by-customer` | Only customer-submitted reports. | | `--no-reported-by-customer` | Only non-customer reports. | | `--needs-customer-review` | Only reports awaiting your organization's own approval. | | `--no-needs-customer-review` | Only reports not awaiting your approval. | | `--reporter-kind ` | Filter by reporter: `human` or `automation`. | | `--reviewer-kind ` | Filter by approver: `human` or `automation`. | | `--exclude-automation` | Deprecated — prefer `--reporter-kind human`. | | `--only-rejected` | Only reports whose latest review decision was `REJECT`. | | `--review-status ` | Comma list: `APPROVE`, `REJECT`, `SKIP`, `ESCALATE`. | | `--asset-type ` | Comma list of asset types (`URL`, `TWITTER`, …). | | `--brand ` | Comma list of brand IDs. | | `--country-code ` | Comma list of 2-letter ISO country codes. | | `--reviewed-by-user-id ` | Only reports reviewed by a specific user ID. | | `--from ` / `--to ` | Filter on `createdAt`. | | `--updated-from ` / `--updated-to ` | Filter on `updatedAt`. | ```bash theme={null} chainpatrol reports list --org acme --limit 10 chainpatrol reports list --org acme --status TODO --review-status REJECT chainpatrol reports list --org acme --reporter-kind human --reviewer-kind automation chainpatrol reports list --org acme --brand 12,34 --country-code US,GB chainpatrol reports list --org acme --needs-customer-review ``` Responses include `totalCount` — the number of reports matching your filters, independent of `--limit` and `--cursor`. Use it as a denominator when sampling ("sampled 200 of \~4,235") or to decide whether to paginate or narrow the filters first. `--needs-customer-review` is the queue [`proposals review`](/docs/cli/commands/proposals) acts on. The proposal and asset IDs that command needs come from `proposals[].id` and `proposals[].asset.id` in this listing. ## reports search Answer "does a report already exist for these assets?" in one call. This is the fast way to avoid filing a duplicate; to browse or filter an organization's reports, use `reports list` instead. ```bash theme={null} chainpatrol reports search [ ...] ``` | Option | Description | | --------------------------- | ---------------------------------------------------------------------- | | `--org ` | Organization slug. Defaults to the saved or environment org. | | `--asset ` | Asset content. Repeatable, and an alternative to positional arguments. | | `--reported-by-customer` | Match only customer-submitted reports. | | `--no-reported-by-customer` | Match only non-customer reports. | | `--limit ` | Max reports to return, newest first. 1–100, defaults to 50. | ```bash theme={null} chainpatrol reports search https://bad.site chainpatrol reports search https://a.site https://b.site --reported-by-customer chainpatrol reports search https://bad.site --limit 100 ``` ## Related * [`POST /report/create`](/docs/external-api/report-create) * [`GET /organization/reports`](/docs/external-api/organization-reports-list) * [Reports concept](/docs/concepts/reports)