An open API service indexing awesome lists of open source software.

https://github.com/bitol-io/open-data-contract-standard

Home of the Open Data Contract Standard (ODCS).
https://github.com/bitol-io/open-data-contract-standard

data data-contract data-contracts data-engineering data-mesh data-quality standard

Last synced: 3 months ago
JSON representation

Home of the Open Data Contract Standard (ODCS).

Awesome Lists containing this project

README

          

---
title: "Open Data Contract Standard (ODCS)"
description: "Home of Open Data Contract Standard (ODCS) documentation."
image: "https://raw.githubusercontent.com/bitol-io/artwork/main/horizontal/color/Bitol_Logo_color.svg"
---

[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/8149/badge)](https://www.bestpractices.dev/projects/8149)

Stars

Slack Status

# Open Data Contract Standard (ODCS)

Welcome!

Thanks for your interest and for taking the time to come here! ❤️

## Executive summary
This standard describes a structure for a **data contract**. Its current version is v3.1.0. It is available for you as an Apache 2.0 license. Contributions are welcome!

## Discover the open standard
A reader-friendly version of the standard can be found on its [dedicated site](https://bitol-io.github.io/open-data-contract-standard/).

Discover the [Open Data Contract Standard](docs/README.md). This file contains some explanations and several examples. More [examples](docs/examples/README.md) can be found here.

## What is a Data Contract?

### The basics of a data contract
A data contract defines the agreement between a data producer and consumers. A data contract contains several sections:

* [Fundamentals](docs/fundamentals.md).
* [Schema](docs/schema.md).
* [References](docs/references.md).
* [Data quality](docs/data-quality.md).
* [Support & communication channels](docs/support-communication-channels.md)
* [Pricing](docs/pricing.md).
* [Team](docs/team.md).
* [Roles](docs/roles.md).
* [Service-level agreement (SLA)](docs/service-level-agreement.md).
* [Infrastructures & servers](docs/infrastructure-servers.md).
* [Custom & other properties](docs/custom-other-properties.md).

![Data contract schema](docs/img/data-contract-diagram-latest.png "Data contract schema")

*Figure 1: illustration of a data contract, its principal contributors, sections, and usage.*

### JSON Schema

JSON Schema for ODCS can be found [here](https://github.com/bitol-io/open-data-contract-standard/blob/main/schema/odcs-json-schema-latest.json). You can import this schema into your IDE for validation of your YAML files. Links below show how you can import the schema:

- [IntelliJ](https://www.jetbrains.com/help/idea/json.html#ws_json_schema_add_custom)
- [VS Code](https://code.visualstudio.com/docs/languages/json#_json-schemas-and-settings)

## Articles and Other Resources
Check out the [resources](./resources.md) page.

## Contributing to the project
Check out the [CONTRIBUTING](./CONTRIBUTING.md) page.

## More

### Citation

If you need to cite this standard, you can use the following BibTeX entry:

```bibtex
@manual{ODCS2025,
title = {Open Data Contract Standard (ODCS)},
author = {{Bitol}},
organization = {LF AI \& Data Foundation},
year = {2025},
url = {https://bitol-io.github.io/open-data-contract-standard}
}
```

### Mime/Media Type

The official media (fka mime) type is:

```
application/odcs+yaml;version=3.1.0
```