# 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"}}}}}}
```
