Export ODCS

from metadata.sdk import configure
from metadata.sdk.entities import DataContracts

configure(
    host="https://your-company.open-metadata.org/api",
    jwt_token="your-jwt-token"
)

# Export as ODCS JSON object
odcs = DataContracts.export_odcs(contract_id).execute()
print(f"ODCS version: {odcs.apiVersion}")
print(f"Status: {odcs.status}")

# Export as YAML string
yaml_str = DataContracts.export_odcs(contract_id).as_yaml().execute()
print(yaml_str)

# Export by FQN
odcs = DataContracts.export_odcs_by_name("sample_data.ecommerce_db.shopify.sales_orders.dataContract_sales-orders-contract").execute()

import java.util.UUID;

// client is an initialized OpenMetadataClient.
var contractId = UUID.fromString("f7a1b2c3-d4e5-6789-0abc-def123456789");

// Export as an ODCS object
var odcs = client.dataContracts().exportToODCS(contractId);
System.out.println("ODCS version: " + odcs.getApiVersion());
System.out.println("Status: " + odcs.getStatus());

// Export as YAML
String yaml = client.dataContracts().exportToODCSYaml(contractId);

// Export by fully qualified name
var byName = client.dataContracts().exportToODCSByFqn(
    "sample_data.ecommerce_db.shopify.sales_orders.dataContract_sales-orders-contract");

# Export as JSON
curl "{base_url}/api/v1/dataContracts/f7a1b2c3-d4e5-6789-0abc-def123456789/odcs" \
  -H "Authorization: Bearer {access_token}"

# Export as YAML
curl "{base_url}/api/v1/dataContracts/f7a1b2c3-d4e5-6789-0abc-def123456789/odcs/yaml" \
  -H "Authorization: Bearer {access_token}" \
  -H "Accept: application/yaml"

# Export by FQN
curl "{base_url}/api/v1/dataContracts/name/sample_data.ecommerce_db.shopify.sales_orders.dataContract_sales-orders-contract/odcs" \
  -H "Authorization: Bearer {access_token}"

{
  "apiVersion": "v3.1.0",
  "kind": "DataContract",
  "name": "sales-orders-contract",
  "version": "1.0.0",
  "status": "active",
  "domain": "ecommerce",
  "description": {
    "purpose": "Data contract for the sales orders table"
  },
  "schema": [
    {
      "name": "orders",
      "logicalType": "object",
      "properties": [
        {
          "name": "order_id",
          "logicalType": "integer",
          "required": true,
          "primaryKey": true
        },
        {
          "name": "customer_id",
          "logicalType": "integer",
          "required": true
        },
        {
          "name": "order_date",
          "logicalType": "timestamp",
          "required": true
        },
        {
          "name": "total_amount",
          "logicalType": "decimal"
        }
      ]
    }
  ],
  "quality": [
    {
      "type": "custom",
      "dimension": "completeness",
      "description": "All required fields must be present"
    }
  ],
  "slaProperties": [
    {
      "property": "frequency",
      "value": "PT1H"
    },
    {
      "property": "availability",
      "value": "99.9"
    }
  ]
}

GET

dataContracts

{id}

odcs

Export ODCS

from metadata.sdk import configure
from metadata.sdk.entities import DataContracts

configure(
    host="https://your-company.open-metadata.org/api",
    jwt_token="your-jwt-token"
)

# Export as ODCS JSON object
odcs = DataContracts.export_odcs(contract_id).execute()
print(f"ODCS version: {odcs.apiVersion}")
print(f"Status: {odcs.status}")

# Export as YAML string
yaml_str = DataContracts.export_odcs(contract_id).as_yaml().execute()
print(yaml_str)

# Export by FQN
odcs = DataContracts.export_odcs_by_name("sample_data.ecommerce_db.shopify.sales_orders.dataContract_sales-orders-contract").execute()

import java.util.UUID;

// client is an initialized OpenMetadataClient.
var contractId = UUID.fromString("f7a1b2c3-d4e5-6789-0abc-def123456789");

// Export as an ODCS object
var odcs = client.dataContracts().exportToODCS(contractId);
System.out.println("ODCS version: " + odcs.getApiVersion());
System.out.println("Status: " + odcs.getStatus());

// Export as YAML
String yaml = client.dataContracts().exportToODCSYaml(contractId);

// Export by fully qualified name
var byName = client.dataContracts().exportToODCSByFqn(
    "sample_data.ecommerce_db.shopify.sales_orders.dataContract_sales-orders-contract");

# Export as JSON
curl "{base_url}/api/v1/dataContracts/f7a1b2c3-d4e5-6789-0abc-def123456789/odcs" \
  -H "Authorization: Bearer {access_token}"

# Export as YAML
curl "{base_url}/api/v1/dataContracts/f7a1b2c3-d4e5-6789-0abc-def123456789/odcs/yaml" \
  -H "Authorization: Bearer {access_token}" \
  -H "Accept: application/yaml"

# Export by FQN
curl "{base_url}/api/v1/dataContracts/name/sample_data.ecommerce_db.shopify.sales_orders.dataContract_sales-orders-contract/odcs" \
  -H "Authorization: Bearer {access_token}"

{
  "apiVersion": "v3.1.0",
  "kind": "DataContract",
  "name": "sales-orders-contract",
  "version": "1.0.0",
  "status": "active",
  "domain": "ecommerce",
  "description": {
    "purpose": "Data contract for the sales orders table"
  },
  "schema": [
    {
      "name": "orders",
      "logicalType": "object",
      "properties": [
        {
          "name": "order_id",
          "logicalType": "integer",
          "required": true,
          "primaryKey": true
        },
        {
          "name": "customer_id",
          "logicalType": "integer",
          "required": true
        },
        {
          "name": "order_date",
          "logicalType": "timestamp",
          "required": true
        },
        {
          "name": "total_amount",
          "logicalType": "decimal"
        }
      ]
    }
  ],
  "quality": [
    {
      "type": "custom",
      "dimension": "completeness",
      "description": "All required fields must be present"
    }
  ],
  "slaProperties": [
    {
      "property": "frequency",
      "value": "PT1H"
    },
    {
      "property": "availability",
      "value": "99.9"
    }
  ]
}

Import & Export

Data contracts can be imported and exported using the Open Data Contract Standard (ODCS) v3.1.0 format. Both JSON and YAML are supported, with smart merge and full replace modes for updates.

Export to ODCS

Export by ID (JSON)

GET /v1/dataContracts/{id}/odcs

Export by ID (YAML)

GET /v1/dataContracts/{id}/odcs/yaml

Export by FQN (JSON)

GET /v1/dataContracts/name/{fqn}/odcs

Export by FQN (YAML)

GET /v1/dataContracts/name/{fqn}/odcs/yaml

string

UUID of the data contract.

string

Fully qualified name of the data contract.

string

Fields to include in the export. Defaults to owners,reviewers,extension,schema,sla,security.

Export ODCS

from metadata.sdk import configure
from metadata.sdk.entities import DataContracts

configure(
    host="https://your-company.open-metadata.org/api",
    jwt_token="your-jwt-token"
)

# Export as ODCS JSON object
odcs = DataContracts.export_odcs(contract_id).execute()
print(f"ODCS version: {odcs.apiVersion}")
print(f"Status: {odcs.status}")

# Export as YAML string
yaml_str = DataContracts.export_odcs(contract_id).as_yaml().execute()
print(yaml_str)

# Export by FQN
odcs = DataContracts.export_odcs_by_name("sample_data.ecommerce_db.shopify.sales_orders.dataContract_sales-orders-contract").execute()

import java.util.UUID;

// client is an initialized OpenMetadataClient.
var contractId = UUID.fromString("f7a1b2c3-d4e5-6789-0abc-def123456789");

// Export as an ODCS object
var odcs = client.dataContracts().exportToODCS(contractId);
System.out.println("ODCS version: " + odcs.getApiVersion());
System.out.println("Status: " + odcs.getStatus());

// Export as YAML
String yaml = client.dataContracts().exportToODCSYaml(contractId);

// Export by fully qualified name
var byName = client.dataContracts().exportToODCSByFqn(
    "sample_data.ecommerce_db.shopify.sales_orders.dataContract_sales-orders-contract");

# Export as JSON
curl "{base_url}/api/v1/dataContracts/f7a1b2c3-d4e5-6789-0abc-def123456789/odcs" \
  -H "Authorization: Bearer {access_token}"

# Export as YAML
curl "{base_url}/api/v1/dataContracts/f7a1b2c3-d4e5-6789-0abc-def123456789/odcs/yaml" \
  -H "Authorization: Bearer {access_token}" \
  -H "Accept: application/yaml"

# Export by FQN
curl "{base_url}/api/v1/dataContracts/name/sample_data.ecommerce_db.shopify.sales_orders.dataContract_sales-orders-contract/odcs" \
  -H "Authorization: Bearer {access_token}"

{
  "apiVersion": "v3.1.0",
  "kind": "DataContract",
  "name": "sales-orders-contract",
  "version": "1.0.0",
  "status": "active",
  "domain": "ecommerce",
  "description": {
    "purpose": "Data contract for the sales orders table"
  },
  "schema": [
    {
      "name": "orders",
      "logicalType": "object",
      "properties": [
        {
          "name": "order_id",
          "logicalType": "integer",
          "required": true,
          "primaryKey": true
        },
        {
          "name": "customer_id",
          "logicalType": "integer",
          "required": true
        },
        {
          "name": "order_date",
          "logicalType": "timestamp",
          "required": true
        },
        {
          "name": "total_amount",
          "logicalType": "decimal"
        }
      ]
    }
  ],
  "quality": [
    {
      "type": "custom",
      "dimension": "completeness",
      "description": "All required fields must be present"
    }
  ],
  "slaProperties": [
    {
      "property": "frequency",
      "value": "PT1H"
    },
    {
      "property": "availability",
      "value": "99.9"
    }
  ]
}

Import from ODCS

Create from ODCS JSON

POST /v1/dataContracts/odcs

Create from ODCS YAML

POST /v1/dataContracts/odcs/yaml

Create or Update from ODCS JSON

PUT /v1/dataContracts/odcs

Create or Update from ODCS YAML

PUT /v1/dataContracts/odcs/yaml

string

required

UUID of the entity to attach the contract to.

string

required

Type of the entity, for example table, topic, apiEndpoint.

string

default:"merge"

Import mode for PUT endpoints: merge (preserves existing fields not in the import) or replace (fully overwrites the contract).

string

Schema object name to import for multi-object ODCS contracts. If not specified, auto-selects based on entity name.

Import ODCS

from metadata.sdk import configure
from metadata.sdk.entities import DataContracts

configure(
    host="https://your-company.open-metadata.org/api",
    jwt_token="your-jwt-token"
)

# Import from ODCS object (creates new contract)
contract = (DataContracts.import_odcs(table_id, "table")
    .from_odcs(odcs_contract)
    .execute())

# Import from YAML with smart merge
yaml_content = open("contract.yaml").read()
contract = (DataContracts.import_odcs(table_id, "table")
    .from_yaml(yaml_content)
    .merge()
    .execute())

Import ODCS

import java.nio.file.Files;
import java.nio.file.Path;
import java.util.UUID;
import org.openmetadata.schema.entity.data.DataContract;
import org.openmetadata.sdk.network.HttpMethod;
import org.openmetadata.sdk.network.RequestOptions;

// client is an initialized OpenMetadataClient.
var entityId = UUID.fromString("a1b2c3d4-e5f6-7890-abcd-ef1234567890");
String yamlContent = Files.readString(Path.of("contract.yaml"));

// Import from an ODCS object (creates a new contract).
// odcsContract is an ODCSDataContract, for example one returned by exportToODCS.
var imported = client.dataContracts().importFromODCS(odcsContract, entityId, "table");

// Import from YAML (creates a new contract)
var importedFromYaml = client.dataContracts().importFromODCSYaml(
    yamlContent, entityId, "table");

// Update an existing contract from YAML with smart merge
var merged = client.dataContracts().createOrUpdateFromODCSYaml(
    yamlContent, entityId, "table");

// Replace an existing contract from YAML
var replaced = client.dataContracts().createOrUpdateFromODCSYaml(
    yamlContent, entityId, "table", "replace");

// Import from YAML, keeping quality rules without creating test cases.
// The SDK method has no createTestCases option, so call the endpoint directly.
var options = RequestOptions.builder()
    .queryParam("entityId", entityId.toString())
    .queryParam("entityType", "table")
    .queryParam("createTestCases", "false")
    .header("Content-Type", "application/yaml")
    .build();
var withoutTestCases = client.getHttpClient().execute(
    HttpMethod.POST, "/v1/dataContracts/odcs/yaml", yamlContent, DataContract.class, options);

Import ODCS

# Import from ODCS JSON (create new)
curl -X POST "{base_url}/api/v1/dataContracts/odcs?entityId=a1b2c3d4-e5f6-7890-abcd-ef1234567890&entityType=table" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d @contract.json

# Import from ODCS YAML
curl -X POST "{base_url}/api/v1/dataContracts/odcs/yaml?entityId=a1b2c3d4-e5f6-7890-abcd-ef1234567890&entityType=table" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/yaml" \
  --data-binary @contract.yaml

# Create or update with smart merge
curl -X PUT "{base_url}/api/v1/dataContracts/odcs?entityId=a1b2c3d4-e5f6-7890-abcd-ef1234567890&entityType=table&mode=merge" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d @contract.json

# Full replace
curl -X PUT "{base_url}/api/v1/dataContracts/odcs?entityId=a1b2c3d4-e5f6-7890-abcd-ef1234567890&entityType=table&mode=replace" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d @contract.json

Parse ODCS YAML

Preview an ODCS YAML contract without importing. Useful for inspecting multi-object contracts. POST /v1/dataContracts/odcs/parse/yaml

Parse YAML

curl -X POST "{base_url}/api/v1/dataContracts/odcs/parse/yaml" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/yaml" \
  --data-binary @contract.yaml

Response

{
  "name": "sales-contract",
  "version": "1.0.0",
  "status": "active",
  "schemaObjects": ["orders", "order_items"],
  "hasMultipleObjects": true
}

Validate ODCS YAML

Validate an ODCS YAML contract against a target entity without creating it. POST /v1/dataContracts/odcs/validate/yaml

string

required

UUID of the entity to validate against.

string

required

Type of the entity.

string

Schema object name for multi-object contracts.

Validate YAML

curl -X POST "{base_url}/api/v1/dataContracts/odcs/validate/yaml?entityId=a1b2c3d4-e5f6-7890-abcd-ef1234567890&entityType=table" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/yaml" \
  --data-binary @contract.yaml

Validate YAML

import com.fasterxml.jackson.databind.ObjectMapper;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.UUID;
import org.openmetadata.sdk.network.HttpMethod;
import org.openmetadata.sdk.network.RequestOptions;

// client is an initialized OpenMetadataClient.
var entityId = UUID.fromString("a1b2c3d4-e5f6-7890-abcd-ef1234567890");
String yamlContent = Files.readString(Path.of("contract.yaml"));

var validation = client.dataContracts().validateODCSYaml(yamlContent, entityId, "table");
System.out.println("Valid: " + validation.getValid());

// The SDK model has no createTestCases option or import report,
// so call the endpoint directly to read the report.
var options = RequestOptions.builder()
    .queryParam("entityId", entityId.toString())
    .queryParam("entityType", "table")
    .queryParam("createTestCases", "true")
    .header("Content-Type", "application/yaml")
    .build();
String response = client.getHttpClient().executeForString(
    HttpMethod.POST, "/v1/dataContracts/odcs/validate/yaml", yamlContent, options);
var report = new ObjectMapper().readTree(response).path("odcsImportReport");
System.out.println("Can import: " + report.path("canImport").asBoolean());

Response

{
  "passed": 3,
  "failed": 1,
  "total": 4,
  "failedFields": ["missing_column"]
}

Supported ODCS Versions

Version	Status
v3.1.0	Full support
v3.0.2	Supported
v3.0.1	Supported
v3.0.0	Supported
v2.2.2	Supported
v2.2.1	Supported
v2.2.0	Supported

Error Handling

Code	Error Type	Description
`400`	`BAD_REQUEST`	Invalid ODCS content or YAML syntax
`401`	`UNAUTHORIZED`	Invalid or missing authentication token
`403`	`FORBIDDEN`	User lacks permission
`404`	`NOT_FOUND`	Data contract or entity not found

API Reference

Data Assets

AI SDK

SDK

Discovery

Lineage

Data Contracts

Teams And Users

Data Governance

Data Quality

Main Concepts

Import & Export

Import & Export

Export to ODCS

Export by ID (JSON)

Export by ID (YAML)

Export by FQN (JSON)

Export by FQN (YAML)

Import from ODCS

Create from ODCS JSON

Create from ODCS YAML

Create or Update from ODCS JSON

Create or Update from ODCS YAML

Parse ODCS YAML

Validate ODCS YAML

Supported ODCS Versions

Error Handling

​Import & Export

​Export to ODCS

​Export by ID (JSON)

​Export by ID (YAML)

​Export by FQN (JSON)

​Export by FQN (YAML)

​Import from ODCS

​Create from ODCS JSON

​Create from ODCS YAML

​Create or Update from ODCS JSON

​Create or Update from ODCS YAML

​Parse ODCS YAML

​Validate ODCS YAML

​Supported ODCS Versions

​Error Handling

Import & Export

Export to ODCS

Export by ID (JSON)

Export by ID (YAML)

Export by FQN (JSON)

Export by FQN (YAML)

Import from ODCS

Create from ODCS JSON

Create from ODCS YAML

Create or Update from ODCS JSON

Create or Update from ODCS YAML

Parse ODCS YAML

Validate ODCS YAML

Supported ODCS Versions

Error Handling