Listar productos del catálogo
Products
GET /v1/ecommerce/products
List the product catalog, with full-text search and filters by origin and category.
GET
Listar productos del catálogo
Returns a paginated list of products sorted by name. Covers both products created in the Keebai portal and those synced from an integration.
Results cover the whole company, not just the project your token belongs to.
Endpoint
Required scope
ecommerce:products:read
Headers
Query parameters
Example request
Response
200 OK
400 Bad Request
limit above 200, negative offset, or an unknown query parameter.
401 Unauthorized
Missing, invalid, revoked, or expired token.403 Forbidden
The token does not have theecommerce:products:read scope.
502 Bad Gateway
The ecommerce service could not answer.Operational notes
- Prices are integers in the currency’s minor unit.
5990000with"currency": "CLP"is $59,900 — Chilean pesos have no decimals, so the value is already whole pesos scaled by the platform’s factor. Readcurrencybefore formatting, and never hardcode two decimals. stockonly means something whenstock_managedistrue. On products synced from an integration it reflects the last sync, not a live read of the platform.offsetis rounded down to a page boundary. The catalog paginates by page upstream, so keepoffseta multiple oflimit; the usualoffset += limitloop is always correct.- Inactive products are included. Filter on
is_activeyourself if you only want what is sellable.
Authorizations
Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.
Query Parameters
Required range:
1 <= x <= 200Required range:
x >= 0Búsqueda full-text sobre el catálogo
Origen del producto: interno o el de una integración
ObjectId de la categoría