from metadata.sdk import configure
from metadata.sdk.entities import Tags

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

# List first page
tags = Tags.list(limit=50)
for t in tags.entities:
    print(f"{t.fullyQualifiedName.root}")

# List all with auto-pagination
for t in Tags.list_all():
    print(f"{t.fullyQualifiedName.root}")

# Filter by classification
tags = Tags.list(
    filters={"parent": "Certification"},
    fields=["owners", "children"],
    limit=50
)

for t in tags.entities:
    print(f"{t.fullyQualifiedName.root}")
    if t.style:
        print(f"  Color: {t.style.color}")

import org.openmetadata.sdk.models.ListParams;

// client is an initialized OpenMetadataClient.
// List first page
var params = new ListParams().setLimit(50);
var page = client.tags().list(params);
for (var item : page.getData()) {
    System.out.println(item.getFullyQualifiedName());
}

// Filter by classification with fields
var filtered = new ListParams()
    .addFilter("parent", "Certification")
    .setFields("owners,children")
    .setLimit(50);
var filteredPage = client.tags().list(filtered);
for (var item : filteredPage.getData()) {
    System.out.println(item.getFullyQualifiedName());
}

# List all
curl "{base_url}/api/v1/tags?limit=50" \
  -H "Authorization: Bearer {access_token}"

# Filter by classification
curl "{base_url}/api/v1/tags?parent=Certification&fields=owners,children&limit=50" \
  -H "Authorization: Bearer {access_token}"

{
  "data": [
    {
      "id": "68ec158c-5f5e-4277-8a19-5e9e0cd5294f",
      "name": "Bronze",
      "fullyQualifiedName": "Certification.Bronze",
      "description": "Bronze certified Data Asset.",
      "style": {
        "color": "#C08320"
      },
      "version": 0.1,
      "updatedAt": 1769982619666,
      "updatedBy": "admin",
      "classification": {
        "id": "06d90883-6be9-4f7e-9475-753f10a95e94",
        "type": "classification",
        "name": "Certification",
        "fullyQualifiedName": "Certification",
        "deleted": false
      },
      "deleted": false,
      "owners": [],
      "provider": "system",
      "mutuallyExclusive": false
    }
  ],
  "paging": {
    "after": "...",
    "total": 3
  }
}