Listar carritos
Carts
GET /v1/ecommerce/carts
List carts, including abandoned ones, filtered by origin and recovery status.
GET
Listar carritos
Returns a paginated list of carts. This is where abandoned-cart recovery starts: filter by
recovery_status=pending to find the ones nobody has followed up on yet.
Results cover the whole company, not just the project your token belongs to.
Endpoint
Required scope
ecommerce:carts: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:carts:read scope.
502 Bad Gateway
The ecommerce service could not answer.Operational notes
- An abandoned cart has
abandoned_atset andcompleted_atabsent. A cart that was completed keepscompleted_atand is no longer worth recovering, whatever itsrecovery_statussays. recovery_urlis the whole point. It drops the customer back into checkout with the cart intact. Pairing it with acta_urlmessage is the intended recovery flow.customer_idis the contact id, the same oneGET /v1/contactsreturns — but only when Keebai could match the shopper to a known contact. On anonymous carts it is absent and you only have the email or phone the customer typed.- Marking a cart as contacted is not exposed here. This surface is read-only; the status changes from the portal or from the recovery automation.
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 >= 0Origen del carrito
ObjectId de la integración de origen
Estado de recuperación del carrito abandonado