Yet another JSON library for Scala
Latest commit 551ad00 Jan 21, 2017 @travisbrown travisbrown committed on GitHub Merge pull request #553 from n4to4/update-doc-versions
Update versions in doc


Build status Coverage status Gitter Maven Central

circe is a JSON library for Scala (and Scala.js).

Please see the guide for more information about why circe exists and how to use it.



Are you using circe? Please consider opening a pull request to list your organization here:

  • Project September (using circe to exchange and store data within the platform and serve data using GraphQL with Sangria)
  • Reonomy
  • SoundCloud (transforming 200,000,000 JSON events every hour in MapReduce ETLs)
  • TabMo (parsing more than 100k events per second with Akka Stream and Spark)
  • Twilio (sending many, many millions of messages a day with Circe and Akka)
  • The Guardian
  • Ravel Law (using circe to (de)serialize data for search, analytics, and visualization of tens of millions of legal opinions)

Other circe organization projects

Please get in touch on Gitter if you have a circe-related project that you'd like to discuss hosting under the circe organization on GitHub.

  • circe-jackson: A library that provides Jackson-supported parsing and printing for circe.
  • circe-yaml: A library that uses SnakeYAML to support parsing YAML 1.1 into circe's Json.
  • circe-spray: A library that provides JSON marshallers and unmarshallers for Spray using circe.
  • circe-benchmarks: Benchmarks for comparing the performance of circe and other JSON libraries for the JVM.

Related projects

The following open source projects are either built on circe or provide circe support:


The following projects provide examples, templates, or benchmarks that include circe:

Contributors and participation

circe is a fork of Argonaut, and if you find it at all useful, you should thank Mark Hibberd, Tony Morris, Kenji Yoshida, and the rest of the Argonaut contributors.

circe is currently maintained by Travis Brown, Alexandre Archambault, and Vladimir Kostyukov. After the 1.0 release, all pull requests will require two sign-offs by a maintainer to be merged.

The circe project supports the Typelevel code of conduct and wants all of its channels (Gitter, GitHub, etc.) to be welcoming environments for everyone.

Please see the contributors' guide for details on how to submit a pull request.


circe is licensed under the Apache License, Version 2.0 (the "License"); you may not use this software except in compliance with the License.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.