OpenMetadata

OpenMetadata Data Contracts API

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

Documentation GitHub OpenAPI

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 #

Documentation

📖

Documentation

https://docs.open-metadata.org/latest/main-concepts/metadata-standard/apis

📖

Authentication

https://docs.open-metadata.org/latest/main-concepts/metadata-standard/apis

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/openmetadata/refs/heads/main/openapi/openmetadata-data-contracts-api-openapi.yml

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.

GitHub Google LinkedIn

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

OpenAPI Specification

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