---
title: "List contactable checkout intents"
method: GET
path: "/v3/checkout-intents"
tags: ["Checkout Intents"]
---

# List contactable checkout intents

`GET /v3/checkout-intents`

## Request

- Base URL: `https://api.scalev.com`
- URL: `https://api.scalev.com/v3/checkout-intents`
- Auth: one of:
  - HTTP bearer
  - API key in header `authorization`
  - OAuth 2
    - Authorization code: `https://api.scalev.com/v3/oauth/authorize`
    - Token URL: `https://api.scalev.com/v3/oauth/token` scopes: `checkout_intent:list`

Requires the `checkout_intent:list` scope. Returns only intents with a valid normalized email or phone for the selected business. Use status=abandoned for recovery work. Active means activity within 15 minutes; abandoned means unfinished and idle at least 15 minutes; completed means an order was created. Resumed intents can become active again. Uses cursor pagination ordered by the selected timestamp and intent ID.

## Query parameters

- `status` 'active' | 'abandoned' | 'completed'
- `search` string
- `store_unique_id` string
- `page_unique_id` string
- `form_widget_id` string
- `started_at_from` string, date-time
- `started_at_until` string, date-time
- `sort_by` 'last_activity_at' | 'started_at' | 'completed_at'
- `sort_direction` 'asc' | 'desc'
- `page_size` integer
- `next_cursor` string
- `previous_cursor` string

## Response `200`

Contactable checkout intents.

- CheckoutIntentCollection
  - `data` CheckoutIntentSummary[], required
    - `id` string, uuid, required
    - `form_widget_id` string, required
    - `status` 'active' | 'abandoned' | 'completed', required
    - `contactable` boolean, required
    - `is_email_follow_up_already_sended` boolean, required
    - `customer` object, required
      - `name` string, nullable, required
      - `email` string, nullable, required
      - `phone` string, nullable, required
    - `store` object, nullable, required
      - `id` string, required
      - `unique_id` string, required
      - `name` string, required
    - `page` object, nullable, required: Null for store-scoped checkout intents.
      - `id` integer, required
      - `unique_id` string, required
      - `name` string, required
    - `cart_summary` object, required
      - `item_quantity` integer, required
      - `estimated_total` string, required
      - `currency` string, required
    - `handler` object, nullable, required
      - `id` integer
      - `email` string, nullable
      - `phone` string, nullable
      - `is_phone_verified` boolean
      - `fullname` string, nullable
      - `avatar` string, nullable
    - `source_url` string, nullable, required
    - `started_at` string, date-time, required
    - `last_activity_at` string, date-time, required
    - `follow_up_eligible_at` string, date-time, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `order` object, nullable, required
      - `id` string, uuid, required
      - `order_id` string, required
      - `secret_slug` string, required
  - `is_paginated` true, required
  - `has_next` boolean, required
  - `has_previous` boolean, required
  - `next_cursor` string, nullable, required
  - `previous_cursor` string, nullable, required
  - `page_size` integer, required

## Other responses

- `400`: Malformed request.
- `401`: Missing or invalid business API key or OAuth access token.
- `403`: Checkout intent is not included in the active business subscription, or authorization failed.
- `422`: Invalid checkout intent filters.
- `429`: Too Many Requests. Storefront public requests using `X-Scalev-Storefront-Api-Key` or `X-Scalev-Guest-Token` are rate-limited as direct client/browser requests. Machine-authenticated business requests are rate-limited per API key or OAuth installation. Rate-limit responses may be plain text instead of the normal JSON error shape.

## Changes

- **2026-09-16** `40f39d0fda73`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scalev/apis/nexus-commerce-api/changes/v3/checkout-intents/get.md)

---

[API](https://skmtc.dev/scalev/apis/nexus-commerce-api.md) - [All operations](https://skmtc.dev/scalev/apis/nexus-commerce-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scalev/apis/nexus-commerce-api/revisions/6b9152f04622?raw)