Skip to main content
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 the ecommerce:products:read scope.

502 Bad Gateway

The ecommerce service could not answer.

Operational notes

  • Prices are integers in the currency’s minor unit. 5990000 with "currency": "CLP" is $59,900 — Chilean pesos have no decimals, so the value is already whole pesos scaled by the platform’s factor. Read currency before formatting, and never hardcode two decimals.
  • stock only means something when stock_managed is true. On products synced from an integration it reflects the last sync, not a live read of the platform.
  • offset is rounded down to a page boundary. The catalog paginates by page upstream, so keep offset a multiple of limit; the usual offset += limit loop is always correct.
  • Inactive products are included. Filter on is_active yourself if you only want what is sellable.

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Query Parameters

limit
number
default:50
Required range: 1 <= x <= 200
offset
number
default:0
Required range: x >= 0

Búsqueda full-text sobre el catálogo

type
string

Origen del producto: interno o el de una integración

category
string

ObjectId de la categoría

Response

200 - application/json
total
number
required
limit
number
required
offset
number
required
data
object[]
required