API ReferenceCarts
Carts List
Retrieve a list of all open carts.
Authorization
oauth2 carts:readAuthorizationBearer <token>
Generate an Access Token through Settings > API Access for single store access or use the Authorization Code flow with your partner App Client ID. Use required permission scopes for API endpoint access. Example Authorization: Bearer 123
In: header
Scope: carts:read
Query Parameters
product?array<integer>
date_created_from?string
YYYY-MM-DD
Format
datedate_created_to?string
YYYY-MM-DD
Format
dateabandoned?boolean
currency?string
Currency
funnels?array<string|null>
Funnels
utm_source?string
UTM Source
utm_campaign?string
UTM Campaign
utm_term?string
UTM Term
utm_content?string
UTM Content
affiliate?string
Affiliate
subaffiliate1?string
Sub-Affiliate 1
subaffiliate2?string
Sub-Affiliate 2
subaffiliate3?string
Sub-Affiliate 3
subaffiliate4?string
Sub-Affiliate 4
subaffiliate5?string
Sub-Affiliate 5
cursor?string
The pagination cursor value.
Header Parameters
X-29next-API-Version*"2024-04-01"
Default
"2024-04-01"Value in
- "2024-04-01"
Response Body
application/json
curl -X GET "https://example.com/carts/" \ -H "X-29next-API-Version: 2024-04-01"{ "next": "http://example.com", "previous": "http://example.com", "results": [ { "abandoned": true, "attribution": { "affiliate": "string", "agent": { "email": "user@example.com", "first_name": "string", "id": 0, "last_name": "string" }, "funnel": "string", "gclid": "string", "metadata": null, "subaffiliate1": "string", "subaffiliate2": "string", "subaffiliate3": "string", "subaffiliate4": "string", "subaffiliate5": "string", "utm_campaign": "string", "utm_content": "string", "utm_medium": "string", "utm_source": "string", "utm_term": "string" }, "checkout_url": "http://example.com", "currency": "string", "date_created": "2019-08-24T14:15:22Z", "id": 0, "metadata": null, "status": "string", "user": { "accepts_marketing": true, "email": "user@example.com", "first_name": "string", "id": 0, "ip": "string", "language": "string", "last_name": "string", "phone_number": "string", "user_agent": "string" } } ]}