BizKitHub
DocsAPI ReferenceCart/bff/cart/list
getCartAdmin BFF

/bff/cart/list

Returns a paginated list of carts for the authenticated organisation, sorted by updated_date descending. Each row includes a precomputed item count and a total price (in cart currency). Filters cover full-text search, empty / non-empty carts, anonymous vs identified, and a date range on updated_date.

CartgetBffCartList

Parameters

7 query

Query parameters

· 7
pagestringOptional

Page number (1-based) for pagination.

Example1
limitstringOptional

Max items per page (1–500, default 50).

Example50
filterFulltextQuerystringOptional

Free-text search across cart identifier and customer email / first / last name.

Examplejan@example.com
hasItemsstringOptional

"true" = only carts with at least one item, "false" = only empty carts.

Exampletrue
hasCustomerstringOptional

"true" = only carts linked to a contact, "false" = only anonymous carts.

Exampletrue
updatedFromstringOptional

Inclusive lower bound on updated_date (ISO date or datetime).

Exampleexample_updatedFrom
updatedTostringOptional

Inclusive upper bound on updated_date (ISO date or datetime).

Exampleexample_updatedTo

Response schema

1 status code documented

200Success

This response returns no JSON body.

Response example

application/json
{
  "success": true
}

Request example

GET /bff/cart/list

get
curl -X GET "https://api.bizkithub.com/bff/cart/list?page=1&limit=50&filterFulltextQuery=jan%40example.com&hasItems=true&hasCustomer=true&updatedFrom=example_updatedFrom&updatedTo=example_updatedTo" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key