# List invoices and credit notes

> The account's invoices and credit notes, newest first - optionally one kind, or only unpaid invoices that are due.

- Effect: Read - Changes nothing.
- Idempotent: yes
- Stability: beta
- MCP tool: `manitu_account_financialdocument_list` on https://mcp.manitu.de/mcp
- REST: `POST https://api.manitu.de/v1/account/financialdocument/list`
- Needs: `account`
- Page: /reference/account/financialdocument/list/

## MCP tool

`manitu_account_financialdocument_list`

### Description for the model

Lists the invoices and credit notes of the manitu customer account this connection works in, newest first: type, number, date, due date, totals, currency, what is paid and what is still open. type narrows it to invoices or credit notes; due_unpaid_only answers "do I owe you anything?". Amounts are in cent (11900 is 119.00). For the lines of one, or its PDF or XRechnung XML, use manitu_account_financialdocument_get with its type and number. total_count says how many there are in all; page with page_token = next_page_token while it is not null. Documents this access may not see are not listed.

### Arguments

- `type` (string) - invoice or credit_note - as the list answers it. (one of `"invoice"`, `"credit_note"`)
- `due_unpaid_only` (boolean) - Only invoices that are not paid and due. Default: all.
- `page_size` (integer) - How many entries per page, default 100. (minimum `1`; maximum `500`)
- `page_token` (string) - next_page_token of the previous page - with the same filters.

### Example

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

## REST

`POST https://api.manitu.de/v1/account/financialdocument/list`

### Authentication

One of `X-API-Key`, `Authorization: Bearer …` - never more than one in a request.

### Request body

JSON; unknown fields are refused.

- `type` (string) - invoice or credit_note - as the list answers it. (one of `"invoice"`, `"credit_note"`)
- `due_unpaid_only` (boolean) - Only invoices that are not paid and due. Default: all.
- `page_size` (integer) - How many entries per page, default 100. (minimum `1`; maximum `500`)
- `page_token` (string) - next_page_token of the previous page - with the same filters.

### Response

In `data`; the rest of the body as on every call.

- `financial_document_list` (array of object, required)
  - `financial_document_list[].type` (string, required) - An invoice, or a credit note (money manitu owes the customer). (one of `"invoice"`, `"credit_note"`)
  - `financial_document_list[].subtype` (string | null, required) - invoice for an invoice; for a credit note credit (a credit note) or invoiceamendment (a corrected invoice). (one of `"invoice"`, `"credit"`, `"invoiceamendment"`, `null`)
  - `financial_document_list[].number` (string, required) - The number printed on it - what the customer quotes; together with type what manitu_account_financialdocument_get takes.
  - `financial_document_list[].reason` (string | null, required) - Why a credit note was issued; null for an invoice. (one of `"unknown"`, `"cancellation"`, `"manitu_goodwill"`, `"manitu_billingmistake"`, `"manitu_provision"`, `"encashment_provision"`, `"encashment_irrecoverable"`, `null`)
  - `financial_document_list[].issued_on` (string | null, required) - The date of the document. (format `date`)
  - `financial_document_list[].due_on` (string | null, required) - When an invoice is due; null for a credit note. (format `date`)
  - `financial_document_list[].currency` (string | null, required) - e.g. "EUR".
  - `financial_document_list[].total_net_cent` (integer | null, required) - The total without VAT, in cent - 10000 is 100.00.
  - `financial_document_list[].total_vat_cent` (integer | null, required) - The VAT, in cent.
  - `financial_document_list[].total_gross_cent` (integer | null, required) - The total including VAT, in cent.
  - `financial_document_list[].payment_status` (string | null, required) - Whether it is paid - by the customer (invoice) or paid out by manitu (credit note). (one of `"unpaid"`, `"paid"`, `null`)
  - `financial_document_list[].amount_paid_cent` (integer | null, required) - Paid so far, in cent - by the customer (invoice) or by manitu (credit note).
  - `financial_document_list[].amount_due_cent` (integer | null, required) - Still open, in cent: total_gross_cent minus amount_paid_cent.
  - `financial_document_list[].is_unpaid_due` (boolean, required) - An invoice not paid whose due date has come - what needs the customer's attention. Always false for a credit note.
- `total_count` (integer, required) - How many entries match, on all pages together.
- `next_page_token` (string | null, required) - Pass as page_token for the next page; null on the last.

### Statuses

- `200` Success.
- `400` The request does not match the declared input schema.
- `401` No credential was presented, or it was not recognised.
- `403` The credential is not permitted to use this operation.
- `500` The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.
- `503` The channel this operation forwards through is unavailable.

### Example

```sh
curl -X POST 'https://api.manitu.de/v1/account/financialdocument/list' \
  -H 'X-API-Key: $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{}'
```

## Example result

```json
{
  "financial_document_list": [
    {
      "type": "invoice",
      "subtype": "invoice",
      "number": "string",
      "reason": "unknown",
      "issued_on": "2026-10-23",
      "due_on": "2026-10-23",
      "currency": "string",
      "total_net_cent": 1190,
      "total_vat_cent": 1190,
      "total_gross_cent": 1190,
      "payment_status": "unpaid",
      "amount_paid_cent": 1190,
      "amount_due_cent": 1190,
      "is_unpaid_due": true
    }
  ],
  "total_count": 1,
  "next_page_token": "eyJwYWdlIjoyfQ"
}
```