List Carts
List all carts with filtering and pagination options
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 withcarts: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”