beel_list_companies
Lists the companies (NIFs) belonging to an account, with the primary company first. Supports case-insensitive search, pagination, and optional issuing-readiness data.
Instructions
Returns the companies (NIFs) belonging to the account in the path, ordered with the primary company first. An account with no companies yet returns an empty list rather than an error.
search: filters case-insensitively on NIF, legal name and trade name.include=readiness: adds each company's issuing-readiness block.Paginated, always: without
pageandlimityou get the first 20 companies, not all of them, andpaginationis present in every response — a single-company account simply gets a one-item page.Series: not part of this response. Read them from
GET /v1/companies/{company_id}/series.
BeeL API endpoint: GET /v1/accounts/{account_id}/companies (reference: https://docs.beel.es)
⚠️ Read before calling:
Which company an operation acts on, and how that is selected. (resource: beel://guardrails/multi-nif)
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_companies"
}
}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. Blank/omitted returns all. | |
| include | No | Include derived data. `readiness` adds each company's issuing-readiness status. | |
| 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. |