OpenMetadata Data Contracts API

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

Operations 34

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/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 #
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 #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/openmetadata-data-contracts-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openmetadata-data-contracts-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: OpenMetadata Data Contracts API
  description: Common types and API definition for OpenMetadata
  contact:
    name: OpenMetadata
    url: https://open-metadata.org
    email: openmetadata-dev@googlegroups.com
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  version: '1.13'
servers:
- url: /api
  description: Current Host
- url: http://localhost:8585/api
  description: Endpoint URL
security:
- BearerAuth: []
tags:


# --- truncated at 32 KB (81 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/openmetadata/refs/heads/main/openapi/openmetadata-data-contracts-api-openapi.yml