# @ember-data/json-api

> (Legacy) JSON:API document and resource cache implementation for EmberData

Latest version **5.9.1** (published 2026-09-05) · MIT license · 0 weekly downloads

## Install

```sh
npm install @ember-data/json-api
pnpm add @ember-data/json-api
yarn add @ember-data/json-api
bun add @ember-data/json-api
```

## Health

**Score 65/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 5.9.1 |
| Published | 2026-09-05 |
| First published | 2022-12-09 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 4 |
| Unpacked size | 294.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 3157 |
| Maintainers | ember-data-admin, runspired, richgt, hm_krystan, katiegengler |
| Keywords | ember-addon |

## Links

- npm: https://www.npmjs.com/package/@ember-data/json-api
- Repository: https://github.com:warp-drive-data/warp-drive
- npm.io page: https://npm.io/package/@ember-data/json-api

## Dependencies (4)

- [@warp-drive/core](https://npm.io/package/@warp-drive/core.md) 5.9.1
- [@embroider/macros](https://npm.io/package/@embroider/macros.md) ^1.20.6
- [@warp-drive/json-api](https://npm.io/package/@warp-drive/json-api.md) 5.9.1
- [@warp-drive/utilities](https://npm.io/package/@warp-drive/utilities.md) 5.9.1

## Recent versions

- 5.9.1 (latest) — 2026-09-05
- 5.10.0-alpha.14 (canary) — 2026-10-02
- 5.9.0-beta.3 (beta) — 2026-09-05
- 4.13.0-alpha.9 (v4-canary) — 2025-05-15
- 5.3.13 (lts) — 2025-04-11
- 4.12.8 (lts-4-12) — 2024-05-08
- 5.10.0-alpha.13 — 2026-09-29
- 5.10.0-alpha.12 — 2026-09-25
- 5.10.0-alpha.10 — 2026-09-23
- 5.10.0-alpha.9 — 2026-09-22
- 5.10.0-alpha.8 — 2026-09-18
- 5.10.0-alpha.7 — 2026-09-15
- 5.10.0-alpha.6 — 2026-09-11
- 5.10.0-alpha.5 — 2026-09-11
- 5.10.0-alpha.4 — 2026-09-10
- … 476 more at https://npm.io/package/@ember-data/json-api/versions

## README

<p align="center">
  <img
    class="project-logo"
    src="./logos/logo-yellow-slab.svg"
    alt="WarpDrive"
    width="180px"
    title="WarpDrive"
    />
</p>

![NPM Stable Version](https://img.shields.io/npm/v/ember-data/latest?label=version&style=flat&color=fdb155)
![NPM Downloads](https://img.shields.io/npm/dm/ember-data.svg?style=flat&color=fdb155)
![License](https://img.shields.io/github/license/warp-drive-data/warp-drive.svg?style=flat&color=fdb155)
[![EmberJS Discord Community Server](https://img.shields.io/badge/EmberJS-grey?logo=discord&logoColor=fdb155)](https://discord.gg/zT3asNS
)
[![WarpDrive Discord Server](https://img.shields.io/badge/WarpDrive-grey?logo=discord&logoColor=fdb155)](https://discord.gg/PHBbnWJx5S
)

<p align="center">
  <br>
  <a href="https://warp-drive.io">WarpDrive</a> is the lightweight data library for web apps &mdash;
  <br>
  universal, typed, reactive, and ready to scale.
  <br/><br/>
</p>

---

# @ember-data/json-api

<p align="center">Elegantly composable. Made for <strong>JSON:</strong>API</p>

> [!WARNING]
> **⚠️ This package only exists for backwards compatibility**
>
> Newer apps should use [@warp-drive/json-api](https://warp-drive.io/api/@warp-drive/json-api/) for the cache and [@warp-drive/utilities](https://warp-drive.io/api/@warp-drive/utilities/)
> for the builders it provided.


This package provides an in-memory document and resource [Cache](https://warp-drive.io/api/@warp-drive/core/types/cache/interfaces/Cache) and associated utilities for use with [***Warp*Drive**](https://warp-rive.io) and [{json:api}](https://jsonapi.org/).

This package is intended for use with the older EmberData package setup, for use with more recent versions of WarpDrive see [@warp-drive/json-api](https://www.npmjs.com/package/@warp-drive/json-api) for the Cache and  [@warp-drive/utilities](https://www.npmjs.com/package/@warp-drive/utilities) for the builders.

`{json:api}` excels at simplifying common complex problems around cache consistency and information density, especially in regards to relational or polymorphic data.

Because most API responses can be quickly transformed into the `{json:api}` format without losing any information, ***Warp*Drive** recommends that most-if-not-all apps should use this Cache implementation.

**Tagged Releases**

- ![NPM Canary Version](https://img.shields.io/npm/v/%40ember-data/json-api/canary?label=%40canary&color=FFBF00)
- ![NPM Beta Version](https://img.shields.io/npm/v/%40ember-data/json-api/beta?label=%40beta&color=ff00ff)
- ![NPM Stable Version](https://img.shields.io/npm/v/%40ember-data/json-api/latest?label=%40latest&color=90EE90)
- ![NPM LTS Version](https://img.shields.io/npm/v/%40ember-data/json-api/lts?label=%40lts&color=0096FF)
- ![NPM LTS 4.12 Version](https://img.shields.io/npm/v/%40ember-data/json-api/lts-4-12?label=%40lts-4-12&color=bbbbbb)

---
_Source: https://npm.io/package/@ember-data/json-api · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._