list_recent_invoices
Retrieve invoice metadata from the last thirty days per subject type. Read-only and argument-free, it lists up to 50 invoices individually or summarizes counts and totals for larger volumes.
Instructions
List the invoice metadata of the last thirty days, per subject type.
Takes no arguments, for the same reason synchronise_invoices takes none:
a window driven by the caller spends a twenty-per-hour metadata allowance in
minutes, and the Ministry reads that pattern as working around a limit. The
window ends on the hour, so asking again within the same hour is answered
from disk and costs nothing.
Reads only. There is no confirmation to click: a gate on a read teaches the person to approve without looking, and spends the gate that a write needs.
At most fifty invoices are listed individually. Above that the rows are
dropped and the answer carries the count and the gross total per currency
instead — and message says so in as many words. An empty window is its own
answer, restating the NIP, the environment, the subject type and both ends
of the period, so "nothing arrived" can be told from "wrong question".
Metadata only. An FA(2)/FA(3) body holds a counterparty's personal data and is third-party input; it never enters this answer.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nip | Yes | ||
| message | Yes | ||
| warnings | No | ||
| period_to | Yes | ||
| threshold | Yes | ||
| environment | Yes | ||
| period_from | Yes | ||
| subject_roles | Yes |