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

# list-filers

Returns a list of filers, in reverse chronological order.

## Flags

<ParamField body="--limit" type="integer" default="10">
  The number of results to return. The limit must be between 1 and 100.
</ParamField>

<ParamField body="--next-token" type="string">
  The token for the next page of results. If omitted, the command returns the
  first page of results.
</ParamField>

## Response

<ResponseField name="filers" type="object[]">
  The filers.

  <Expandable title="filer" defaultOpen>
    <ResponseField name="id" type="string">
      The filer ID.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      The time the filer was created, in RFC 3339 format.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total_count" type="integer">
  The total number of available results.
</ResponseField>

<ResponseField name="next_token" type="string">
  The token for the next page of results. If omitted, there are no more results.
</ResponseField>

## Example

```sh theme={null}
rhetoric list-filers --limit 20
```

```json theme={null}
{
  "filers": [
    {
      "id": "fil_01j9x1q7ssdtfpb5qmk4qzk8y0",
      "created_at": "2026-08-13T21:00:00Z"
    }
  ],
  "total_count": 1,
  "next_token": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.