Skip to main content
GET
This endpoint returns a paginated list of carts. You can filter by customer, status, date range, and more. Useful for abandoned cart recovery and analytics.

Authentication

This endpoint requires a valid API key with carts:read permissions.

Query Parameters

integer
default:"10"
Number of carts to return (1-100)
integer
default:"0"
Number of carts to skip
string
Filter by customer ID
string
Filter by session ID
string
Filter by status: “active”, “abandoned”, “converted”, “expired”
string
Filter by channel: “web”, “mobile”, “pos”, “api”
string
Filter carts created after date (ISO 8601)
string
Filter carts created before date (ISO 8601)
string
Filter carts updated after date (ISO 8601)
boolean
Filter carts with email addresses (for recovery)
integer
Minimum cart value in cents
string
default:"updated_at"
Sort by field: “created_at”, “updated_at”, “total”, “abandoned_at”
string
default:"desc"
Sort order: “asc” or “desc”

Response

Returns a paginated list of cart objects.