NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #1945 most downloaded on Packagist
The PHP client library for the Recurly API
Latest stable
4.82.0
Last release 23 days ago
30 Oct 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
222 releases · first in 2013
Drag across the ruler to compare, or tap a release to open it.
Add card_network_preference field to v2 #805 (gilv93)
Add RevRec to adjustments/purchases #802 (faiberrec)
Merged Pull Requests
Your coding agent can read these notes before it upgrades. Set up the MCP server →
[V2] Add action_result to Subscription and Transaction #780 (fkosouski)
Merged Pull Requests
[V2] Add starting_on and ending_on to subscription ramps #776 (Patrick-Duvall)
Merged Pull Requests
V2 Client Library External Subscription changes #774 (paulorbpinho-fullstacklabs)
Merged Pull Requests
Full Changelog
Full Changelog
Full Changelog
Add used_tax_service to Invoice response #757 (judith)
Full Changelog
Full Changelog
Full Changelog
Modify external subscriptions #746 (paulorbpinho-fullstacklabs)
Add Custom Fields on Adjustments #740 (ngleiser)
Merged Pull Requests
Add preferred_time_zone to Account #734 (cbarton)
V2 add support for Apply Credit Balance to existing invoice feature #733 (judith)
Merged Pull Requests
v2 updates for external subscriptions and products #730 (amandamfielding)
Merged Pull Requests
Full Changelog
Client lib updates for v2 entitlements #719 (sunnyw1212)
Full Changelog
Fixing bug with setValues method #717 (douglasmiller)
Add UTF-8 encoding to the DomDocument #715 (douglasmiller)
Fixes method_exists exception on xml_doc.php #711 (Smolations)
change method call #709 (ricardopaul0)
Merged Pull Requests
Add Ramp Pricing Feature to Subscriptions #703 (Smolations)
Merged Pull Requests
V2 add processing_prepayment_balance_in_cents to Recurly_AccountBalance #691 (judith)
Merged Pull Requests
Add online_banking_payment_type to billing_info #660 (cyberxander90)
Merged Pull Requests
Client lib updates for v2 dunning campaigns #638 (sunnyw1212)
Postpone subscriptions using the field next_bill_date #610 (cyberxander90)
Merged Pull Requests
Wallet and Backup Payment #604 (joannasese)
Merged Pull Requests
PHPDoc: fix type of invoice type should be string instead of int https://github.com/recurly/recurly-client-php/pull/575
Implement Pager#take https://github.com/recurly/recurly-client-php/pull/562
item_state and external_sku to phpdocs https://github.com/recurly/recurly-client-php/pull/568Support item-specific coupons https://github.com/recurly/recurly-client-php/pull/563
New endpoint to verify an account's billing information https://github.com/recurly/recurly-client-php/pull/538
This brings us up to API version 2.29. There are no breaking changes
This brings us up to API version 2.29. There are no breaking changes
This brings us up to API version 2.28. There are no breaking changes
This brings us up to API version 2.28. There are no breaking changes
This brings us up to API version 2.27. There are no breaking changes
This brings us up to API version 2.27. There are no breaking changes
This brings us up to API version 2.26. There are no breaking changes
This brings us up to API version 2.26. There are no breaking changes
Prevent overwritten address on new purchase with existing account
This brings us up to API version 2.25. There are no breaking changes
This brings us up to API version 2.25. There are no breaking changes
getFile() calls (https://github.com/recurly/recurly-client-php/pull/454)Delete to ShippingAddress object (https://github.com/recurly/recurly-client-php/pull/457)external_sku to Adjustment (included in API version 2.24) (https://github.com/recurly/recurly-client-php/pull/458)convertTrial() to Subscription (https://github.com/recurly/recurly-client-php/pull/459)Add vat_number to ShippingAddress class
This brings us up to API version 2.24. There are no breaking changes
This brings us up to API version 2.24. There are no breaking changes
Add shipping address to Purchase
Fix issue with missing requires PR.
Note: This release is broken and 2.12.7 should be used instead.
This brings us up to API version 2.22. There are no breaking changes
This brings us up to API version 2.22. There are no breaking changes
This brings us up to API version 2.21. There are no breaking changes
This brings us up to API version 2.21. There are no breaking changes
Note: This API version corrects the error of an invalid Recurly.js token sent to v2/accounts/:account_code/billing_info from a 404 Not Found to a 422 Unprocessable Entity
This brings us up to API version 2.20. There are no breaking changes
Ensure nested resources have the same client as their parent PR
## Version 2.12.1 (March 15th, 2019) * Fix issue with _verifyUri PR
This brings us up to API version 2.19
This brings us up to API version 2.19
Note: This version contains a bug with the _verifyUri method. Please use 2.12.1 instead.
Recurly_ExportFile class, you must now use getDownloadUrl() to get the download url rather than accessing this property directly.# if you are accessing the download url directly
$url = $export_file->download_url;
# you'll now need to use a getter
$url = $export_file->getDownloadUrl();
If you are using $export_file->download($fp) and not accessing the url directly, you should not be affected.
Adds support for Amazon Region PR
This release contains one breaking change. Older Recurly.js token signing is not longer supported. You should upgrade to version 4 of Recurly.js: http…
This release will upgrade us to API version 2.17.
gateway_code to Subscription and Invoice objects PRexemption_certificate to Account object PRgetHeaders() method PRThis release contains one breaking change. Older Recurly.js token signing is not longer supported. You should upgrade to version 4 of Recurly.js: https://dev.recurly.com/docs/recurlyjs
Fixed issue with RFC 2616 compliance: headers should be treated as case-insensitive.
This release will upgrade us to API version 2.16. There are no breaking changes.
This release will upgrade us to API version 2.16. There are no breaking changes.
This release will upgrade us to API version 2.15. There are no breaking changes.
This release will upgrade us to API version 2.14. There are no breaking changes.
This release will upgrade us to API version 2.13. There are no breaking changes.
This release will upgrade us to API version 2.12. There are no breaking changes.
This release will upgrade us to API version 2.12. There are no breaking changes.
One column per quarter.