# Get all product swaps for a shop

Retrieves all configured product swap automations for the authenticated shop. Product swaps allow automatic replacement of products in subscription orders based on billing cycles or recurring schedules.

What are Product Swaps?
Product swaps enable merchants to automatically replace products in subscription orders at specific billing cycles. This is useful for seasonal products, progression paths (e.g., beginner → intermediate → advanced), or variety subscriptions.

Key Features:
- View all configured swap automations
- See source and destination product mappings
- Check which billing cycles trigger swaps
- Identify recurring vs one-time swaps
- Review discount carry-forward settings

Swap Configuration Types:
- One-Time Swap: Occurs at a specific billing cycle
- Recurring Swap: Occurs at every order
- Conditional Swap: Based on billing cycle number

Use Cases:
- Seasonal product rotations (summer → fall → winter products)
- Subscription progression (trial → full product)
- Variety boxes with automatic product rotation
- Product lifecycle management in subscriptions
- A/B testing different products in subscriptions

Authentication: Requires valid X-API-Key header

Endpoint: GET /api/external/v2/product-swaps
Version: 0.0.1

## Header parameters:

  - `X-API-Key` (string)

## Query parameters:

  - `ruleName` (string)

  - `sourceVariants` (string)

  - `destinationVariants` (string)

## Response 200 fields (application/json):

  - `id` (integer)

  - `shop` (string, required)

  - `sourceVariants` (string)

  - `destinationVariants` (string)

  - `updatedFirstOrder` (boolean)

  - `checkForEveryRecurringOrder` (boolean)

  - `name` (string)

  - `changeNextOrderDateBy` (integer)

  - `forBillingCycle` (integer)

  - `carryDiscountForward` (boolean)

  - `ruleSequence` (integer)

  - `stopSwapEmails` (boolean)

  - `discountCarryForward` (string)
    Enum: "NONE", "EXISTING_PLAN", "PRODUCT_PLAN", "PRODUCT_THEN_EXISTING"


## Response 401 fields

## Response 403 fields