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

502 Bad Gateway

The ecommerce service could not answer.

Operational notes

  • An abandoned cart has abandoned_at set and completed_at absent. A cart that was completed keeps completed_at and is no longer worth recovering, whatever its recovery_status says.
  • recovery_url is the whole point. It drops the customer back into checkout with the cart intact. Pairing it with a cta_url message is the intended recovery flow.
  • customer_id is the contact id, the same one GET /v1/contacts returns — 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

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
source
string

Origen del carrito

integration_id
string

ObjectId de la integración de origen

recovery_status
string

Estado de recuperación del carrito abandonado

Response

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