---
title: "List and filter selling plans"
description: "List the shop's preorder selling plans, newest first, with page-based pagination. Optionally filter by name (matches the display or internal name). Returns a lightweight representation of each plan plus pagination metada"
url: https://docs.stoqapp.com/v1/preorders/list-and-filter-selling-plans/
api: "API v1 (legacy)"
method: GET
path: "/external/preorders"
---

# List and filter selling plans

`GET https://app.stoqapp.com/api/v1/external/preorders`

List the shop's preorder selling plans, newest first, with page-based pagination. Optionally filter by `name` (matches the display or internal name). Returns a lightweight representation of each plan plus pagination metadata; use Get a Specific Selling Plan for the full object.

## Query parameters

- `name` (string): Filter by selling plan name or internal name
- `page` (integer): Page number for pagination
- `per_page` (integer): Number of items per page

## Headers

- `X-Auth-Token` (string, required): API key for authentication

## Returns

- `selling_plans` (array of objects)
  - `id` (string): Unique identifier for the selling plan
  - `name` (string): Display name of the selling plan
  - `internal_name` (string): Internal name for the selling plan
  - `enabled` (boolean): Whether the selling plan is enabled
  - `selling_plan_product_variants_count` (integer): Number of product variants associated with this selling plan
  - `created_at` (string): Timestamp when the selling plan was created
  - `updated_at` (string): Timestamp when the selling plan was last updated
  - `shopify_variant_ids` (array of integers): List of Shopify variant IDs associated with this selling plan
- `meta` (object)
  - `total_count` (integer): e.g. `3`
  - `page` (integer): e.g. `1`
  - `per_page` (integer): e.g. `25`
  - `total_pages` (integer): e.g. `1`

Rate limit: this call costs 1 point ([rate limits](https://docs.stoqapp.com/docs/rate-limits/)).

## Example request

```sh
curl "https://app.stoqapp.com/api/v1/external/preorders" \
  -H "X-Auth-Token: $STOQ_API_KEY"
```

## 200

A paginated list of selling plans

```json
{
  "selling_plans": [
    {
      "id": "79b44c6c-ebc7-41d4-8a1b-573d7c693454",
      "name": "Summer Preorder",
      "internal_name": "summer-2026",
      "enabled": true,
      "selling_plan_product_variants_count": 12,
      "created_at": "2026-06-20T10:00:00Z",
      "updated_at": "2026-06-24T08:30:00Z",
      "shopify_variant_ids": [
        43900910010503,
        43900910010999
      ]
    }
  ],
  "meta": {
    "total_count": 3,
    "page": 1,
    "per_page": 25,
    "total_pages": 1
  }
}
```

## 400

Bad request

## 401

Unauthorized