The REST Admin API is a legacy API as of October 1, 2024. All apps and integrations should be built with the GraphQL Admin API. For details and migration steps, visit our migration guide.
Requires
orders
access scope.
Requires access to protected customer data.
You can use the Abandoned checkouts resource to retrieve a list and a count of abandoned checkouts. A checkout is considered abandoned after the customer has added contact information, but before the customer has completed their purchase.
This resource may be helpful to complete the following actions:
- Gather marketing information on customers who have abandoned their cart.
- Use information to remarket to abandoned checkout customers.
- Understand customers’ behavior.
- Track abandoned checkouts over time.
- View abandoned checkout items.
Was this section helpful?
Properties
abandoned_checkout_url
The recovery URL that's sent to a customer so they can recover their checkout.
The mailing address associated with the payment method. It has the following properties:
buyer_accepts_marketing
Whether the customer would like to receive email updates from the shop. This is set by the I want to receive occasional emails about new products, promotions and other news checkbox during checkout.
buyer_accepts_sms_marketing
Whether the customer would like to receive SMS updates from the shop. This is set by the Text me with news and offers checkbox during checkout.
cart_token
deprecated
The ID for the cart that's attached to the checkout.
closed_at
deprecated
The date and time (ISO 8601 format) when the checkout was closed. If the checkout was not closed, then this value is
null
.completed_at
The date and time (ISO 8601 format) when the checkout was completed. For abandoned checkouts, this value is
null
until a customer completes the checkout using the recovery URL.created_at
The date and time (ISO 8601 format) when the checkout was created.
currency
deprecated
The three-letter code (ISO 4217 format) of the shop's default currency at the time of checkout. For the currency that the customer used at checkout, see
presentment_currency
.The customer details associated with the abandoned checkout. For more information, refer to the Customer resource.
customer_locale
->locale
The two or three-letter language code, optionally followed by a region modifier.
Example values:
en
, en-CA
.device_id
deprecated
The ID of the Shopify POS device that created the checkout. This field is deprecated.
Was this section helpful?
Retrieves a count of checkouts from the past 90 days
api_version
string
required
created_at_max
Count checkouts created before the specified date. (format: 2014-04-25T16:15:47-04:00)
created_at_min
Count checkouts created after the specified date. (format: 2014-04-25T16:15:47-04:00)
since_id
Restrict results to after the specified ID.
status
default open
Count checkouts with a given status.
updated_at_max
Count checkouts last updated before the specified date. (format: 2014-04-25T16:15:47-04:00)
updated_at_min
Count checkouts last updated after the specified date. (format: 2014-04-25T16:15:47-04:00)
Was this section helpful?
Query parameters
Count checkouts created before the specified date. (format: 2014-04-25T16:15:47-04:00)
Was this section helpful?
Retrieves a list of abandoned checkouts.
api_version
string
required
created_at_max
Show checkouts created before the specified date. (format: 2014-04-25T16:15:47-04:00)
created_at_min
Show checkouts created after the specified date. (format: 2014-04-25T16:15:47-04:00)
limit
≤ 250
default 50
The maximum number of results to show.
since_id
Restrict results to after the specified ID.
status
default open
Show only checkouts with a given status.
updated_at_max
Show checkouts last updated before the specified date. (format: 2014-04-25T16:15:47-04:00)
updated_at_min
Show checkouts last updated after the specified date. (format: 2014-04-25T16:15:47-04:00)
Was this section helpful?
Query parameters
≤ 250
default 50
The maximum number of results to show.
Was this section helpful?