# jsonata-js/jsonata

JSONata query and transformation language - http://jsonata.org

Repository: https://github.com/jsonata-js/jsonata
Canonical: https://ross.abutalabs.com/products/jsonata
Language: JavaScript
License: MIT
License Family: permissive
Last push: 2026-07-30T15:19:04+00:00

## Health v2 (maintenance only)
Score: 96/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 95, release rhythm 95, longevity 100
- inputs: {"age_days": 3627, "days_push": 34, "days_rel": 34, "gap_med": 14, "n_releases_24m": 8}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2679, forks 284 (observed 2026-08-28T04:07:09.951055+00:00)

## What it is
JSONata is a lightweight query and transformation language for JSON data, and this repository is its reference JavaScript implementation. It lets you write declarative expressions to query, filter, reshape, and compute over JSON documents in Node.js or the browser.

## Use cases
- query and filter nested json data
- transform json payloads between api formats
- map json fields with expressions
- aggregate values from json arrays
- reshape json for etl pipelines
- evaluate json expressions in the browser

## When to choose
- you need declarative querying and reshaping of JSON documents
- you want a lightweight, dependency-free library usable in Node.js and browsers
- you're building API mapping or integration layers that transform JSON payloads
- you want a mature, well-documented reference implementation of the JSONata spec

## When to avoid
- you only need simple JSON path lookups where JSONPath or lodash suffices
- you need to query non-JSON data formats like XML or SQL databases
- you require a full programming language rather than an expression language
- your team prefers imperative transformation code over declarative expressions

## Facets
- artifact type: library
- maturity: stable
- function: parser, serialization, developer-tools
- domain: developer-tools, apis
- platform: browser, cross-platform
- tags: json-query, json-transformation, expression-language, data-mapping, query-language, data-engineering, automation, nodejs, javascript

## Member repositories
- jsonata-js/jsonata (main) score 96

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:09.951055+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:17:57.886209+00:00, confidence not recorded.
  - readme: https://github.com/jsonata-js/jsonata (fetched 2026-08-28T04:07:09.951055+00:00, sha de8307f0daf4)
  - registry_npm: https://registry.npmjs.org/jsonata (fetched 2026-08-29T10:00:29.168841+00:00, sha 5d09cd6bc603)
- Data as of 2026-08-30T08:39:29.467469+00:00.