# tags.list

List project tags (which event or program a transaction is for): name, group (parent_id, one level deep), color, description, other names, event window (starts_on, ends_on), budget, archived state, the caller's last_used_at, and for finance spend, income, net and transaction counts by currency. A group's rollup counts each transaction once. Pass includeArchived to include archived tags. Contributors see active tags without totals or budgets.

`GET | POST /api/v1/accounting/tags.list`

Permissions: `accounting:read` · Roles: admin, finance, contributor

MCP tool: `accounting_tags_list`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `includeArchived` | boolean |  | Also include archived records. |

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/tags.list \
  -H "Authorization: Bearer $OATMILK_API_KEY"
```

Reference page: https://app.getoatmilk.com/docs/api/tags.list