# Collate Data Contracts API

**Canonical:** https://apis.io/apis/collate/collate-data-contracts-api/  
**Provider:** Collate — https://apis.io/providers/collate/  
**Base URL:** https://sandbox.open-metadata.org/api/v1  
**Documentation:** https://docs.open-metadata.org/latest/api-reference

Collate Data Contracts API is one of 107 APIs that [Collate](https://apis.io/providers/collate/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Data Contracts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

`DataContract` defines the schema and quality guarantees for a data asset.

## Operations (37)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/dataContracts` | List data contracts |
| PUT | `/v1/dataContracts` | Create or update a data contract from YAML |
| POST | `/v1/dataContracts` | Create a data contract from YAML |
| PUT | `/v1/dataContracts/odcs` | Create or update data contract from ODCS format |
| POST | `/v1/dataContracts/odcs` | Import data contract from ODCS format |
| PUT | `/v1/dataContracts/odcs/yaml` | Create or update data contract from ODCS YAML format |
| POST | `/v1/dataContracts/odcs/yaml` | Import data contract from ODCS YAML format |
| GET | `/v1/dataContracts/{id}/results` | List data contract results |
| PUT | `/v1/dataContracts/{id}/results` | Create or update data contract result |
| GET | `/v1/dataContracts/{id}` | Get a data contract by id |
| DELETE | `/v1/dataContracts/{id}` | Delete a data contract by id |
| PATCH | `/v1/dataContracts/{id}` | Update a data contract |
| DELETE | `/v1/dataContracts/async/{id}` | Delete a data contract by id asynchronously |
| GET | `/v1/dataContracts/name/{fqn}` | Get a data contract by fully qualified name |
| DELETE | `/v1/dataContracts/name/{fqn}` | Delete a data contract by fully qualified name |
| DELETE | `/v1/dataContracts/{id}/results/{timestamp}` | Delete data contract result |
| DELETE | `/v1/dataContracts/{id}/results/before/{timestamp}` | Delete data contract results before timestamp |
| GET | `/v1/dataContracts/{id}/odcs` | Export data contract to ODCS format |
| GET | `/v1/dataContracts/name/{fqn}/odcs` | Export data contract to ODCS format by FQN |
| GET | `/v1/dataContracts/{id}/odcs/yaml` | Export data contract to ODCS YAML format |
| GET | `/v1/dataContracts/name/{fqn}/odcs/yaml` | Export data contract to ODCS YAML format by FQN |
| GET | `/v1/dataContracts/{id}/context` | Get the AI context for an entity by id |
| GET | `/v1/dataContracts/name/{fqn}/context` | Get the AI context for an entity by fully qualified name |
| GET | `/v1/dataContracts/entity` | Get the effective data contract for an entity |
| GET | `/v1/dataContracts/{id}/results/latest` | Get latest data contract result |
| GET | `/v1/dataContracts/{id}/results/{resultId}` | Get a data contract result by ID |
| GET | `/v1/dataContracts/{id}/versions/{version}` | Get a version of a data contract |
| GET | `/v1/dataContracts/history` | List all entity versions within a time range |
| GET | `/v1/dataContracts/{id}/versions` | List all versions of a data contract |
| POST | `/v1/dataContracts/odcs/parse/yaml` | Parse ODCS YAML and return metadata |
| PUT | `/v1/dataContracts/restore` | Restore a soft deleted data contract |
| GET | `/v1/dataContracts/search` | Search data contracts |
| POST | `/v1/dataContracts/{id}/validate` | Validate a data contract |
| POST | `/v1/dataContracts/entity/validate` | Validate a data contract for an entity |
| POST | `/v1/dataContracts/validate` | Validate data contract request without creating |
| POST | `/v1/dataContracts/validate/yaml` | Validate data contract request from YAML without creating |
| POST | `/v1/dataContracts/odcs/validate/yaml` | Validate ODCS YAML without importing |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/collate/refs/heads/main/openapi/collate-data-contracts-api-openapi.yml
- **Documentation** — https://docs.open-metadata.org/latest/api-reference
- **APIReference** — https://docs.open-metadata.org/latest/api-reference

## Other Collate APIs (12)

- [Collate Activity Stream API](https://apis.io/apis/collate/collate-activity-stream-api/)
- [Collate Agent Executions API](https://apis.io/apis/collate/collate-agent-executions-api/)
- [Collate AI Applications API](https://apis.io/apis/collate/collate-ai-applications-api/)
- [Collate AI Audit Reports API](https://apis.io/apis/collate/collate-ai-audit-reports-api/)
- [Collate AI Context API](https://apis.io/apis/collate/collate-ai-context-api/)
- [Collate AI Framework Controls API](https://apis.io/apis/collate/collate-ai-framework-controls-api/)
- [Collate AI Governance API](https://apis.io/apis/collate/collate-ai-governance-api/)
- [Collate AI Governance Frameworks API](https://apis.io/apis/collate/collate-ai-governance-frameworks-api/)
- [Collate AI Governance Policies API](https://apis.io/apis/collate/collate-ai-governance-policies-api/)
- [Collate Announcements API](https://apis.io/apis/collate/collate-announcements-api/)
- [Collate API Collections API](https://apis.io/apis/collate/collate-api-collections-api/)
- [Collate API Endpoint API](https://apis.io/apis/collate/collate-api-endpoint-api/)

## Tags

Data Contracts

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/collate/collate-data-contracts-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/collate/.