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 (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.8), 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), ghc-prim (>=0.5.0.0 && <0.14), 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.4), strict (>=0.5 && <0.6), tagged (>=0.8.7 && <0.9), template-haskell (>=2.14.0.0 && <2.24), text (>=1.2.3.0 && <1.3 || >=2.0 && <2.2), text-iso8601 (>=0.1.1 && <0.2), 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.15), 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.1 || ==9.12.1
License BSD-3-Clause
Copyright (c) 2011-2016 Bryan O'Sullivan (c) 2011 MailRank, Inc.
Author Bryan O'Sullivan <bos@serpentine.com>
Maintainer Adam Bergmark <adam@bergmark.nl>
Uploaded by phadej at 2026-04-15T20:41:57Z
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
Reverse Dependencies 2799 direct, 5882 indirect [details]
Downloads 602821 total (250 in the last 30 days)
Rating 3.0 (votes: 44) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2026-04-15 [all 1 reports]

Readme for aeson-2.2.4.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:

(You can create and contribute changes using either git or Mercurial.)

Authors

This library was originally written by Bryan O'Sullivan.