API Changelog
Keep up to date with changes to our API.
June 11th, 2025
- Added payment_processor property to Subscription objects, allowing you to identify which payment provider processed the transaction.
January 21st, 2025
- New endpoints: We’ve just added new Affiliates endpoints so you can now query affiliates using the API.
- We added a new
affiliate_activatedwebhook event so you can now watch for affiliate activations and update your application accordingly.
September 10th, 2024
- Added
fraudulentOrder status to indicate that an order has been marked as fraudulent.
- Added
September 4th, 2024
- Added new Issue an Order refund endpoint.
- Added new Issue a Subscription Invoice refund endpoint.
- Deprecated
darkoption in thecheckout_optionsattribute when creating a new checkout. Use the new color options instead. - Added the following options to the
checkout_optionsattribute to allow overriding checkout styles when creating a new checkout:background_colorheadings_colorprimary_text_colorsecondary_text_colorlinks_colorborders_colorcheckbox_coloractive_state_colorbutton_colorbutton_text_colorterms_privacy_color
August 7th, 2024
- Added
refunded_amount,refunded_amount_usdandrefunded_amount_formattedparameters to Order objects and Subscription invoice objects - The
refundedproperty of Order objects now only - The
refundedproperty of Subscription invoice objects now only reflects whether the invoice has been fully refunded
- Added
June 9th, 2024
- Added
linksproperty to Variant objects.
- Added
May 20th, 2024
- Added new Generate order invoice endpoint.
April 9th, 2024
- You now can modify the
expires_atvalue using the update License Key API endpoint to adjust the expiration date for existing License Keys.
- You now can modify the
March 28th, 2024
- You now can modify the
trial_ends_atvalue using the update subscription API endpoint to adjust the duration of free trials for existing Subscriptions. - Checkout options now include a
skip_trialattribute that allows you to create a Custom Checkout without a trial for a variant that typically offers a free trial by default.
- You now can modify the
February 20th, 2024
- Added
urls.update_customer_portalparameter to Subscription objects
- Added
February 12th, 2024
- Added new Generate subscription invoice endpoint.
- Added
invoice_immediatelyanddisable_prorationsparameters to Subscription item update object.
February 5th, 2024
- Added
tax_inclusiveparameter to Order objects and Subscription invoice objects
- Added
January 21st, 2024
- Added
setup_fee_enabledandsetup_feeparameters to Price objects - Added
setup_fee,setup_fee_usd, andsetup_fee_formattedparameters to Order objects
- Added
January 15th, 2024
- Added
unit_price_decimalparameter to Price objects - Updated
unit_priceparameter availability in Price objects
- Added
January 11th, 2024
- We updated the
created_at,expires_atformatting in our License API endpoints to properly match LicenseKey and LicenseKeyInstance objects.
- We updated the
January 5th, 2024
- Added
test_modeflag to the Retrieve the authenticated user endpoint’s metadata.
- Added
December 21st, 2023
- New endpoint: We’ve just added new Update a License Key endpoint.
December 6th, 2024
- Added
quantityparameter to OrderItem objects.
- Added
October 20th, 2023
- New endpoints: We’ve added Create customer and Update customer endpoints so you can easily manage your customers.
October 2nd, 2023
- We updated our docs regarding subscription proration, specifically how the disable_prorations option works.
September 19th, 2023
- We’ve added new
customer_portalURLs to Subscription objects and Customer objects, allowing you to link to the new Customer Portal from your application.
- We’ve added new
August 23rd, 2023
- We just added new pricing models and usage-based billing to Lemon Squeezy!
- Checkout objects have a new attribute,
checkout_data.variant_quantities, used for specifying quantities at checkout. - New Subscription items endpoints.
- New Prices endpoints.
- Various values have been deprecated from Variant objects (marked as deprecated in the docs) as they have been moved to Price objects. To preserve backwards compatibilty these values are still available in Variant objects but we ask you to use Price objects instead.
- New Usage records endpoints.
- Subscriptions now include a
first_subscription_itemobject. - Updated relationships for Subscriptions (added Subscription items) and Variants (added Prices).
August 14th, 2023
- We added
customer_id,user_nameanduser_emailvalues to Subscription invoice objects to make it easier to match invoices with customers in your application.
- We added
July 20th, 2023
- We updated the
statusvalues in Subscription invoice objects in the docs to properly match API responses.
- We updated the
July 19th, 2023
- The lists of
card_brandvalues in Subscription and Subscription invoice objects in the docs have been updated to properly match API responses.
- The lists of
July 5th, 2023
- You can now filter subscriptions by
status.
- You can now filter subscriptions by
June 27th, 2023
- We added a new
license_key_updatedwebhook event so you can now watch for license key updates and update your application accordingly. There is also a new “License key updated” trigger in our Zapier integration.
- We added a new
May 25th, 2023
- New endpoints: We’ve just added new Webhook endpoints so you can now query, create, update and delete webhooks using the API.
May 12th, 2023
- We’ve changed
refundedvalues in Order and Subscription invoice objects to betrueorfalseinstead of1or0.
- We’ve changed
April 17th, 2023
- You can now filter the Subscription invoice list endpoint by
subscription_id.
- You can now filter the Subscription invoice list endpoint by
March 30th, 2023
- We added receipt URLs to Order objects (in the API and webhooks) in
urls.receipt. - Update payment method URLs have been moved to your store subdomain rather than app.lemonsqueezy.com
- We added receipt URLs to Order objects (in the API and webhooks) in
March 17th, 2023
- We added a new
subscription_updatedwebhook event to make it easier to keep your local subscription data up-to-date (make sure you subscribe to this event from your existing webhooks). There is also a new “Subscription updated” trigger in our Zapier integration. - Custom data added to checkouts is now saved permanently and is available in all Order, Subscription and License key related webhooks.
- We’ve added
customer_idto Order, Subscription and License key objects, so you can now easily link customers to other objects. You can also nowincludecustomer objects in order, subscription and license key API calls. card_brandandcard_last_fourvalues are now available in Subscription objects.- The
subscription_payment_successwebhook event is now sent for initial subscription payments as well as renewals. billing_anchorcan now be set tonullor0to reset it to the current date. Read more →
- We added a new
February 17th, 2023
- Full license keys are now included in License Key objects.
February 7th, 2023
- New endpoints: We’ve added new Discount redemption endpoints so you can easily query discount usage.
- The update subscription API endpoint now has a
disable_prorationsflag to help manage proration. Read more →
February 6th, 2023
- The create checkout endpoint now has a
previewoption, which returns a preview object containing the checkout totals with discounts and tax taken into account.
- The create checkout endpoint now has a
February 4th, 2023
- We added
product_name,variant_name,customer_id,customer_name, andcustomer_emailto the meta object in the License API.
- We added
January 25th, 2023
- New endpoints: We just added Subscription invoices endpoints, meaning it’s possible to query billing histories for your subscriptions.
January 23rd, 2023
- Lemon.js now returns an order object during the
Checkout.Successevent. Read more →
- Lemon.js now returns an order object during the
January 9th, 2023
- You can now manually simulate subscription events from within your Dashboard. Read more →
January 5th, 2023
- The update subscription API endpoint now has a
invoice_immediatelyflag to help manage renewal invoices. Read more →
- The update subscription API endpoint now has a
December 13th, 2022
- New endpoint: We’ve added Customers endpoints so you can retrieve customer data over the API.
- Order objects now contain a
first_order_itemobject to reduce the number of API calls required.
October 26th, 2022
- Our new Subscription API allows SaaS businesses to control the entire subscription experience end-to-end.