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

# issues_list

> List issues, optionally filtered. Conditions on one filter object combine with AND. To find a team's open work, filter on team.key and state.type.

<div className="tool-route"><span className="tool-row-method" data-method="POST">POST</span><code>{"https://api.linear.app/graphql"}</code></div>

```python linear_issues_list.py theme={null}
from charter.packs import linear

result = await linear.issues_list.ainvoke({})
```

<Note>
  Posts a GraphQL document to `POST /graphql`, as every tool in this pack does. Pages by cursor: `pageInfo.endCursor` is sent back as `variables.after`.
</Note>

<Warning>
  This tool's JSON schema is 33 KB, because it models the whole resource this endpoint writes.
  That is more context than most tasks. Narrow it at the call site
  with [`Tool.derived`](/charter/charter/reference/tool#tool-derived):

  ```python theme={null}
  narrowed = linear.issues_list.derived(
      name="issues_list_narrowed",
      drop={"variables.filter"},
  )
  ```

  Those are its heaviest branches by schema size, not a recommendation: which ones you can spare is yours to decide. The tool underneath is unchanged.
  See [Projections](/charter/charter/tools/projections).
</Warning>

## Body

<div className="reference-table">
  | Field       | Type                                                                            | Description           |
  | ----------- | ------------------------------------------------------------------------------- | --------------------- |
  | `variables` | [IssuesListVariables](/charter/charter/packs/linear/issues/objects#issueslistvariables) | Paging and filtering. |
</div>