> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fitsociety.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Invoices

> Reference for viewing and summarizing company invoices.

The `invoices` module provides tools to view client invoices, financial summaries, and transaction states.

| Key                  | Value         |
| :------------------- | :------------ |
| **Module Key**       | `invoices`    |
| **Sensitivity**      | `operational` |
| **Consent Required** | None          |

***

## Available Tools

### `list_invoices`

List invoices issued to clients.

* **Type:** Read-only
* **Important Input Fields:**
  * `clientId` (string, optional): Filter invoices for a specific client.
  * `status` (string, optional): Filter by payment status (e.g. `paid`, `open`, `overdue`).
  * `page` (integer, optional): Page number.
  * `limit` (integer, optional): Items per page.

### `get_invoice`

Retrieve detailed itemizations and status for an invoice.

* **Type:** Read-only
* **Important Input Fields:**
  * `invoiceId` (string, required): Unique identifier for the invoice.

### `summarize_invoices`

Summarize invoice totals and collections statuses over a date range.

* **Type:** Read-only
* **Important Input Fields:**
  * `dateFrom` (string, required): Start date range filter.
  * `dateTo` (string, required): End date range filter.

***

## Natural Language Examples

* *"List all overdue invoices in the last 30 days."*
* *"Retrieve details for invoice inv\_9921."*

***

## JSON-RPC Call Example (`summarize_invoices`)

```json theme={null}
{
  "jsonrpc": "2.0",
  "id": "inv-1",
  "method": "tools/call",
  "params": {
    "name": "summarize_invoices",
    "arguments": {
      "dateFrom": "2026-06-01",
      "dateTo": "2026-06-30"
    }
  }
}
```
