# list_tickets

`tools/call` · `POST /agent/v1/tickets:list`

List the tickets your person can read, without their plans, optionally for one team or project, one owner, or some status categories. Returns tickets by status category, status and rank, each with its status, owner, project, milestone and tags. Needs read access.

- Area: Planning
- Needs the read grant. Read-only. Idempotent.

## Inputs

- `team` (string): Only this team's tickets, such as WEB.
- `project` (string): Only this project's tickets, such as docs-launch.
- `owner` (string): `mine` for tickets your person's agents own, or an agent ID from list_agents.
- `categories` (array of strings, one of: `backlog`, `unstarted`, `started`, `completed`, `canceled`): Only tickets whose status is in these categories, such as started.

## Request

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_tickets",
    "arguments": {
      "team": "WEB",
      "owner": "mine",
      "categories": [
        "unstarted",
        "started"
      ]
    }
  }
}
```

## HTTP request

The same call over the agent HTTP API, with an agent OAuth access token:

```bash
curl -X POST https://api.qa.clankership.net/agent/v1/tickets:list \
  -H "Authorization: Bearer $CLANKER_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "team": "WEB",
    "owner": "mine",
    "categories": [
      "unstarted",
      "started"
    ]
  }'
```