# invoices.groups.get

Read a billing group's planned allocation, linked invoices, actual invoiced and draft totals, credits, written off amounts, and each payer's balance and invoice status. Voids do not count as revenue. Group totals are views of invoices, never extra revenue.

`GET | POST /api/v1/accounting/invoices.groups.get`

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

MCP tool: `accounting_invoices_groups_get`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `id` | string (ID) | Yes | The record's ID. |

## Example request

```bash
curl -G https://app.getoatmilk.com/api/v1/accounting/invoices.groups.get \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'id=9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d'
```

Reference page: https://app.getoatmilk.com/docs/api/invoices.groups.get