List invoices and credit notes

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

RReadIdempotentbetaNeeds account

Tool

manitu_account_financialdocument_liston https://mcp.manitu.de/mcp

POST

/v1/account/financialdocument/liston https://api.manitu.de

Try it

Annotations as tools/list sends them

readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

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

typestring

invoice or credit_note - as the list answers it.

One of invoice credit_note

due_unpaid_onlyboolean

Only invoices that are not paid and due. Default: all.

page_sizeinteger

How many entries per page, default 100.

min 1max 500

page_tokenstring

next_page_token of the previous page - with the same filters.

Result structuredContent, checked against the schema

financial_document_listarray of objectrequired

financial_document_list[].typestringrequired

An invoice, or a credit note (money manitu owes the customer).

One of invoice credit_note

financial_document_list[].subtypestring | nullrequired

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[].numberstringrequired

The number printed on it - what the customer quotes; together with type what manitu_account_financialdocument_get takes.

financial_document_list[].reasonstring | nullrequired

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_onstring | nullrequired

The date of the document.

Format date

financial_document_list[].due_onstring | nullrequired

When an invoice is due; null for a credit note.

Format date

financial_document_list[].currencystring | nullrequired

e.g. "EUR".

financial_document_list[].total_net_centinteger | nullrequired

The total without VAT, in cent - 10000 is 100.00.

financial_document_list[].total_vat_centinteger | nullrequired

The VAT, in cent.

financial_document_list[].total_gross_centinteger | nullrequired

The total including VAT, in cent.

financial_document_list[].payment_statusstring | nullrequired

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_centinteger | nullrequired

Paid so far, in cent - by the customer (invoice) or by manitu (credit note).

financial_document_list[].amount_due_centinteger | nullrequired

Still open, in cent: total_gross_cent minus amount_paid_cent.

financial_document_list[].is_unpaid_duebooleanrequired

An invoice not paid whose due date has come - what needs the customer's attention. Always false for a credit note.

total_countintegerrequired

How many entries match, on all pages together.

next_page_tokenstring | nullrequired

Pass as page_token for the next page; null on the last.

Authentication

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

Request body JSON; unknown fields are refused

typestring

invoice or credit_note - as the list answers it.

One of invoice credit_note

due_unpaid_onlyboolean

Only invoices that are not paid and due. Default: all.

page_sizeinteger

How many entries per page, default 100.

min 1max 500

page_tokenstring

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_listarray of objectrequired

financial_document_list[].typestringrequired

An invoice, or a credit note (money manitu owes the customer).

One of invoice credit_note

financial_document_list[].subtypestring | nullrequired

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[].numberstringrequired

The number printed on it - what the customer quotes; together with type what manitu_account_financialdocument_get takes.

financial_document_list[].reasonstring | nullrequired

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_onstring | nullrequired

The date of the document.

Format date

financial_document_list[].due_onstring | nullrequired

When an invoice is due; null for a credit note.

Format date

financial_document_list[].currencystring | nullrequired

e.g. "EUR".

financial_document_list[].total_net_centinteger | nullrequired

The total without VAT, in cent - 10000 is 100.00.

financial_document_list[].total_vat_centinteger | nullrequired

The VAT, in cent.

financial_document_list[].total_gross_centinteger | nullrequired

The total including VAT, in cent.

financial_document_list[].payment_statusstring | nullrequired

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_centinteger | nullrequired

Paid so far, in cent - by the customer (invoice) or by manitu (credit note).

financial_document_list[].amount_due_centinteger | nullrequired

Still open, in cent: total_gross_cent minus amount_paid_cent.

financial_document_list[].is_unpaid_duebooleanrequired

An invoice not paid whose due date has come - what needs the customer's attention. Always false for a credit note.

total_countintegerrequired

How many entries match, on all pages together.

next_page_tokenstring | nullrequired

Pass as page_token for the next page; null on the last.

Statuses

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

MCPtools/call

Request

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

Result

{
  "structuredContent": {
    "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"
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/account/financialdocument/list

Request

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

const response = await fetch('https://api.manitu.de/v1/account/financialdocument/list', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});
const answer = await response.json();

<?php

$curl = curl_init('https://api.manitu.de/v1/account/financialdocument/list');

curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: ' . getenv('API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => '{}',
    CURLOPT_RETURNTRANSFER => true,
]);

$answer = json_decode(curl_exec($curl), true);

import os

import requests

response = requests.request(
    "POST",
    "https://api.manitu.de/v1/account/financialdocument/list",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={},
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "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"
  }
}

List invoices and credit notes

Annotations as tools/list sends them

Description for the model

Arguments

Result structuredContent, checked against the schema

Authentication

Request body JSON; unknown fields are refused

Response in data; the rest of the body as on every call

Statuses

Response in `data`; the rest of the body as on every call