# List and filter selling plans

## GET /preorders

> List and filter selling plans

```json
{"openapi":"3.0.3","info":{"title":"Preorders API","version":"1.0.0"},"servers":[{"url":"https://app.stoqapp.com/api/v1/external","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Auth-Token"}},"schemas":{"SellingPlanList":{"type":"object","description":"Simplified selling plan object for list views","properties":{"id":{"type":"string","description":"Unique identifier for the selling plan"},"name":{"type":"string","description":"Display name of the selling plan"},"internal_name":{"type":"string","description":"Internal name for the selling plan"},"enabled":{"type":"boolean","description":"Whether the selling plan is enabled"},"selling_plan_product_variants_count":{"type":"integer","description":"Number of product variants associated with this selling plan"},"created_at":{"type":"string","format":"date-time","description":"Timestamp when the selling plan was created"},"updated_at":{"type":"string","format":"date-time","description":"Timestamp when the selling plan was last updated"},"shopify_variant_ids":{"type":"array","items":{"type":"integer"},"description":"List of Shopify variant IDs associated with this selling plan"}}}}},"paths":{"/preorders":{"get":{"summary":"List and filter selling plans","tags":["Preorders"],"parameters":[{"in":"header","name":"X-Auth-Token","required":true,"schema":{"type":"string"},"description":"API key for authentication"},{"in":"query","name":"name","schema":{"type":"string"},"description":"Filter by selling plan name or internal name"},{"in":"query","name":"page","schema":{"type":"integer"},"description":"Page number for pagination"},{"in":"query","name":"per_page","schema":{"type":"integer"},"description":"Number of items per page"}],"responses":{"200":{"description":"A paginated list of selling plans","content":{"application/json":{"schema":{"type":"object","properties":{"selling_plans":{"type":"array","items":{"$ref":"#/components/schemas/SellingPlanList"}},"meta":{"type":"object","properties":{"total_count":{"type":"integer"},"page":{"type":"integer"},"per_page":{"type":"integer"},"total_pages":{"type":"integer"}}}}}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stoqapp.com/preorders-api/list-and-filter-selling-plans.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.