beel_list_products
Retrieves a paginated list of a company's products and services, with optional search and filters by name, code, category, status, and price.
Instructions
Returns a paginated list of the products/services of this company, with optional filters.
q: searching is done on this collection, there is no separate search path.qmatches the name, the code and the description, so it returns at least everything the withdrawnGET /v1/products/searchreturned, in the paginated envelope of this list.
BeeL API endpoint: GET /v1/companies/{company_id}/products (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": {
"company_id": "<company_id>"
},
"name": "beel_list_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search by name, code or description | |
| code | No | Filter by code (partial search) | |
| name | No | Filter by name (partial search case-insensitive) | |
| 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`. | |
| active | No | Filter by active/inactive status | |
| sort_by | No | Field to sort by | name |
| category | No | Filter by product category | |
| max_price | No | Maximum price | |
| min_price | No | Minimum price | |
| 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. | |
| sort_order | No | Sort order direction | asc |