Products
Search the products
Searches the active products by name or code and returns at most 20 of them, for autocomplete.
- Deprecated — withdrawn, not moved: its replacement is GET /v1/companies/{company_id}/products?q=, which searches the name, the code and the description, so it returns at least everything this endpoint returned.
- Response shape: it differs, and that is why this notice exists. Here data is a plain array of products, limited to 20 active ones, while there data is the paginated envelope of the list (data.products + data.pagination). Change the way you read the response when you migrate.
Retires on 9 December 2026. See the migration guide for what moved where and what changes when you switch.
get/v1/products/search
Request
- Base URL: https://app.beel.es/api
- URL: https://app.beel.es/api/v1/products/search
- Auth: HTTP bearer
Query parameters
searchstring
Search term (empty to get recent products).
This parameter was previously named q. The old name is still accepted for backwards compatibility (see q below) and will be withdrawn in a future major version — send search.
qstring
Deprecated — former name of search, still honoured so existing integrations keep working. Ignored when search is also present. Use search.
limitinteger
Result limit (max 20)
Response
Search results retrieved successfully
Example response
{
"success": true,
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"code": "SERV-001",
"name": "Technical consulting",
"description": "Specialized technical consulting services in web development",
"category": "CONSULTING",
"default_price": 85.5,
"unit": "hours",
"main_tax": {
"type": "IVA",
"percentage": 21,
"regime_key": "01"
},
"equivalence_surcharge_rate": 5.2,
"irpf_rate": 15,
"active": true,
"created_at": "2025-01-18T10:30:00Z",
"updated_at": "2025-01-18T15:45:30Z"
}
],
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}Changes
No recorded changes to this operation across all 1 revision of this API.