beel_list_stats
Retrieve per-company invoice counts and last issuance dates for an account, with pagination and search to align results with the companies list.
Instructions
Returns, for each company of the account, how many fiscal documents it has
issued and when it last issued one. What counts is described on invoice_count and
last_invoice_at in the response.
Paginated with the usual page/limit, and the usual defaults: without them you get
the stats of the first 20 companies, not of all of them. One row per company, over the same
universe and in the same order as GET /v1/accounts/{account_id}/companies — search
included — so asking both with the same page, limit and search lines the two
responses up company by company.
BeeL API endpoint: GET /v1/accounts/{account_id}/companies/stats (reference: https://docs.beel.es)
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": {
"account_id": "<account_id>"
},
"name": "beel_list_stats"
}
}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`. | |
| search | No | Case-insensitive filter on NIF, legal name or trade name — the same filter, over the same universe, as the one `GET /v1/accounts/{account_id}/companies` applies. Blank or omitted returns all. | |
| account_id | Yes | Your own account, or an account you provisioned. It — not the credential — decides which account the operation acts on; a `403` is returned when you do not reach it, the same response an account that does not exist gets. |