# Lemon Squeezy

Lemon Squeezy is a platform designed to simplify payments, taxes, and subscriptions for software companies, offering a powerful API and webhooks for seamless integration.

- **Category:** ecommerce
- **Auth:** API_KEY
- **Tools:** 18
- **Triggers:** 0
- **Slug:** `LEMON_SQUEEZY`
- **Version:** 20260211_00

## Tools

### Create Customer

**Slug:** `LEMON_SQUEEZY_CREATE_CUSTOMER`

Tool to create a new customer. Use after verifying the store exists and you need to add a customer to it. Example: "Create a customer John Doe with email johndoe@example.com in store 1."

### List All Affiliates

**Slug:** `LEMON_SQUEEZY_LIST_ALL_AFFILIATES`

Tool to list all affiliates. Use when you need to retrieve affiliates with optional filters and pagination.

### List All Checkouts

**Slug:** `LEMON_SQUEEZY_LIST_ALL_CHECKOUTS`

Tool to list all checkouts. Use when you need a paginated list of checkouts, optionally filtering by store or variant.

### List All Customers

**Slug:** `LEMON_SQUEEZY_LIST_ALL_CUSTOMERS`

Retrieves a paginated list of all customers from your Lemon Squeezy store(s). Returns customer details including email, name, location, revenue metrics (MRR, total revenue), marketing status, and relationships to orders, subscriptions, and license keys. Use this action to: - Get all customers across stores or filter by specific store_id - Find a customer by email address - List customers with pagination support (default 10 per page, max 100) - Access customer portal URLs and relationship links All parameters are optional. Without filters, returns all customers ordered by creation date (newest first).

### List All Discount Redemptions

**Slug:** `LEMON_SQUEEZY_LIST_ALL_DISCOUNT_REDEMPTIONS`

Tool to list all discount redemptions. Use when you need a paginated list of discount redemptions, optionally filtering by discount or order.

### List All Discounts

**Slug:** `LEMON_SQUEEZY_LIST_ALL_DISCOUNTS`

Tool to list all discounts. Use when you need a paginated list of discounts after confirming authentication.

### List All License Key Instances

**Slug:** `LEMON_SQUEEZY_LIST_ALL_LICENSE_KEY_INSTANCES`

Tool to list all license key instances. Use when you need a paginated list of license key instances, optionally filtering by license key ID.

### List All Order Items

**Slug:** `LEMON_SQUEEZY_LIST_ALL_ORDER_ITEMS`

Tool to list all order items. Use when you need a paginated list of order items, optionally filtered by order, product, or variant.

### List All Orders

**Slug:** `LEMON_SQUEEZY_LIST_ALL_ORDERS`

Tool to list all orders. Use when you need a paginated list of orders, optionally filtering by store or user email.

### List All Prices

**Slug:** `LEMON_SQUEEZY_LIST_ALL_PRICES`

Tool to list all prices. Use when you need a paginated list of all prices, optionally filtering by variant.

### List All Products

**Slug:** `LEMON_SQUEEZY_LIST_ALL_PRODUCTS`

List all products from your Lemon Squeezy store with pagination and filtering. Returns a paginated list of products ordered by name. Each product includes pricing, status, thumbnails, checkout URLs, and metadata. Useful for browsing your product catalog, checking product details, or filtering by store.

### List All Stores

**Slug:** `LEMON_SQUEEZY_LIST_ALL_STORES`

Retrieves a paginated list of all stores belonging to the authenticated Lemon Squeezy account. This action returns comprehensive store information including store details (name, slug, domain, URL), financial metrics (total sales/revenue, 30-day sales/revenue), configuration (plan, country, currency), and relationship links to associated resources (products, orders, subscriptions, discounts, license keys, webhooks, and affiliates). Returns stores ordered by name in ascending order with pagination metadata. No input parameters required. Use this as a starting point to discover available stores before working with other store-specific resources.

### List All Subscription Invoices

**Slug:** `LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTION_INVOICES`

Tool to list all subscription invoices. Use when you need a paginated list of subscription invoices with optional filters.

### List All Subscription Items

**Slug:** `LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTION_ITEMS`

Tool to list all subscription items. Use when you need a paginated list of items across subscriptions for reporting or auditing.

### List All Subscriptions

**Slug:** `LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTIONS`

Tool to list all subscriptions. Use when you need a paginated list of subscriptions, optionally filtered by store, order, product, or status.

### List All Usage Records

**Slug:** `LEMON_SQUEEZY_LIST_ALL_USAGE_RECORDS`

Retrieves all usage records from Lemon Squeezy, with optional filtering and pagination. Usage records track consumption for usage-based billing on subscription items. Each record represents reported usage with a quantity and action type (increment or set). Records are returned in descending order by creation date (newest first). Use this when you need to: - View all usage records across subscription items - Filter usage records for a specific subscription item - Paginate through large sets of usage records Note: Returns an empty list if no usage records exist or the filter matches nothing.

### List All Variants

**Slug:** `LEMON_SQUEEZY_LIST_ALL_VARIANTS`

Retrieves a paginated list of product variants from Lemon Squeezy. A variant represents a variation of a product with its own pricing options, files, and license key settings. You can filter by product ID and status (pending/draft/published), and control pagination with page number and size.

### List All Webhooks

**Slug:** `LEMON_SQUEEZY_LIST_ALL_WEBHOOKS`

Tool to list all webhooks. Use when you need to retrieve registered webhooks. Supports optional filtering by store ID and pagination parameters for controlling result size and navigation.
