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

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

Response

Returns a paginated list of cart objects.