API Changelog
Keep up to date with changes to our API.
September 10th, 2024
- Added
fraudulent
Order 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
dark
option in thecheckout_options
attribute when creating a new checkout. Use the new color options instead. - Added the following options to the
checkout_options
attribute to allow overriding checkout styles when creating a new checkout:background_color
headings_color
primary_text_color
secondary_text_color
links_color
borders_color
checkbox_color
active_state_color
button_color
button_text_color
terms_privacy_color
August 7th, 2024
- Added
refunded_amount
,refunded_amount_usd
andrefunded_amount_formatted
parameters to Order objects and Subscription invoice objects - The
refunded
property of Order objects now only - The
refunded
property of Subscription invoice objects now only reflects whether the invoice has been fully refunded
- Added
June 9th, 2024
- Added
links
property to Variant objects.
- Added
May 20th, 2024
- Added new Generate order invoice endpoint.
April 9th, 2024
- You now can modify the
expires_at
value 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_at
value using the update subscription API endpoint to adjust the duration of free trials for existing Subscriptions. - Checkout options now include a
skip_trial
attribute 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_portal
parameter to Subscription objects
- Added
February 12th, 2024
- Added new Generate subscription invoice endpoint.
- Added
invoice_immediately
anddisable_prorations
parameters to Subscription item update object.
February 5th, 2024
- Added
tax_inclusive
parameter to Order objects and Subscription invoice objects
- Added
January 21st, 2024
- Added
setup_fee_enabled
andsetup_fee
parameters to Price objects - Added
setup_fee
,setup_fee_usd
, andsetup_fee_formatted
parameters to Order objects
- Added
January 15th, 2024
- Added
unit_price_decimal
parameter to Price objects - Updated
unit_price
parameter availability in Price objects
- Added
January 11th, 2024
- We updated the
created_at
,expires_at
formatting in our License API endpoints to properly match LicenseKey and LicenseKeyInstance objects.
- We updated the
January 5th, 2024
- Added
test_mode
flag 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
quantity
parameter 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_portal
URLs 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_item
object. - Updated relationships for Subscriptions (added Subscription items) and Variants (added Prices).
August 14th, 2023
- We added
customer_id
,user_name
anduser_email
values to Subscription invoice objects to make it easier to match invoices with customers in your application.
- We added
July 20th, 2023
- We updated the
status
values in Subscription invoice objects in the docs to properly match API responses.
- We updated the
July 19th, 2023
- The lists of
card_brand
values 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_updated
webhook 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
refunded
values in Order and Subscription invoice objects to betrue
orfalse
instead of1
or0
.
- 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_updated
webhook 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_id
to Order, Subscription and License key objects, so you can now easily link customers to other objects. You can also nowinclude
customer objects in order, subscription and license key API calls. card_brand
andcard_last_four
values are now available in Subscription objects.- The
subscription_payment_success
webhook event is now sent for initial subscription payments as well as renewals. billing_anchor
can now be set tonull
or0
to 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_prorations
flag to help manage proration. Read more →
February 6th, 2023
- The create checkout endpoint now has a
preview
option, 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_email
to 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.Success
event. 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_immediately
flag 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_item
object 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.