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

configure(
    host="https://your-company.getcollate.io/api",
    jwt_token="your-jwt-token"
)

# Get by ID
contract = DataContracts.retrieve("f7a1b2c3-d4e5-6789-0abc-def123456789")
print(f"{contract.name.root}: {contract.entityStatus}")

# Get by FQN
contract = DataContracts.retrieve_by_name("sample_data.ecommerce_db.shopify.sales_orders.dataContract_sales-orders-contract")

# Get effective contract for an entity (includes inherited properties)
contract = DataContracts.get_by_entity(
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "table"
)

import static org.openmetadata.sdk.fluent.DataContracts.*;

// client is an initialized OpenMetadataClient.
setDefaultClient(client);

// Get by ID with owners
FluentDataContract contract = find(contractId)
    .includeOwners()
    .fetch();
System.out.println(contract.getFqn());

// Get by FQN
FluentDataContract contract = findByName("sample_data.ecommerce_db.shopify.sales_orders.dataContract_sales-orders-contract")
    .includeAll()
    .fetch();

// Get effective contract for an entity
FluentDataContract contract = findByEntity(tableId, "table")
    .fetch();

# Get by ID
curl "{base_url}/api/v1/dataContracts/f7a1b2c3-d4e5-6789-0abc-def123456789?fields=owners,reviewers" \
  -H "Authorization: Bearer {access_token}"

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

# Get effective contract for an entity (includes inherited)
curl "{base_url}/api/v1/dataContracts/entity?entityId=a1b2c3d4-e5f6-7890-abcd-ef1234567890&entityType=table" \
  -H "Authorization: Bearer {access_token}"

{
  "id": "f7a1b2c3-d4e5-6789-0abc-def123456789",
  "name": "sales-orders-contract",
  "fullyQualifiedName": "sample_data.ecommerce_db.shopify.sales_orders.dataContract_sales-orders-contract",
  "description": "Data contract for the sales orders table",
  "entityStatus": "Approved",
  "entity": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "type": "table",
    "name": "sales_orders",
    "fullyQualifiedName": "sample_data.ecommerce_db.shopify.sales_orders"
  },
  "schema": [
    {"name": "order_id", "dataType": "INT", "constraint": "PRIMARY_KEY"},
    {"name": "customer_id", "dataType": "INT", "constraint": "NOT_NULL"}
  ],
  "semantics": [
    {"name": "hasOwner"},
    {"name": "hasDescription"}
  ],
  "sla": {
    "refreshFrequency": {"interval": 1, "unit": "hour"},
    "availabilityTime": "09:00 UTC"
  },
  "owners": [],
  "reviewers": [],
  "inherited": false,
  "version": 0.2,
  "updatedAt": 1769982800000,
  "updatedBy": "admin"
}