Skip to content

sourcemeta/std

Repository files navigation

Sourcemeta JSON Schema Standard Library

DOI GitHub Release


Browse the schemas at https://schemas.sourcemeta.com/sourcemeta/std


Building professional OpenAPI specifications demands precision, but mastering JSON Schema is hard. This library eliminates that burden by providing production-ready schemas that encode industry standards and best practices. Reference them directly in your API specifications and focus on what matters: designing great APIs.

Led and maintained by a member of the JSON Schema Technical Steering Committee

Use this library to:

  • Build production-grade OpenAPI specifications without writing schemas from scratch
  • Skip the JSON Schema learning curve while maintaining expert-level quality
  • Meet compliance and regulatory requirements with standards-based validation
  • Establish a solid foundation for your organisation's API governance program

Warning

This project is in its early stages with much more to come. We need your feedback to shape its future. Please share your thoughts and suggestions on what you would like to see.

Note

All schemas target JSON Schema 2020-12, the dialect used by OpenAPI v3.1 and later. Earlier JSON Schema dialects will be supported in the future.

Standards Covered

Organisation Standard Title
IEEE IEEE Std 754-2019 IEEE Standard for Floating-Point Arithmetic
IEEE IEEE Std 1003.1-2017 IEEE Standard for Information Technology—Portable Operating System Interface (POSIX)
IETF RFC 3066 Tags for the Identification of Languages
IETF RFC 3986 Uniform Resource Identifier (URI): Generic Syntax
IETF RFC 4648 The Base16, Base32, and Base64 Data Encodings
IETF RFC 4918 HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)
IETF RFC 5322 Internet Message Format
IETF RFC 5646 Tags for Identifying Languages (BCP 47)
IETF RFC 5789 PATCH Method for HTTP
IETF RFC 6901 JavaScript Object Notation (JSON) Pointer
IETF RFC 7807 Problem Details for HTTP APIs
IETF RFC 7946 The GeoJSON Format
IETF RFC 8141 Uniform Resource Names (URNs)
IETF RFC 9110 HTTP Semantics
ISO ISO 3166-1:2020 Codes for the representation of names of countries and their subdivisions
ISO ISO 4217:2015 Codes for the representation of currencies and funds
ISO ISO 6709:2022 Standard representation of geographic point location by coordinates
ISO ISO 639:2023 Codes for the representation of names of languages
ISO ISO 8601-1:2019 Date and time — Representations for information interchange — Part 1: Basic rules
ISO ISO 8601-2:2019 Date and time — Representations for information interchange — Part 2: Extensions
ISO ISO 80000-1:2022 Quantities and units — Part 1: General
ISO ISO/IEC 2382:2015 Information technology — Vocabulary
ISO ISO/IEC 9899:2024 Programming languages — C
BIPM BIPM SI 2019 The International System of Units (SI) — 9th edition (2019)
JSON-RPC JSON-RPC 2.0 JSON-RPC 2.0 Specification
W3C XML Schema Part 2 XML Schema Datatypes Second Edition
XBRL XBRL 2.1 Extensible Business Reporting Language (XBRL) 2.1
XBRL XBRL DTR XBRL Data Types Registry
XBRL XBRL UTR XBRL Units Type Registry

🎓 Citing

If you use this library in your research or project, please cite it using the DOI provided above. You can find citation information in various formats (BibTeX, APA, etc.) by clicking the "Cite as" button on the Zenodo record.

📄 License

While the project is publicly available on GitHub, it operates under a source-available license rather than a traditional open-source model. You may freely use these schemas for non-commercial purposes, but commercial use requires a paid commercial license.

We are happy to discuss OEM and white-label distribution options for incorporating these schemas into commercial products.

🤝 Contributing

We welcome contributions! By sending a pull request, you agree to our contributing guidelines. Meaningful contributions to this repository can be taken into consideration towards a discounted (or even free) commercial license.

Tip

Do you want to level up your JSON Schema skills? Check out learnjsonschema.com, our growing JSON Schema documentation website, our JSON Schema for OpenAPI video course, and our O'Reilly book Unifying Business, Data, and Code: Designing Data Products with JSON Schema.

📧 Contact

If you have any questions or comments, don't hesitate in opening a ticket on GitHub Discussions or writing to us at hello@sourcemeta.com.

About

A growing collection of hand-crafted high-quality schemas by Sourcemeta. From RFC-compliant Email Address schemas to ISO-compliant Currency Codes.

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Sponsor this project

 

Contributors