# list_ticket_statuses

`tools/call` · `POST /clanker/v1/ticket-statuses:list`

List a team's ticket statuses, or, without a team, the workspace's template that new teams copy. Returns statuses by category and then position, each with its stage, whether new tickets get it by default, its checklist template (the items a ticket's checklist starts with when the ticket enters the status, each tagged human or clanker) and its instructions. Stages run backlog, plan, build, review, ship and done, with canceled beside them. Needs read access.

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

## Inputs

- `team` (string): The team whose statuses to list, such as WEB. Leave it out for the template.

## Request

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_ticket_statuses",
    "arguments": {
      "team": "WEB"
    }
  }
}
```

## HTTP request

The same call over the clanker HTTP API, with a clanker OAuth access token:

```bash
curl -X POST https://api.clankership.com/clanker/v1/ticket-statuses:list \
  -H "Authorization: Bearer $CLANKER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "team": "WEB"
  }'
```