Products
List products/services from catalog
Returns a paginated list of products/services with optional filters
AuthorizationBearer <token>
API Key authentication.
Format: Authorization: Bearer beel_sk_<key>
Obtaining Keys: API Keys are managed from the BeeL dashboard
Security: API Keys are secret credentials. Do not share them or store them in source code
In: header
Query Parameters
page?integer
Page number (starts at 1)
Default
1Range
1 <= valuelimit?integer
Number of items per page
Default
20Range
1 <= value <= 100category?string
Filter by product category
Value in
"PRODUCT" | "SERVICE" | "CONSULTING" | "SOFTWARE" | "TRAINING" | "OTHER"active?boolean
Filter by active/inactive status
search?string
Global search by name, code or description
Length
length <= 100name?string
Filter by name (partial search case-insensitive)
code?string
Filter by code (partial search)
min_price?number
Minimum price
Range
0 <= valuemax_price?number
Maximum price
Range
0 <= valuesort_by?string
Field to sort by
Default
"name"Value in
"name" | "code" | "category" | "default_price" | "created_at"sort_order?string
Sort order direction
Default
"asc"Value in
"asc" | "desc"Response Body
application/json
application/json
application/json
curl -X GET "https://app.beel.es/api/v1/products"{
"success": true,
"data": {
"products": [
{
"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": 5.2,
"irpf": 15,
"active": true,
"created_at": "2025-01-18T10:30:00Z",
"updated_at": "2025-01-18T15:45:30Z"
}
],
"pagination": {
"current_page": 1,
"total_pages": 5,
"total_items": 87,
"items_per_page": 20,
"has_next": true,
"has_previous": true
}
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}{
"success": false,
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}