aeson: Fast JSON parsing and encoding

[ bsd3, json, library, text, web ] [ Propose Tags ] [ Report a vulnerability ]

A JSON parsing and encoding library optimized for ease of use and high performance.

To get started, see the documentation for the Data.Aeson module below.

(A note on naming: in Greek mythology, Aeson was the father of Jason.)


[Skip to Readme]

Flags

Manual Flags

NameDescriptionDefault
ordered-keymap

Use ordered Data.Map.Strict for KeyMap implementation.

Enabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Versions [RSS] 0.1.0.0, 0.2.0.0, 0.3.0.0, 0.3.1.0, 0.3.1.1, 0.3.2.0, 0.3.2.1, 0.3.2.2, 0.3.2.3, 0.3.2.4, 0.3.2.5, 0.3.2.6, 0.3.2.7, 0.3.2.8, 0.3.2.9, 0.3.2.10, 0.3.2.11, 0.3.2.12, 0.3.2.13, 0.3.2.14, 0.4.0.0, 0.4.0.1, 0.5.0.0, 0.6.0.0, 0.6.0.1, 0.6.0.2, 0.6.1.0, 0.6.2.0, 0.6.2.1, 0.7.0.0, 0.7.0.1, 0.7.0.2, 0.7.0.3, 0.7.0.4, 0.7.0.5, 0.7.0.6, 0.8.0.0, 0.8.0.1, 0.8.0.2, 0.8.1.0, 0.8.1.1, 0.9.0.0, 0.9.0.1, 0.10.0.0, 0.11.0.0, 0.11.1.0, 0.11.1.1, 0.11.1.2, 0.11.1.3, 0.11.1.4, 0.11.2.0, 0.11.2.1, 0.11.3.0, 1.0.0.0, 1.0.1.0, 1.0.2.0, 1.0.2.1, 1.1.0.0, 1.1.1.0, 1.1.2.0, 1.2.0.0, 1.2.1.0, 1.2.2.0, 1.2.3.0, 1.2.4.0, 1.3.0.0, 1.3.1.0, 1.3.1.1, 1.4.0.0, 1.4.1.0, 1.4.2.0, 1.4.3.0, 1.4.4.0, 1.4.5.0, 1.4.6.0, 1.4.7.0, 1.4.7.1, 1.5.0.0, 1.5.1.0, 1.5.2.0, 1.5.3.0, 1.5.4.0, 1.5.4.1, 1.5.5.0, 1.5.5.1, 1.5.6.0, 2.0.0.0, 2.0.1.0, 2.0.2.0, 2.0.3.0, 2.1.0.0, 2.1.1.0, 2.1.2.0, 2.1.2.1, 2.2.0.0, 2.2.1.0, 2.2.2.0, 2.2.3.0, 2.2.4.0, 2.2.4.1, 2.2.5.0, 2.3.0.0, 2.3.1.0 (info)
Change log changelog.md
Dependencies base (>=4.12.0.0 && <5), bytestring (>=0.10.8.2 && <0.13), character-ps (>=0.1 && <0.2), containers (>=0.6.0.1 && <0.9), data-fix (>=0.3.2 && <0.4), deepseq (>=1.4.4.0 && <1.6), dlist (>=1.0 && <1.1), exceptions (>=0.10.4 && <0.11), generically (>=0.1 && <0.2), hashable (>=1.4.6.0 && <1.5 || >=1.5.0.0 && <1.6), indexed-traversable (>=0.1.2 && <0.2), integer-conversion (>=0.1 && <0.2), integer-gmp, integer-logarithms (>=1.0.3.1 && <1.1), network-uri (>=2.6.4.1 && <2.7), OneTuple (>=0.4.1.1 && <0.5), primitive (>=0.8.0.0 && <0.9 || >=0.9.0.0 && <0.10), QuickCheck (>=2.14.3 && <2.16 || >=2.16.0.0 && <2.17 || >=2.17.1.0 && <2.18 || >=2.18.0.0 && <2.19), scientific (>=0.3.7.0 && <0.4), semialign (>=1.3 && <1.5), strict (>=0.5 && <0.6), tagged (>=0.8.7 && <0.9), template-haskell (>=2.14.0.0 && <2.25), text (>=1.2.3.0 && <1.3 || >=2.0 && <2.2), text-iso8601 (>=0.1.1 && <0.3), text-short (>=0.1.5 && <0.2), th-abstraction (>=0.5.0.0 && <0.6 || >=0.6.0.0 && <0.7 || >=0.7.0.0 && <0.8), these (>=1.2 && <1.3), time (>=1.8.0.2 && <1.16), time-compat (>=1.9.6 && <1.10), unordered-containers (>=0.2.10.0 && <0.3), uuid-types (>=1.0.5 && <1.1), vector (>=0.13.0.0 && <0.14), witherable (>=0.4.2 && <0.6) [details]
Tested with ghc ==8.6.5 || ==8.8.4 || ==8.10.7 || ==9.0.2 || ==9.2.8 || ==9.4.8 || ==9.6.6 || ==9.8.4 || ==9.10.3 || ==9.12.4 || ==9.14.1
License BSD-3-Clause
Copyright 2014-2026 Aeson project contributors, 2011-2016 Bryan O'Sullivan, 2011 MailRank, Inc.
Author Bryan O'Sullivan <bos@serpentine.com>
Maintainer Li-yao Xia <lysxia@gmail.com>, Core Libraries Committee
Uploaded by lyxia at 2026-07-05T10:37:44Z
Category Text, Web, JSON
Home page https://github.com/haskell/aeson
Bug tracker https://github.com/haskell/aeson/issues
Source repo head: git clone https://github.com/haskell/aeson.git
Distributions Arch:2.2.2.0, Fedora:2.2.3.0, LTSHaskell:2.2.5.0, Stackage:2.2.5.0
Reverse Dependencies 2870 direct, 5977 indirect [details]
Downloads 603771 total (401 in the last 30 days)
Rating 3.0 (votes: 45) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2026-07-05 [all 1 reports]

Readme for aeson-2.3.1.0

[back to package description]

Welcome to aeson

Hackage Build Status

aeson is a fast Haskell library for working with JSON data.

Join in!

We are happy to receive bug reports, fixes, documentation enhancements, and other improvements.

Please report bugs via the github issue tracker.

Master git repository:

  • git clone https://github.com/haskell/aeson.git

See what's changed in recent (and upcoming) releases:

Authors

This library was originally written by Bryan O'Sullivan.