# tags.report

Profit and loss by project tag for optional from/to dates and currency: spend, income and transaction counts per tag and per group, the deduplicated tagged total, untagged transactions, and overlap (transactions tagged to more than one project, which count in each). Currencies stay separate.

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

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

MCP tool: `accounting_tags_report`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `from` | string |  | The first date to include, as YYYY-MM-DD. |
| `to` | string |  | The last date to include, as YYYY-MM-DD. |
| `currency` | string |  | Three-letter currency code, such as CAD or USD. |

## Example request

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

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