beel_get_recurring_invoice_history
Retrieve all entries in a recurring invoice schedule's history: generated invoices plus skipped, failed, or paused periods to explain missing invoices. Paginate results, newest first.
Instructions
Returns every entry in this schedule's history, newest first: the invoices it generated
and, just as important, the periods it did not — a failed unattended run, a slot a user
skipped, or the schedule being paused. Each entry carries its type, the origin of who
asked for it, a translated reason when there is one, and requested_by for a skip. That is
what lets you answer "why is there no invoice for March?" without reading logs.
Only GENERATED entries have an invoice_id; for the rest it is null.
Paginated with the usual page/limit, and the usual defaults: without them you get
the 20 most recent entries, not the whole history — which grows with every cycle the
template runs. Read data.pagination to walk the rest.
The deprecated flat alias GET /v1/recurring-invoices/{recurring_invoice_id}/history does
not paginate and returns only generated invoices: it is frozen as it shipped until
its Sunset date. Only this route returns every entry type.
BeeL API endpoint: GET /v1/companies/{company_id}/recurring-invoices/{recurring_invoice_id}/history (reference: https://docs.beel.es)
⚠️ Read before calling:
Fiscal rules, domains simplified, taxes: beel_rules_list with domain, or resource beel://guardrails/.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"company_id": "<company_id>",
"recurring_invoice_id": "<recurring_invoice_id>"
},
"name": "beel_get_recurring_invoice_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, starting at 1. The response echoes it back as `pagination.current_page`. | |
| limit | No | How many items to return per page. The response echoes it back as `pagination.items_per_page`. | |
| company_id | Yes | Unique identifier (UUID) of the company the operation acts on — its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. | |
| recurring_invoice_id | Yes | Unique identifier (UUID) of the recurring invoice template, as returned when it is created or listed. A template of another company answers `404` with `RECURRING_NOT_FOUND`, exactly like one that does not exist. |