NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #3163 most downloaded on Packagist
Encode JSON:API resources using the neomerx/json-api package.
Last release 6 months ago
28 Mar 2026
Ships fairly regularly
a new release about every 4 months
Nearly every release is documented
notes for 12 of 12 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
17 releases · first in 2021
Dropped support for laravel-json-api/core v4.
laravel-json-api/core v4.Package now supports Laravel 11 and 12.
Remove deprecation notices in PHP 8.4.
One column per quarter.
laravel-json-api/core v4 or v5.Package is now licensed under the MIT License.
8.2.Fix bug in document json-api property.
Fix bug in document json-api property.
$jsonApi
property on the Document class.Remove re-throwing of exceptions.
Remove re-throwing of exceptions.
Improve exception messages.
Improve exception messages.
Upgraded to Laravel 10 and set minimum PHP version to 8.1.
8.1.Upgrade neomerx package for meta bugfix.
Upgrade neomerx package for meta bugfix.
laravel-json-api/neomerx-json-api dependency to ^5.0.1. This fixes a bug related to the top-level
meta member. Previously the encoder added empty meta values to the top-level member, which is incorrect.Added return types to internal methods to remove deprecation messages in PHP 8.1
laravel-json-api/neomerx-json-api dependency to 5.0.laravel-json-api/core dependency to 2.0.Fixed setting the top-level jsonapi value on the Document class, which was not setting the cast value.
jsonapi value on the Document class, which was not setting the cast value.RelationshipDocument no longer merges relationship links with the top-level document links. This is because we
now expect the top-level links provided to the encoder to already have the relationship links merged. The core
package takes care of this in the relationship response classes, while also providing the capability for the developer
to turn off link merging if desired (which is a better implementation). This change is considered non-breaking because
the core package dependency has been upgraded and there were existing bugs in the links merging implementation within
the RelationshipDocument class. I.e. it would fail if either of the self or related links were missing, or if the
relationship was hidden - so removing this merging fixes bugs in the implementation.Initial stable release, with no changes since 1.0.0-beta.1.
Initial stable release, with no changes since 1.0.0-beta.1.
Updated the encoder to implement changes made to the encoder interface. This removes the withIdentifiers() method and replaces it with the withToOne()
withIdentifiers() method
and replaces it with the withToOne() and withToMany() methods.This package now relies on laravel-json-api/neomerx-json-api, a fork of neomerx/json-api. This was required because of a bug affecting empty to-many i
laravel-json-api/neomerx-json-api, a fork of neomerx/json-api. This was required
because of a bug affecting empty to-many include paths.
Although a PR was sent to the Neomerx repository, there has been no activity in that repository for almost a year. The
fork will be maintained for use in Laravel JSON:API, but we will switch back to using the Neomerx package if it is
maintained in the future.Encoder now supports conditional fields being used in the JSON:API resource relationships.
getSelfLink() method, which was not passing the request through to the JSON:API resource object.Resource meta can now contain conditional attributes, as the conditional iterator is used when processing meta returned by the JsonApiResource class.
withRequest method on the encoder, allows a request to be passed into the encoding process. This is then
provided to each JsonApiResource object when it is being encoded. This change was made to bring the resource into
line with Laravel's Eloquent resource, which is passed the request when serializing models. (Changes to classes in
the Schema namespace to implement this are considered non-breaking, as they are internal classes.)JsonApiResource class.composer.json.Initial release.
Initial release.
Your coding agent can read these notes before it upgrades. Set up the MCP server →