NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #674 most downloaded on Packagist
Build beautiful API integrations and SDKs with Saloon
Latest stable
v4.5.2
Last release 18 days ago
04 Nov 2026
Release timing varies
gaps range from 9 days to 6 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
139 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Use the request's API version in URL mode when the connector has one by @Cbrad24 in #567
Full Changelog: v4.5.1...v4.5.2
Full Changelog: https://github.com/saloonphp/saloon/compare/v4.5.1...v4.5.2
[4.x] Fix Guzzle 8 transfer exceptions in GuzzleSender by @JonPurvis in #569
Full Changelog: v4.5.0...v4.5.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Full Changelog: https://github.com/saloonphp/saloon/compare/v4.5.0...v4.5.1
Add HasApiVersion trait for API versioning by @JonPurvis in #564
HasApiVersion trait for API versioning by @JonPurvis in #564Full Changelog: v4.4.0...v4.5.0
HasApiVersion trait for API versioning by @JonPurvis in https://github.com/saloonphp/saloon/pull/564Full Changelog: https://github.com/saloonphp/saloon/compare/v4.4.0...v4.5.0
Add PSR-20 Clock Support by @yankewei in #518
Full Changelog: v4.3.0...v4.4.0
Full Changelog: https://github.com/saloonphp/saloon/compare/v4.3.0...v4.4.0
Add additional status code exceptions by @mmachatschek in #552
Full Changelog: v4.2.1...v4.3.0
Full Changelog: https://github.com/saloonphp/saloon/compare/v4.2.1...v4.3.0
[4.x] Fix: Null header deprecated notice for PSR requests by @pokyunn in #554
Full Changelog: https://github.com/saloonphp/saloon/compare/v4.2.0...v4.2.1
Fix shallow Request clone sharing query/headers/config for pooled sends by @JonPurvis in #549
Full Changelog: v4.1.0...v4.2.0
Full Changelog: https://github.com/saloonphp/saloon/compare/v4.1.0...v4.2.0
Add MockClient::withoutCache() by @JonPurvis in #548
MockClient::withoutCache() by @JonPurvis in https://github.com/saloonphp/saloon/pull/548Full Changelog: https://github.com/saloonphp/saloon/compare/v4.0.1...v4.1.0
Fix for empty response body when debugging unseekable streams by @JonPurvis in https://github.com/saloonphp/saloon/pull/537
Full Changelog: https://github.com/saloonphp/saloon/compare/v4.0.0...v4.0.1
Full Changelog: v4.0.0...v4.0.1
Fixed CVE-2026-33942 - Insecure deserialisation in AccessTokenAuthenticator (object injection / RCE)
Full Changelog: v3.15.0...v4.0.0
Swap header to use psrResponse by @JonPurvis in #535
header to use psrResponse by @JonPurvis in #535Full Changelog: v3.14.3...v3.15.0
header to use psrResponse by @JonPurvis in https://github.com/saloonphp/saloon/pull/535Full Changelog: https://github.com/saloonphp/saloon/compare/v3.14.3...v3.15.0
Handle lowercase Content-Type header for JSON and XML by @JonPurvis in #534
Full Changelog: v3.14.2...v3.14.3
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.14.2...v3.14.3
Feature | PHP 8.5 Support by @Sammyjo20 in #525
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.14.1...v3.14.2
Add allow stray requests method to config by @ziadoz in #522
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.14.0...v3.14.1
Feature | Increase Exception Body Message Limit by @Sammyjo20 in #503
Full Changelog: v3.13.1...v3.14.0
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.13.1...v3.14.0
Fix | URLHelper incorrectly URLs with underscores by @Sammyjo20 in #502
Full Changelog: v3.13.0...v3.13.1
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.13.0...v3.13.1
Feature | Add Context To Fixtures by @Gummibeer in #444
Full Changelog: v3.12.0...v3.13.0
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.12.0...v3.13.0
Feature | Added isJson and isXML functions to Response class by @mstfblci in #455
Full Changelog: v3.11.2...v3.11.3
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.11.2...v3.11.3
Revert "Make sure multiple assertions can be made on the same request class" by @Sammyjo20 in #486
assertSent parameters" by @Sammyjo20 in #487Full Changelog: v3.11.1...v3.11.2
assertSent parameters" by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/487Full Changelog: https://github.com/saloonphp/saloon/compare/v3.11.1...v3.11.2
Make sure multiple assertions can be made on the same request class by @markwalet in https://github.com/saloonphp/saloon/pull/485
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.11.0...v3.11.1
Feature | Accept type-hinted requests as assertSent parameters by @innocenzi in https://github.com/saloonphp/saloon/pull/424
assertSent parameters by @innocenzi in https://github.com/saloonphp/saloon/pull/424Full Changelog: https://github.com/saloonphp/saloon/compare/v3.10.1...v3.11.0
Fix | Resolve PHP 8.4 deprecation warnings by @markwalet in https://github.com/saloonphp/saloon/pull/468
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.10.0...v3.10.1
Add PaymentRequired Exception by @JonPurvis in https://github.com/saloonphp/saloon/pull/441
PaymentRequired Exception by @JonPurvis in https://github.com/saloonphp/saloon/pull/441Full Changelog: https://github.com/saloonphp/saloon/compare/v3.9.1...v3.10.0
Fix | Resolve headers with array as value by @smithbm2316 in https://github.com/saloonphp/saloon/pull/433
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.9.0...v3.9.1
Fix | PHPStan v1.11 by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/426
assertSentInOrder assertion to MockClient by @DaniTulp in https://github.com/saloonphp/saloon/pull/400NullAuthenticator to overwrite defaultAuth by @patrickcarlohickman in https://github.com/saloonphp/saloon/pull/423Full Changelog: https://github.com/saloonphp/saloon/compare/v3.8.1...v3.9.0
Fix | Getting Single Multipart Value by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/397
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.8.0...v3.8.1
Feature | Debug Helper Method by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/387
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.7.0...v3.8.0
Feature | Added dataUrl for Response by @guanguans in https://github.com/saloonphp/saloon/pull/377
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.6.4...v3.7.0
Feature | Deprecate Send And Retry Method by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/379
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.6.3...v3.6.4
Fix | Allow Return False In hasRequestFailed by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/371
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.6.2...v3.6.3
Fix | Better Query Parameter Parsing by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/370
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.6.1...v3.6.2
Feature | Deprecate Auth Methods by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/368
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.6.0...v3.6.1
Feature | V3 Added a request option to assertSentCount by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/364
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.5.0...v3.6.0
Feature | Global Mock Client by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/359
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.4.2...v3.5.0
Fix | Allow createOAuthAuthenticator method to have a nullable refresh token by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/363
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.4.1...v3.4.2
Remove Redundant Trait by @Cbrad24 in https://github.com/saloonphp/saloon/pull/357
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.4.0...v3.4.1
Fix | Remove xml method deprecation by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/350
xml method deprecation by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/350Full Changelog: https://github.com/saloonphp/saloon/compare/v3.3.2...v3.4.0
Feature | Throw an exception when missing HTTP method by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/347
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.3.1...v3.3.2
Update composer.json and add saloonphp/xml-wrangler by @Gummibeer in https://github.com/saloonphp/saloon/pull/344
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.3.0...v3.3.1
Feature | Add exponential backoff for retry interval by @binaryfire in https://github.com/saloonphp/saloon/pull/304
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.2.0...v3.3.0
Feature | Added certificate authenticator by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/341
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.1.0...v3.2.0
Fix | V3 - Allow multiple multipart values with the same name by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/340
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.0.6...v3.1.0
Fix | V3 - Remove Distracting @throws from PHPDocs by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/339
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.0.5...v3.0.6
Fix | V3 - Remove array filter on multipart builder by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/332
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.0.4...v3.0.5
Fix | MockClient assertions with fixtures by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/326
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.0.3...v3.0.4
Bugfix: empty response body to json should not fail by @gdebrauwer in https://github.com/saloonphp/saloon/pull/315
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.0.2...v3.0.3
Fix | V3 - Using Just Connector Body by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/312
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.0.1...v3.0.2
Fix | V3 Concurrency Issues by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/308
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.0.0...v3.0.1
V3 Feature | Remove Dispatcher by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/209
all method on body by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/297all method back onto body by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/298Full Changelog: https://github.com/saloonphp/saloon/compare/v2.10.0...v3.0.0
Fix | V3 Reduced Breaking Config Changes by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/302
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.0.0-beta.6...v3.0.0-beta.7
Added sammyjo20/saloon as a conflicting package to saloonphp/saloon as sometimes both could be accidentally installed at the same time.
sammyjo20/saloon as a conflicting package to saloonphp/saloon as sometimes both could be accidentally installed at the same time.Full Changelog: https://github.com/saloonphp/saloon/compare/v2.11.0...v3.0.0-beta.6
Feature | V3 - Add back all method on body by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/297
all method on body by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/297all method back onto body by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/298Full Changelog: https://github.com/saloonphp/saloon/compare/v3.0.0-beta.4...v3.0.0-beta.5
Feature | v3 Small Tweaks by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/290
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.0.0-beta.3...v3.0.0-beta.4
Feature | V3 Move Config & Tidy Up by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/287
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.0.0-beta.2...v3.0.0-beta.3
Feature | V3 Remove Interfaces by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/286
Full Changelog: https://github.com/saloonphp/saloon/compare/v3.0.0-beta.1...v3.0.0-beta.2
This is the first beta tag of v3.0.0 - documentation is coming soon but this is a tag to aim to be able to test everything in local projects.
This is the first beta tag of v3.0.0 - documentation is coming soon but this is a tag to aim to be able to test everything in local projects.
Full Changelog: https://github.com/saloonphp/saloon/compare/v2.10.0...v3.0.0-beta.1
Fix | V2 - MockClient assertions with fixtures by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/327
Full Changelog: https://github.com/saloonphp/saloon/compare/v2.12.0...v2.12.1
Added sammyjo20/saloon as a conflicting package to saloonphp/saloon as sometimes both could be accidentally installed at the same time.
sammyjo20/saloon as a conflicting package to saloonphp/saloon as sometimes both could be accidentally installed at the same time.Full Changelog: https://github.com/saloonphp/saloon/compare/v2.11.0...v2.12.0
## What's Changed - Added support for PHP 8.3 Full Changelog: https://github.com/saloonphp/saloon/compare/v2.10.0...v2.11.0
Full Changelog: https://github.com/saloonphp/saloon/compare/v2.10.0...v2.11.0
Update README.md by @Sammyjo20 in https://github.com/saloonphp/saloon/pull/279
Full Changelog: https://github.com/saloonphp/saloon/compare/v2.9.2...v2.10.0
One column per quarter.