Products

List the products

Returns a paginated list of products and services, with optional filters.

  • Deprecated: use GET /v1/companies/{company_id}/products, which returns the same list. The free-text filter is named q there, not search.

Retires on 9 December 2026. See the migration guide for what moved where and what changes when you switch.

get/v1/products

Request

  • Base URL: https://app.beel.es/api
  • URL: https://app.beel.es/api/v1/products
  • Auth: HTTP bearer

Query parameters

pageinteger

Page number, starting at 1. The response echoes it back as pagination.current_page.

limitinteger

How many items to return per page. The response echoes it back as pagination.items_per_page.

category'PRODUCT' | 'SERVICE' | 'CONSULTING' | 'SOFTWARE' | 'TRAINING' | 'OTHER'

Product/service category:

  • PRODUCT - Physical, tangible products
  • SERVICE - General services
  • CONSULTING - Consulting and advisory services
  • SOFTWARE - Development, licenses, SaaS
  • TRAINING - Courses, workshops, training
  • OTHER - Other unclassified types
Example:CONSULTING

Filter by product category

activeboolean

Filter by active/inactive status

searchstring

Global search by name, code or description

namestring

Filter by name (partial search case-insensitive)

codestring

Filter by code (partial search)

min_pricenumber

Minimum price

max_pricenumber

Maximum price

sort_by'name' | 'code' | 'category' | 'default_price' | 'created_at'

Product field the list is ordered by.

  • name: product name.
  • code: product code.
  • category: product category.
  • default_price: default unit price.
  • created_at: creation instant.
Example:name

Field to sort by

sort_order'asc' | 'desc'

Sort direction. Shared vocabulary for every sort_order query param: declared once so the generator emits a real enum and an unknown direction is rejected with 400 instead of being silently ignored.

Example:desc

Sort order direction

Response

Product list retrieved successfully

successboolean required

Example response

{
  "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_rate": 5.2,
        "irpf_rate": 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
    }
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.